owainlewis/blueprint242 installs
design-doc
Write a short design document for unclear or important architecture decisions before implementation. Use when a decision is expensive to reverse or crosses team boundaries.
How do I install this agent skill?
npx skills add https://github.com/owainlewis/blueprint --skill design-docIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a documentation utility designed to help users create technical design documents. It analyzes project context and writes a Markdown file. No security risks or malicious patterns were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Design Doc
- Read the brief and any linked docs, code, or plans. Ask one question at a time, with a recommended answer, only when a missing fact would change the design.
- Write
docs/<design-slug>/design.md, 1-3 pages, using the template below. Omit sections that do not apply. - Stop after writing. Do not continue into spec, plan, or implementation until the human confirms.
Rules
- Make the design choice and its tradeoffs easy to review.
- Focus on decisions code will not explain later.
- Do not copy full schemas, APIs, or code unless the exact shape is central.
- Leave Status as Draft and Decision empty. Both are filled during review.
Template
# <Title>
**Status:** Draft | In review | Approved
**Author:** <name> **Date:** <date>
## Summary
One paragraph: the problem, the proposed solution, and why.
## Goals
What this design must achieve.
## Non-goals
What it deliberately does not solve.
## Constraints
Technical, product, migration, compatibility, operational, cost, or time limits.
## Proposed design
How it works. Structure, data flow, key interfaces. Diagram only if it clarifies.
## Alternatives and tradeoffs
Each option considered, why it lost. This is the section reviewers judge.
## Risks
What could go wrong and how it is mitigated.
## Rollout
How it ships: migration, flags, backout.
## Open questions
Decisions still needed and from whom.
## Decision
Filled in after review: what was decided, by whom, when.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/owainlewis/blueprint/design-doc">View design-doc on skillZs</a>