CLI proxy that filters and compresses shell command output before it reaches an AI coding agent's context, cutting token use.
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
Add the marketplace in a Claude Code session
/plugin marketplace add Hainrixz/the-architect - 2
Install the plugin
/plugin install the-architect@soyenriquerocha - 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
A CLI and skill layer that installs, configures and health-checks channels so AI agents can read and search Twitter, Reddit, YouTube, Bilibili, XiaoHongShu and more.
Multi-agent orchestration layer for Claude Code, adding team pipelines, autonomous execution and tmux-based CLI workers.
A browser built for AI agents and you to share: agents run tasks in isolated Spaces while your own tabs and logins stay untouched.
A collection of 45+ practical tips for using Claude Code, plus a custom status line script and the dx plugin of everyday dev skills.
A free, independent three-level guide to Claude Code, from first session to unattended multi-agent runs, with checked exercises.