SpillwaveSolutions/document-specialist-skill / skills/documentation-specialist
documentation-specialist
VerifiedThis skill should be used when creating professional software documentation (SRS, PRD, OpenAPI, SDD, architecture docs, user manuals, tutorials, runbooks) from templates (greenfield) or reverse-engineering documentation from existing code like Spring Boot or FastAPI (brownfield). Also handles documentation audits/reviews, format conversion (Markdown, DOCX, PDF), and diagram generation (Mermaid first: C4, sequence, class, ER, state, flowchart; PlantUML Salt for UI wireframes and leftover UML). Use when asked to "create documentation", "document my code", "write SRS", "generate PRD", "write DESIGN_DOC.md", "architecture document", "wireframe", or "documentation specialist".
references/reference/03-design-requirements-matrix.md
View on GitHub# Design: Requirements Matrix
---
TOKEN_BUDGET: 150
TIER: 3
LOAD_TRIGGER: On-demand when mapping requirements to design components
DEPENDENCIES: 02-requirements-traceability.md, 03-design-arc42.md
---
## 3.3 Requirements Matrix
Link every requirement to its implementation component.
### Design Requirements Matrix
| Requirement | Design Component | Rationale |
|-------------|------------------|-----------|
| FR-001: User login | UserController + AuthService | Implements OAuth2 flow |
| FR-042: Search < 500ms | SearchService with Redis cache | Caching ensures performance target |
| NFR-SEC-001: Encrypt data at rest | DatabaseConfig with TDE | Meets security requirements |
| NFR-SCALE-001: Handle 10K concurrent users | Kubernetes autoscaling | Auto-scales based on load |
### Purpose
**Verification**: Ensures every requirement has an implementation
**Communication**: Bridges requirements and design teams
**Impact Analysis**: Identifies affected components when requirements change
### How to Create
1. Extract all requirements from SRS/PRD
2. Identify the component that implements each requirement
3. Add rationale explaining the design choice
4. Review with both requirements and design teams
5. Update as requirements or design evolves
---
**End of Requirements Matrix Guide**
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |