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.

434 stars 73 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add owainlewis/blueprint --skill architecture
Manual install
git clone --depth 1 https://github.com/owainlewis/blueprint.git /tmp/blueprint
mkdir -p ~/.claude/skills
cp -r /tmp/blueprint/skills/architecture ~/.claude/skills/architecture

Personal 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.
Read the full skill on GitHub

Details

Skill name
architecture
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

434

owainlewis/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.

Software Development73

Codex Issue Coordinator

434

owainlewis/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.

Software Development73

HTML Doc

434

owainlewis/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.

Data & Analytics73

Wechat Use

222

leeguooooo/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.

Software Development143

Referral Program

376

mysticaltech/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.

Software Development91

Improve

434

owainlewis/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.

Software Development73

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.