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.
Install
npx skills add owainlewis/blueprint --skill architecturegit clone --depth 1 https://github.com/owainlewis/blueprint.git /tmp/blueprint
mkdir -p ~/.claude/skills
cp -r /tmp/blueprint/skills/architecture ~/.claude/skills/architecturePersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Architecture Fill in the [architecture template](references/architecture.md) in root `ARCHITECTURE.md`. It describes the system you intend to build and stays current as it changes. Product needs go in [requirements](../requirements/SKILL.md); one feature's design goes in a [spec](../spec/SKILL.md). ## Steps 1. Read `REQUIREMENTS.md`, the repository instructions, and any existing code, schemas, and infrastructure. Check every claim about the current system against them. 2. 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. 3. Choose the simplest design that meets the requirements. For each big decision, name the strongest alternative and why you did not pick it. 4. Fill in the template. Replace every bracketed placeholder and delete the guidance comments. Render the diagram and check that it matches the text. 5. Stop when the document is ready for review. Do not plan tasks or write code. ## Template Use [references/architecture.md](references/architecture.md). ## Rules - Keep existing `INV-n` IDs. 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.
Details
- Skill name
architecture- Repository
- owainlewis/blueprint
- Path
skills/architecture/SKILL.md- License
- MIT
- Repo updated
- 10 November 2026
FAQ
What does the Architecture skill do?
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 the Architecture skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add owainlewis/blueprint --skill architecture. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Architecture popular?
It lives in owainlewis/blueprint, which has 434 GitHub stars and 73 forks.
Related skills
Architecture Review
434owainlewis/blueprint
Reviews a technical proposal before any code is written: an architecture, spec, RFC, ADR, or design issue. Finds choices that would make it wrong, unsafe, or impossible to prove, and the open questions that block building it.
Codex Issue Coordinator
434owainlewis/blueprint
Coordinates a large batch of GitHub issues through separate Codex worker threads, tested pull requests, review loops, and gated merges. Use when the user asks one Codex thread to manage several coding sessions or complete a parent issue, milestone, or issue batch.
HTML Doc
434owainlewis/blueprint
Generates a polished, static HTML reading view from an existing Markdown PRD or technical design. Use when a user asks to render, present, visualize, or make a PRD or design document easier for humans to read in a browser.
Wechat Use
222leeguooooo/wechat-use
Use WeChat on macOS Apple Silicon or Windows x64: query sessions, contacts and history, listen for messages, and send authorized text. Select the host-specific backend first. Windows has a standalone experimental CLI/MCP package with no system Python requirement; macOS uses the managed WeChat 4.1.9 clone and supports HTTP Bridge/Wechaty.
Referral Program
376mysticaltech/marketingskills
When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy. Also use when the user mentions 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' or 'partner program.' This skill covers program design, incentive structure, and growth optimization.
Improve
434owainlewis/blueprint
Makes existing code easier to understand without changing behavior. Use to simplify structure, remove duplication or dead code, improve names, or remove unnecessary abstractions.
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.