Scaffold structured markdown design documents with required sections.
npx skills add https://github.com/mihai-chiorean/inc --skill design-doc-mihai-chiorean
Please help me install this Agent Skill. Skill: design-doc Source: https://github.com/mihai-chiorean/inc/tree/main/skills/design-doc Command: npx skills add https://github.com/mihai-chiorean/inc --skill design-doc-mihai-chiorean
This skill solves the problem of inconsistent, incomplete, or missing design documentation by providing a standardized, mandatory structure for architectural decision-making.
Invoke the design-doc skill to scaffold a new design document for your current project by providing a descriptive title.
High-intent search queries and answers about installing and using this skill.
Scaffolding a design document requires generating a structured markdown template via a CLI wrapper. This enforces architectural consistency by ensuring technical planning sections like user flows, state machines, and failure modes are addressed.
An architectural decision record (ADR) documents technical decisions for a repository. You need one when starting a new M-sized or larger feature to ensure technical requirements, implementation alternatives, and failure modes are documented before coding begins.
Yes, git is required for path resolution when generating architectural documentation templates. The CLI wrapper uses git to manage template generation, assign sequential ADR identifiers, and organize files within your software engineering workflow.
The best way to enforce mandatory sections in technical planning is using a standardized scaffolding tool. It automatically generates markdown templates that require sections for data flow diagrams, state machines, and user flows before development proceeds.
This scaffolding is intended for new M-sized or larger features, not small bug fixes. It enforces rigorous architectural consistency by documenting implementation alternatives and failure modes, which is unnecessary overhead for minor code changes.
pedronauckAnalyzes git history to extract software engineering lessons and principles.
jlawsMap workflow execution paths, failure modes, and handoff contracts.
stevolandCreate and manage MADR-compliant Architecture Decision Records across projects.
franroaDesign scalable software architectures and document decisions with ADRs.
