Documentation Codex Maintenance
Guidance for keeping documentation, codexes, and architecture references in sync with code changes in WorkMood. Covers update triggers, best practices, checklists, and anti-patterns for sustainable documentation.
jason-kerney0 starsFeb 17, 2026 - Occupation
- Categories
- Technical Docs
Documentation & Codex Maintenance Skill
When to Use This Skill
- After making code, architecture, or workflow changes
- When adding new features, services, or abstractions
- Before committing or merging changes
- During code review to verify documentation accuracy
Core Concepts
- Codexes: Living documentation files (e.g.,
.github/ai-codex-architecture.md) that describe architecture, patterns, and project rules
- Update Triggers: Any change to code structure, services, patterns, or workflows
- Single-Commit Rule: Code and documentation updates must be in the same commit
- Accuracy First: Outdated docs are worse than no docs—always update or flag for review
How-To: Maintain Documentation & Codexes