documentation-management
Keep project documentation accurate when behavior changes. EXCLUSIVE to project-manager agent.
When & Why to Use This Skill
The Documentation Management skill is designed to eliminate documentation rot by ensuring all project records stay synchronized with real-time code changes. It acts as an automated guardian for your 'Source of Truth,' managing everything from high-level project overviews to technical architecture docs, ensuring they remain concise, accurate, and actionable for the entire development team.
Use Cases
- Feature Synchronization: Automatically updating project-overview-pdr.md and codebase-summary.md whenever a new feature or controller is added to the repository.
- README Optimization: Enforcing strict length constraints (under 300 lines) on the root README to ensure it remains a high-level, readable entry point for developers.
- Architectural Alignment: Updating system-architecture.md and code-standards.md immediately following design pattern shifts or infrastructure changes to maintain team compliance.
- Integrity Validation: Performing automated cross-checks on internal links, file paths, and code examples after file restructuring to prevent broken documentation.
| name | documentation-management |
|---|---|
| description | Keep project documentation accurate when behavior changes. EXCLUSIVE to project-manager agent. |
| allowed-tools | Read, Edit, Write, Grep |
Documentation Management
Exclusive to: project-manager agent
Instructions
- Identify what changed affecting docs
- Update appropriate file(s) based on change type
- Keep content concise and actionable
- Verify README under 300 lines
- Cross-check links and file paths
Documentation Structure (Source of Truth)
docs/
├── project-overview-pdr.md # Goals, features, requirements
├── codebase-summary.md # Structure, models, routes, components
├── code-standards.md # Conventions and patterns
└── system-architecture.md # Design and data flow
Also: README.md (root) — Keep under 300 lines
Update Triggers
| Change Type | Update |
|---|---|
| New feature | project-overview-pdr.md, codebase-summary.md |
| New model/controller | codebase-summary.md |
| Pattern change | code-standards.md |
| Architecture change | system-architecture.md |
| Setup change | README.md |
Update Process
- Identify what changed affecting docs
- Update appropriate file(s)
- Keep content concise and actionable
- Verify README under 300 lines
Cross-Reference Validation
After updates, verify:
- Links still work
- File paths accurate
- Code examples current
- No contradictions between docs
README Constraints
| Section | Max Lines |
|---|---|
| Quick Start | 30 |
| Documentation links | 20 |
| Tech Stack | 15 |
| Commands | 20 |
| Total | < 300 |
Examples
- "Update docs after adding a new model"
- "Document a new design pattern"