dotfiles

Inventory the source surface for hydrating working memory in this repo. Surveys manifests, code structure, README, ADRs (if any), recent git history, and code patterns. Run once when populating working memory beyond the scaffold prompt's pre-population.

Map findings into the six working memory files: projectOverview, decisionLog, dataContracts, conventions, openQuestions. Drafts include source provenance inline. activeContext.md is excluded; the developer drives that file directly.

Pull findings from a single source location. Each finding is one sentence about a fact, decision, convention, or contract, plus a pointer back to source. Deterministic for structured sources, AI semantic for prose.

Stage reconciled drafts as a single commit (or PR for multi-developer projects) that updates the working memory files in a reviewable batch. activeContext.md is excluded. After acceptance, the synchronizer agent takes over for ongoing maintenance.

Compare drafts against existing working memory and against the codebase. Annotates each draft as net-new, would-overwrite, or conflicts-with-code. Greenfield projects skip the existing-working-memory comparison.

Reads the current working memory state, diffs it against recent git changes, and proposes updates. Use when finishing a feature, resolving a decision, or when active context feels stale.