Write System Docs
When to Use
- Adding flow documentation to investor-prospecting-docs
- Transcribing Gemini-extracted Whimsical content
- Documenting system designs from verbal descriptions
- Creating router READMEs for new systems
Invocation
| Command | Action |
|---|---|
/write-system-docs |
Interactive mode |
/write-system-docs flow |
Create flow document |
/write-system-docs router |
Create router README |
/write-system-docs reference |
Create reference document |
/write-system-docs reference sheet |
Extract Google Sheet |
/write-system-docs reference doc |
Extract Google Doc |
/write-system-docs reference pdf |
Create PDF entry |
Standards
Always read first: docs/system-design/CLAUDE.md
Workflow
- Read documentation standards
- Determine document type
- Gather input content
- Create document using template
- Run quality checklist
- Update router READMEs
- Log to Linear (DIS-266)
Use TodoWrite to track all steps.
References
| Topic | Link |
|---|---|
| Flow template | references/templates/flow-document.md |
| Router template | references/templates/router-document.md |
| Reference template | references/templates/reference-document.md |
| Extraction workflow | references/workflows/extraction-workflow.md |
| Quality checklist | references/workflows/quality-checklist.md |
| Conventions | references/conventions.md |