Records
Records document decisions, feature designs, and rejected ideas - capturing the “why” behind this project.
They start as planning docs and become permanent documentation that survives any context clear.
Records are maintained in the source repository. Links below open on GitHub.
| # | Title | Status |
|---|---|---|
| 000 | Core Workflow | Done |
| 001 | Modular Architecture | Done |
| 002 | Custom Modules Directory | Done |
| 003 | Solo vs Team Mode | Done |
| 004 | Document & Clear Workflow | Done |
| 005 | E2E Tests | Done |
| 006 | Shell Architecture | Done |
| 007 | Coding Standards as Skills | Done |
| 008 | Content Versioning | Done |
| 009 | ccstatusline Integration | Done |
| 010 | Skill Auto-Loading | Done |
| 011 | Upgrade Command | Done |
| 012 | Optional Hooks | Rejected |
| 013 | Skill Creator | Done |
| 014 | Linux Support | Done |
| 015 | Install Script Refactoring | Done |
| 016 | Preserve User Instructions | Done |
| 017 | Rename /clear-session to /wrapup | Done |
| 018 | /todo Command | Done |
| 019 | Upgrade Permissions | Rejected |
| 020 | Custom Modules Versioning | Done |
| 021 | YouTube Transcript Skill | Done |
| 022 | Docker Matrix Tests | Planned |
| 023 | Context Quality Improvements | Done |
| 024 | Documentation Site | Done |
| 025 | Private Notes | Done |
| 026 | External Plugins | Done |
Key Decisions
Workflow
- No /compact - Auto-compact is unpredictable. Use /wrapup + /clear instead.
- Two CLAUDE.md files - Global for workflow, project for status.
- Records for decisions - Permanent docs survive any context clear.
Architecture
- Monorepo for docs - Code and docs in sync, one PR for both.
- Skills over prompts - Auto-loading based on tech stack, not manual inclusion.
- Custom overrides built-in - Team standards take precedence.
Implementation
- Single install script - No npm/pip install required, just curl and run.
- ShellCheck compliant - All scripts pass linting.
- Interactive by default - Users choose what to install.