haowjy Qi Maintenance
Treat the nearest AGENTS.md and current-truth .context/ documents like
comments attached to the source.
As you make a coherent source change, keep those documents accurate in the same branch. If a cold agent could still work correctly from them, leave them alone. If they would mislead the next agent, update them before finishing.
Do not narrate the diff, duplicate facts visible in source, or rewrite intent to bless an implementation that diverged from the settled plan. Record the divergence instead.
Load /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 /knowledge-layers when placement is unclear.
Cross-cutting KB synthesis belongs to @kb-lead after the phase settles.