What problem does it solve? Agent context files like AGENTS.md and CLAUDE.md tend to bloat, drift out of sync with the code, and duplicate facts across directories, which wastes context tokens and misleads coding agents. This Skill builds and maintains a hierarchy of small, dense intent nodes at semantic boundaries so agents inherit only the architectural context they need. ## Core Features & Use Cases - Build workflow: Captures intent nodes leaf-first at semantic boundaries, interviews the user for hidden invariants, then summarizes bottom-up into parent nodes with deduplication at the least common ancestor. - Sync workflow: Reconciles existing nodes against a git diff, proposing additions, modifications, and removals with per-change reasons instead of append-only updates. - Hard word budgets: Enforces per-node word ceilings (300–750 words depending on node kind) with a dedicated cut-to-budget phase, a delete-on-sight list, and a six-section intent node schema. - Use Case: After a large refactor, run the sync workflow to re-audit every affected AGENTS.md node, verify symbols and paths with grep, and prune stale rules before merging. ## Quick Start Ask the agent to run the write-agents-md build workflow on your repository to generate a hierarchy of AGENTS.md intent nodes, or run the sync workflow to reconcile existing nodes with recent code changes.
