documenting-project-contextlisted
Install: claude install-skill ventz/ai-skills-agents-context
# Documenting Project Context
Maintains CLAUDE.MD as persistent memory across Claude sessions by capturing important project information, architectural decisions, and learnings.
**Core principle**: Concise, scannable, focused on what you need to remember while coding—not comprehensive documentation.
## When to Use This Skill
Trigger this skill when:
- Completing significant work (features, bug fixes, refactoring)
- Discovering architectural decisions or patterns
- Identifying project conventions or coding standards
- Finding gotchas, pitfalls, or non-obvious behaviors
- Learning about dependencies, configurations, or setup requirements
- User explicitly requests: "update CLAUDE.MD", "document this", "add to project notes"
**Proactive mode**: Offer to update CLAUDE.MD when you notice important context that should persist.
## What Qualifies as "Important Information"
**DO document**:
- **Critical constraints**: Architecture rules that MUST be followed (e.g., "modules MUST be single files")
- **Gotchas**: Non-obvious behaviors, common pitfalls, "shell vs .env precedence"
- **Architectural decisions with rationale**: Why X was chosen over Y
- **Key patterns**: Important cross-file relationships and data flows
- **Setup essentials**: Critical env vars, AWS config, deployment specifics
- **Common pitfalls**: Top 10 things that trip people up
**DON'T document**:
- Implementation details visible in a single file (use code comments)
- Verbose explanations of how things work (a