02-project-memory — Claude Code skill: what it does, how to install
02-project-memory reads codebase architecture and decisions to build project memory and hook it into AI assistants. Useful for initial setups and drift audits.
MIT ★ 571 updated 2026-10-29
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-context@aidd-frameworkWhat 02-project-memory does
The skill extracts repository conventions and tech decisions into a shared context bank. It accepts setup, refresh, or rewire arguments. When invoked without arguments or with setup, the assistant scans project files, writes the memory bank, and synchronizes it with your tools.
The refresh mode audits drift between recorded notes and updated code without silent overwrites. Any existing bank changes only after line-by-line user approval. If an inspected file cannot be read, execution halts immediately instead of inventing contents.
This skill is built for full setup and sync cycles, not for isolated edits to a single note. Every run concludes with a brief summary of modified files.
What it helps with
- build structured project memory from repository conventions and code
- inspect architectural drift between existing memory and updated code
- wire recorded project context into supported AI coding tools
Example prompts for the agent
- Scan the codebase and initialize context:
/02-project-memory setup - Check for drift against the current codebase:
/02-project-memory refresh - Connect the existing memory to active tools:
/02-project-memory rewire
How to install 02-project-memory
1Plugin marketplace
/plugin marketplace add ai-driven-dev/framework/plugin install aidd-context@aidd-frameworkThis installs the whole aidd-context plugin with all its skills
2Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 02-project-memory -a claude-code3Manually: put the files in place
~/.claude/skills/02-project-memory/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/02-project-memory/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 02-project-memory -a codex2Manually: put the files in place
.agents/skills/02-project-memory/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 02-project-memory -a cursor2Manually: put the files in place
.cursor/skills/02-project-memory/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ai-driven-dev/framework plugins/aidd-context/skills/02-project-memory2Manually: put the files in place
.github/skills/02-project-memory/SKILL.md1Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 02-project-memory -a gemini-cli2Platform CLI
gemini skills install https://github.com/ai-driven-dev/framework --path plugins/aidd-context/skills/02-project-memoryManually: put the files in place
.devin/skills/02-project-memory/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 02-project-memory -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about 02-project-memory
How to install 02-project-memory in Claude Code?
Run /plugin marketplace add ai-driven-dev/framework in Claude Code, then execute /plugin install aidd-context@aidd-framework.
What does 02-project-memory do?
It scans codebase structure, documents architecture decisions into memory, and connects that context to your coding tools.
How does the refresh argument work?
It runs a drift check that displays differences between codebase reality and stored memory, updating files only after line-by-line user confirmation.
Source text
SKILL.md · MIT
--- name: 02-project-memory description: Build the project's memory of its architecture, conventions, and decisions, and wire it into your AI tools. Use when the user wants to set up or refresh project memory, or rewire it into a tool. Not for editing one existing memory file. argument-hint: setup | refresh | rewire --- # Project Memory ```mermaid flowchart LR new([no argument, or setup]) --> scan --> write --> sync --> wired([memory wired]) update([refresh]) --> scan --> check --> write rewire([rewire]) --> sync scan -.-> empty([nothing to remember]) ``` ## Actions Run the flow above, reading only the next action file. | Action | Does | | ------ | ------------------------------- | | scan | read the project | | write | write the memory | | check | show what drifted, change nothing | | sync | pick the tools, wire it in | ## Transversal rules - If a referenced file cannot be read, stop and say so. Never invent its content. - Ask before anything ambiguous. Never default silently. - A bank that already exists changes only through what the user approved, file by file and line by line. - End with a short report of what changed.
© AI-Driven Dev · MIT · ai-driven-dev/framework