architecture
Writes root ARCHITECTURE.md from a fixed template: the intended system, a data flow diagram, the data model, and the rules every feature must follow. Use for a new system or a change to its boundaries, data, or deployment.
How do I install this agent skill?
npx skills add https://github.com/owainlewis/blueprint --skill architectureIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is safe for use. It automates the generation of architecture documentation by reading local repository files and git configuration. It follows a structured process with human-in-the-loop approval and restricted tool execution, adhering to best practices for documentation agents.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Architecture
Fill in the architecture template in root ARCHITECTURE.md. It describes the system you intend to build and stays current as it changes. Product needs go in requirements; one feature's design goes in a spec.
Steps
- Read
REQUIREMENTS.md, the repository instructions, and any existing code, schemas, and infrastructure. Check every claim about the current system against them. - Ask the user about each decision that shapes the system: boundaries, who owns which data, dependencies, and hard limits. Give your recommended answer with each question.
- Choose the simplest design that meets the requirements. For each big decision, name the strongest alternative and why you did not pick it.
- Fill in the template. Replace every bracketed placeholder and delete the guidance comments. Render the diagram and check that it matches the text.
- Stop when the document is ready for review. Do not plan tasks or write code.
Template
Use references/architecture.md.
Rules
- Keep existing
INV-nIDs. Never reuse or renumber them. - Set the status to Approved only when a human approves the document. Approved is not the same as built.
- Take the author from the request, or else from
git config user.name. Set the date each time the document changes. - Never invent workload or latency numbers. Mark unknown targets as open decisions.
- Update this document when a change moves ownership, data, interfaces, trust boundaries, or deployment.
Return
Report the path, the main decisions and their tradeoffs, and any blocking question.
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/architecture">View architecture on skillZs</a>