Background
Agents frequently forget to apply the Knowledge Base Enhancement Strategy before committing code, treating it as an afterthought. Furthermore, the existing strategy in AGENTS_STARTUP.md did not account for the semantic chunking behavior of the ChromaDB knowledge base.
Implementation
AGENTS_STARTUP.md: Updated Section 3.2 to formally define the "Anchor & Echo" documentation strategy, explaining how to write JSDoc that survives semantic chunking by avoiding "Implied Context". We merged this new concept with the existing "semantic signpost" strategy to create a comprehensive guide.AGENTS.md: Modified the "Pre-Flight Check for Commits" protocol. Agents are now mandated to explicitly verify they have applied the Anchor & Echo strategy to their modified code before they are allowed to execute git commit.
This ensures that maintaining the quality of the AI Knowledge Base is a structural requirement within the Definition of Done for every task.
Background
Agents frequently forget to apply the Knowledge Base Enhancement Strategy before committing code, treating it as an afterthought. Furthermore, the existing strategy in
AGENTS_STARTUP.mddid not account for the semantic chunking behavior of the ChromaDB knowledge base.Implementation
AGENTS_STARTUP.md: Updated Section 3.2 to formally define the "Anchor & Echo" documentation strategy, explaining how to write JSDoc that survives semantic chunking by avoiding "Implied Context". We merged this new concept with the existing "semantic signpost" strategy to create a comprehensive guide.AGENTS.md: Modified the "Pre-Flight Check for Commits" protocol. Agents are now mandated to explicitly verify they have applied the Anchor & Echo strategy to their modified code before they are allowed to executegit commit.This ensures that maintaining the quality of the AI Knowledge Base is a structural requirement within the Definition of Done for every task.