Research a codebase and create architectural documentation describing how features or systems work. Use when the user asks to: (1) Document how a feature works, (2) Create an architecture overview, (3) Explain code structure for onboarding or knowledge transfer, (4) Research and describe a system's design. Produces markdown documents with Mermaid diagrams and stable code references suitable for humans and AI agents.
Initial release of describe-design skill. - Guides users through documenting a codebase's architecture, features, or systems using structured markdown. - Provides a clear, staged workflow: scoping, exploration, detailed research, drafting, and finalization. - Outputs documents with Mermaid diagrams, stable code references, and a consistent template. - Enforces best practices: no copying code, no line numbers, repository-relative paths only. - Designed to serve both human and AI audiences with clear, searchable documentation. - Always requires user confirmation before writing files to disk.