Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-context@aidd-framework
Open on GitHub

What 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-framework

This 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-code

3Manually: put the files in place

~/.claude/skills/02-project-memory/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/02-project-memory/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set80

The whole set →
10-task 10-task — a skill that takes one bounded backlog task through framing, review and a final save. Reach for it when a piece of delivery work needs writing down, linking, ordering or closing. CX Codex +1 ★ 571repo stars 05-review 05-review inspects git diffs or implementation plans to confirm changes are ready to ship, pairing every issue with a fix. CX Codex +1 ★ 571repo stars 01-brainstorm The 01-brainstorm skill clarifies a rough idea through questions, then turns the discussion into a short brief. Use it when a request is ambiguous or you want to explore an idea together. CX Codex +1 ★ 571repo stars 3-cli-process 3-cli-process sets the conventions for a CLI process: how it shuts down, which channel gets which output, and what exit code it returns. CX Codex +1 ★ 571repo stars 07-epic 07-epic is a Claude Code skill that shapes and reviews product backlog Epics. It checks readiness, resumes saved work, and supports approval before saving. CX Codex +1 ★ 571repo stars 09-defect 09-defect turns an observed product mismatch into a backlog defect: capture, assessment, then a confirmed write. CX Codex +1 ★ 571repo stars 06-agent-generate 06-agent-generate generates agent and subagent scaffolds across the AI coding tools configured in your project from a role prompt. CX Codex +1 ★ 571repo stars 02-challenge 02-challenge is a Claude Code skill that checks completed work against an agreed plan and returns a structured report. Its findings help decide whether to ship, revise, or rework the result. CX Codex +1 ★ 571repo stars

Project sponsors

Companies that keep this analytics open