refactor(aidd-context): rework project-memory skill with capability model#279
Merged
Conversation
…memory Replace the project-type/frontend-backend memory model with a capability model: definitions plus open concrete evidence, never domain inference, every fire surfaced for user confirmation. - references/capability-signals.md: 14 capability folders, definition + evidence (auth fires on a custom oauth/credential module, package only on an importable entry distinct from the CLI bin target). - actions: agnostic Input/Output/Process/Test; action 04 test no longer contradicts its own flag step. - assets: thin scaffold docs (README/GUIDELINES/CONTRIBUTING) that point to canonical framework docs instead of duplicating them; drop dead golden-principles/stack/workflows templates. - memory templates regrouped into one folder per capability, each filled with macro-only content and a macro Mermaid diagram. - hooks/update_memory.js: also refresh a generated file index in memory/README.md, exclude README from the always-loaded block. - assets/AGENTS.md: tighten behaviour guidelines, add a communication section (answer-first, evidence over assertion, shortest decisive line, clarity carve-out for risky steps), strip noise frontmatter. Validated end to end via headless claude -p on a real CLI project (clean init, reconcile, removed-capability) and a web-fullstack sandbox. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The skill bootstraps and refreshes the project memory bank; init is one case, not the whole. Name it after what it owns. Changelogs keep the old slug as shipped history. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
ceeb3dc to
d4a901c
Compare
This was referenced Jun 16, 2026
…-project-init # Conflicts: # README.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🎯 What & why
Rework
aidd-context:02-project-memory(renamed from02-project-init). The old memory model was project-type / frontend-backend biased and the "init" name undersold a skill that also refreshes and reconciles. Now a capability model that fits any project shape and stays correct on re-runs.🛠️ How it works
authfires on a custom oauth / credential / token module, not just named libraries;packagefires only on an importable entry that is distinct from the CLI bin target (so a CLI no longer false-firespackage).Input/Output/Process/Test); action 04's test no longer contradicts its own flag step.golden-principles/stack/workflowstemplates are gone.memory/README.mdand excludes that README from the always-loaded block.🧪 How to verify
node scripts/summarize-markdown.js plugins/aidd-context/ /tmp/cat.mdthen diff against the committedCATALOG.md.aidd-contextenabled, ask in natural language to "bootstrap the project memory bank". It should detect capabilities from concrete signals, fill macro-only memory files, and sync the<aidd_project_memory>block +memory/README.mdindex.claude -pon the realcliproject (clean init, reconcile, removed-capability) and a web-fullstack sandbox: detection was deterministic across clean and reconcile paths,authfired definitionally,packagewas excluded onmain===bin, and reconcile flagged a dropped capability without deleting its file.CHANGELOG.mdandaidd-context/CHANGELOG.mdintentionally keep theproject-initslug as shipped history; the rename lands as a new changelog entry on the next release.aidd-refine:03-condense); the AGENTS.md default is professional-concise, not caveman.✅ I certify