36 lines
1.2 KiB
Plaintext
36 lines
1.2 KiB
Plaintext
|
---
|
|||
|
|
description: When and how to update AGENTS.md, rules, and skills after new conventions
|
|||
|
|
alwaysApply: true
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Maintaining agent docs
|
|||
|
|
|
|||
|
|
Rules and skills **load automatically** but **do not self-update**. Update them when the user establishes a durable convention.
|
|||
|
|
|
|||
|
|
## Update when the user says (or clearly means)
|
|||
|
|
|
|||
|
|
- "Remember this" / "Save as convention" / "Add to project rules"
|
|||
|
|
- "Document this for future agents"
|
|||
|
|
- "We always do X in this project" (and it is not already in rules/skills)
|
|||
|
|
|
|||
|
|
## Where to put new knowledge
|
|||
|
|
|
|||
|
|
| Kind of knowledge | Update |
|
|||
|
|
|-------------------|--------|
|
|||
|
|
| Always true, 1–5 bullets | `.cursor/rules/*.mdc` (pick existing file or create new, <50 lines) |
|
|||
|
|
| Multi-step workflow | `.cursor/skills/{name}/SKILL.md` |
|
|||
|
|
| Project map / onboarding | `AGENTS.md` (index only — link to rules/skills) |
|
|||
|
|
|
|||
|
|
## Do not auto-update when
|
|||
|
|
|
|||
|
|
- One-off task instructions ("fix this bug today")
|
|||
|
|
- Experimental code not yet agreed as standard
|
|||
|
|
- User did not ask to persist the pattern
|
|||
|
|
|
|||
|
|
## After updating
|
|||
|
|
|
|||
|
|
- Keep rules concise; split if a file grows past ~50 lines.
|
|||
|
|
- Tell the user which file(s) changed in one sentence.
|
|||
|
|
|
|||
|
|
Use skill `.cursor/skills/capture-convention/` for the full workflow.
|