whatisgithub

What is architect?

vortezwohl/architect — explained in plain English

Analysis updated 2026-05-18

27PythonAudience · developerComplexity · 3/5LicenseSetup · easy

In one sentence

A three stage plugin (design, propose, build) that forces AI coding agents like Claude Code and Codex to make architecture decisions explicit before writing code.

Mindmap

mindmap
  root((Architect))
    What it does
      Forces explicit design decisions
      Design propose build workflow
      Prevents silent architecture drift
    Tech stack
      Python
      Claude Code plugin
      Codex plugin
    Use cases
      Plan a risky refactor
      Add a feature without breaking compatibility
      Keep AI agents from guessing structure
    Audience
      Developers
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get an AI coding agent to produce an approved design before it touches any code.

USE CASE 2

Turn an approved design into a sealed, task-by-task execution plan.

USE CASE 3

Execute a large refactor or new feature in bounded, logged steps instead of one big diff.

USE CASE 4

Prevent an agent from inventing speculative abstractions for features that do not exist yet.

What is it built with?

PythonClaude CodeCodex

How does it compare?

vortezwohl/architectavbiswas/sam2-mlxchanthruu/wind_energy_monitor
Stars272727
LanguagePythonPythonPython
Setup difficultyeasymoderatemoderate
Complexity3/54/53/5
Audiencedeveloperresearcherdata

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Installs as a plugin marketplace entry for Codex or Claude Code, requires starting a new agent session after install.

Free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Architect is a plugin and skill set for AI coding agents such as Claude Code and Codex, built to stop those agents from making silent structural decisions while they write code. The problem it addresses is that a request that sounds simple, like adding a second payment provider or refactoring a service, actually forces decisions about ownership, boundaries, compatibility, and rollback behavior. When those decisions are left implicit, a codebase tends to drift into messy patterns: features landing in whatever file is nearest, speculative abstractions built for a future that never arrives, or existing behavior changed without anyone deciding on purpose to change it. Architect forces those decisions into the open through a strict, manual three stage workflow: design, then propose, then build. In the design stage, you describe the change you want in plain language, and Architect reads the repository, asks what needs to stay compatible, and produces an approved design bundle without writing any code yet. In the propose stage, you give the approved design a short plan name, and Architect turns it into a sealed package containing task files, a verification plan, and an execution log. In the build stage, you run that same plan name again, and Architect executes the recorded tasks in order, staying inside the boundaries the design stage set, and updates its logs with what actually happened. Each stage refuses to do the next stage's job. The design stage will not write files or implement anything. The propose stage will not redesign the solution or edit application code. The build stage will not reopen the design or invent new structure partway through. The tool is intentionally manual: it will not guess which stage to run next for you, and the README is explicit that you should not skip straight from a big request to the build stage. You can install Architect as a plugin for Codex or Claude Code, or add its skills directly to a compatible tool. After installing, you start a new session so the agent can discover the added commands. The project is licensed under MIT.

Copy-paste prompts

Prompt 1
Run architect-design on this request: add a second payment provider without breaking checkout.
Prompt 2
Explain what architect-propose will produce once my design bundle is approved.
Prompt 3
Walk me through installing Architect as a plugin for Claude Code.
Prompt 4
Show me the difference between how a normal coding agent handles this change versus how Architect's three stages handle it.

Frequently asked questions

What is architect?

A three stage plugin (design, propose, build) that forces AI coding agents like Claude Code and Codex to make architecture decisions explicit before writing code.

What language is architect written in?

Mainly Python. The stack also includes Python, Claude Code, Codex.

What license does architect use?

Free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is architect to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is architect for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.