Repolode
Hainrixz

Hainrixz/the-architect

A Claude Code plugin that interviews you, designs a full software architecture, and writes a self-contained blueprint for another Claude Code instance to build from.

Stars
554
Forks
101
Open issues
3
Last commit
3 days ago

What is it?

The Architect is a meta-agent for Claude Code. It asks a short set of questions about what you want to build, classifies the project into one of 14 shapes (such as SaaS web app, API backend, CLI/MCP server, or data pipeline), and produces a design covering stack, architecture and build order. It does not write application code; its output is a markdown blueprint meant to be handed to a separate Claude Code session with no prior context.

Each build step in the blueprint has four fields: Do, Done when, Verify, and Checkpoint. Acceptance criteria are written in EARS form and must be checkable by a script, and each step ends with a runnable verify command and a git checkpoint. Package versions are checked against live registries during design, and the validator rejects blueprints that contain vague criteria such as "it looks right".

The plugin supports greenfield projects and brownfield changes to existing repositories, which are mapped before questions are asked. It offers a quick three-question mode and a full interview mode, and includes slash commands to resume builds, refresh pinned versions and re-audit blueprints. Installation is through the Claude Code plugin marketplace or by cloning the repo.

Key features

  • 01Interviews the user and classifies the project into one of 14 project shapes, greenfield or brownfield.
  • 02Generates blueprints with 20 fixed sections and build steps that each include a runnable verify command.
  • 03Writes acceptance criteria in EARS form and rejects vague criteria through a validator.
  • 04Checks package versions against live registries during design.
  • 05Offers quick and full interview modes plus commands to resume, refresh and audit blueprints.

Use cases

  • Turning a rough product idea into a detailed plan before handing it to an autonomous Claude Code builder.
  • Designing a change to an existing repository with a blueprint that respects its conventions.
  • Resuming a long multi-session build by reading the task list and next verify command.
  • Refreshing outdated dependency pins in an existing project plan.

Quick start

  1. 1

    Add the marketplace in a Claude Code session

    /plugin marketplace add Hainrixz/the-architect
  2. 2

    Install the plugin

    /plugin install the-architect@soyenriquerocha
  3. 3

    Run the architect in any directory; blueprints are written to ./blueprints/

    /architect

Things to know

  • Requires Claude Code and a Claude subscription.
  • Blueprint generation can take roughly 25 to 35 minutes for a bundle, with no output until it finishes.
  • It designs systems and writes blueprints but does not write application code.

Topics

FAQ

What is the-architect?
A Claude Code plugin that interviews you, designs a full software architecture, and writes a self-contained blueprint for another Claude Code instance to build from. The Architect is a meta-agent for Claude Code. It asks a short set of questions about what you want to build, classifies the project into one of 14 shapes (such as SaaS web app, API backend, CLI/MCP server, or data pipeline), and produces a design covering stack, architecture and build order. It does not write application code; its output is a markdown blueprint meant to be handed to a separate Claude Code session with no prior context.
Is the-architect free to use? What license does it have?
the-architect is open source under the MIT license. Check the license terms before using it in commercial products.
Is the-architect still maintained?
Actively maintained. The last commit to the-architect was on Oct 17, 2026.
What can I use the-architect for?
Turning a rough product idea into a detailed plan before handing it to an autonomous Claude Code builder. Designing a change to an existing repository with a blueprint that respects its conventions. Resuming a long multi-session build by reading the task list and next verify command. Refreshing outdated dependency pins in an existing project plan.
How do I install the-architect?
Add the marketplace in a Claude Code session: /plugin marketplace add Hainrixz/the-architect Install the plugin: /plugin install the-architect@soyenriquerocha Run the architect in any directory; blueprints are written to ./blueprints/: /architect
Where can I get the-architect?
The source code and installation instructions are on GitHub: https://github.com/Hainrixz/the-architect

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects