From design-doc
Generates RFCs and Architecture Decision Records (ADRs) from feature descriptions — reads existing docs to maintain numbering and style. Use when asked to "write rfc", "create adr", "design doc", "architecture decision", "technical design", "write proposal", "document decision", or "design document".
How this skill is triggered — by the user, by Claude, or both
Slash command
/design-doc:design_docThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Generate RFCs and Architecture Decision Records (ADRs) that follow your project's existing numbering, format, and style conventions.
Generate RFCs and Architecture Decision Records (ADRs) that follow your project's existing numbering, format, and style conventions.
None. The skill will create the docs directory if one does not already exist.
Determine document type (RFC or ADR) from the user request:
Scan for existing docs to discover where documents live:
find . -type d -name "rfcs" -o -name "adrs" -o -name "decisions" -o -name "architecture" | head -20
docs/rfcs/, docs/adrs/, docs/decisions/, docs/architecture/docs/adrs/Read existing documents to determine:
0001-, ADR-001-, sequential integers)Calculate the next number in the sequence based on existing documents.
Gather context from the user:
Generate the document using the appropriate template:
RFC Template:
# RFC-{NNN}: {Title}
- **Status**: Draft
- **Author**: {author}
- **Date**: {date}
## Summary
## Motivation
## Detailed Design
## Alternatives Considered
## Migration/Rollout Plan
## Open Questions
ADR Template:
# ADR-{NNN}: {Title}
- **Status**: Proposed
- **Date**: {date}
## Context
## Decision
## Consequences
### Positive
### Negative
### Neutral
Write the file and present it to the user for review.
Offer to create a git branch for the design doc so it can go through a review process.
| Problem | Cause | Solution |
|---|---|---|
| Existing docs not found | Documents live in a non-standard directory | Ask the user for the correct path or search more broadly with find |
| Numbering conflict | Two documents share the same sequence number | Re-scan the directory, pick the next unused number, and flag the conflict |
| Template mismatch | Project uses a custom template that differs from defaults | Read an existing document first and mirror its structure instead of using the built-in template |
npx claudepluginhub shouenlee/ghcp-dev-plugin --plugin design-docCreates new Architecture Decision Records (ADRs) for architectural changes using repo conventions for naming, numbering, and storage. Use when documenting decisions, rationale, and trade-offs.
Records finalized decisions as ADRs and open proposals as RFCs. Routes to standards or architecture specs when requested.