alex
33180d6e04
AGENTS.md is now the canonical instruction file, with CLAUDE.md, .cursorrules, and .github/copilot-instructions.md as symlinks to it. This is simpler and more intuitive - the main file is at the root, not buried in .github/. Updated all references across agents, commands, skills, and .memory/.
79 lines
2.5 KiB
Markdown
79 lines
2.5 KiB
Markdown
# Bootstrap Project Memory Files
|
|
|
|
RUN { git ls-files; git ls-files --others --exclude-standard; } 2>/dev/null | sort -u
|
|
READ README.md
|
|
|
|
You are bootstrapping `.memory/` files for this project.
|
|
|
|
Your job is to inspect the codebase and create an initial memory baseline in plain
|
|
markdown files. Capture architecture, core modules, conventions, and key decisions
|
|
so future sessions can resume quickly.
|
|
|
|
## Step 1: Create `.memory/` structure
|
|
|
|
Create (if missing):
|
|
|
|
```
|
|
.memory/
|
|
knowledge.md
|
|
decisions.md
|
|
plans/
|
|
research/
|
|
```
|
|
|
|
`.memory/` is tracked in git.
|
|
|
|
## Step 2: Inspect project structure
|
|
|
|
Run `git ls-files` to understand the project layout, then read `README.md` and
|
|
the highest-signal files for architecture and conventions.
|
|
|
|
Also check for existing cross-tool instruction files (`AGENTS.md`, `CLAUDE.md`,
|
|
`.cursorrules`, `.github/copilot-instructions.md`) — they may contain project
|
|
knowledge from other tools or team members that should be incorporated.
|
|
|
|
Identify:
|
|
- What the project does (primary capabilities)
|
|
- Core modules/subsystems and responsibilities
|
|
- Key patterns/conventions (naming, layering, testing, config)
|
|
|
|
## Step 3: Write initial `knowledge.md`
|
|
|
|
Populate `.memory/knowledge.md` with:
|
|
- Project purpose and scope
|
|
- Architecture overview
|
|
- Key modules with file paths
|
|
- Important implementation patterns/conventions
|
|
|
|
Use markdown sections with max 2 heading levels.
|
|
|
|
## Step 4: Seed `decisions.md`
|
|
|
|
Populate `.memory/decisions.md` with any clear, durable decisions found in docs
|
|
or code patterns (for example: stack choices, testing strategy, architectural
|
|
constraints). Include rationale when known.
|
|
|
|
## Step 5: Initialize plans/research folders
|
|
|
|
- If active in-progress work is discoverable, create `.memory/plans/<feature>.md`
|
|
with scope, tasks, and acceptance criteria.
|
|
- If research artifacts are discovered, create `.memory/research/<topic>.md`
|
|
with findings and references.
|
|
|
|
## Step 6: Update instruction file
|
|
|
|
If `AGENTS.md` exists, update it with any new project knowledge discovered
|
|
during bootstrap (architecture, conventions, commands). The symlinks
|
|
(`CLAUDE.md`, `.cursorrules`, `.github/copilot-instructions.md`) will
|
|
automatically reflect changes.
|
|
|
|
If the instruction file doesn't exist, note that `/init` should be run to create it.
|
|
|
|
## Guidelines
|
|
|
|
- Be specific with file paths, APIs, parameters, and behavioral details.
|
|
- Keep sections concise and scannable.
|
|
- Prefer durable knowledge over transient status notes.
|
|
- Add markdown cross-references between related entries (for example,
|
|
knowledge entries linking to decisions).
|