tomevault-io Design Tracker Skill
Purpose
This skill manages the project's design documentation (.claude/docs/DESIGN.md). It automatically tracks:
- Architecture decisions
- Implementation plans
- Library choices and their rationale
- TODO items and open questions
When to Activate
- User discusses architecture or design patterns
- User makes implementation decisions (e.g., "let's use ReAct pattern")
- User says "record this", "add to design", "document this"
- User asks "what's our current design?" or "what have we decided?"
- Important technical decisions are made during conversation
Workflow
Recording Decisions
- Read existing
.claude/docs/DESIGN.md - Extract the decision/information from conversation
- Update the appropriate section
- Add entry to Changelog with today's date
Sections to Update
| Conversation Topic | Target Section |
|---|---|
| Overall goals, purpose | Overview |
| System structure, components | Architecture |
| Patterns (ReAct, etc.) | Implementation Plan > Patterns |
| Library choices | Implementation Plan > Libraries |
| Why we chose X over Y | Implementation Plan > Key Decisions |
| Things to implement later | TODO |
| Unresolved questions | Open Questions |
Output Format
When recording, confirm in Japanese:
- What was recorded
- Which section was updated
- Brief summary of the change
Language Rules
- Thinking/Reasoning: English
- Code examples: English
- Document content: English (technical terms) + Japanese (descriptions OK)
- User communication: Japanese
Converted and distributed by TomeVault — claim your Tome and manage your conversions.