Qi Maintenance

Treat the nearest AGENTS.md and current-truth .context/ documents like comments attached to what they cover: read them before changing it.

As you make a coherent change, keep those documents accurate in the same change. The gap test: guidance, or missing guidance, that would cause a cold agent to make a wrong decision there is a gap; a changed path or a missing .context/ file is not a gap by itself. Close the gaps before finishing and leave the rest alone.

Write what a cold agent needs and can't read from the files themselves. When the implementation diverged from the settled plan, record the divergence and leave the intent as settled.

Load /creative-writing-skills:qi-layer when creating, moving, restructuring, or substantially rewriting colocated knowledge.

Track deferred work separately: directory-local must-do work goes in the nearest .context/TODO, directory-local nice-to-have work in .context/FUTURE, and cross-cutting or externally visible work in the project issue tracker. Load /creative-writing-skills:knowledge-layers when placement is unclear. Cross-cutting KB synthesis belongs to @kb-lead, after the change settles.