What is Architech

Architech is a harness for software engineering. You run it in your repository and describe the change you want. A team of agents plans it, builds it, tests it and reviews it with you. You stay in charge of what gets built and what gets merged.

​

What it does for you

• Plans before it builds. The architect turns your request into requirements, a design and tasks. You approve the plan first.
• Builds and tests the change. The developer writes the code and its tests in your repository.
• Reviews with a fresh pair of eyes. A separate reviewer checks the work, so no agent approves its own change.
• Knows your project. Agents read your project context and engineering rules before they touch your code.

​

How it works

Your session is the orchestrator. It reads your project, hands each piece of work to the right agent and brings the results back to you. You talk to one session; the agents do the work behind it. Work moves through four steps: plan → build → review → land. You approve the plan and you approve the merge. Review can send work back to build until it passes. If you use a board, such as GitHub Projects, Architech reads your issues from it. Each planned issue becomes tasks, and each task becomes a reviewed pull request.

​

The Software Factory

The Software Factory runs that lifecycle for your board: issues go in, reviewed pull requests come out. Run it on your machine from an Architech session, or on Mutagent Cloud, where each stage runs in its own sandbox. One file, factory.yaml, holds your board, repositories and approval rules.

​

Get started

1. Install Architech.
2. Run architech in your repository.
3. Type /onboard. Onboarding sets up your project context and engineering rules. A board is optional.
4. Describe a change, or type /spec to plan a feature.

Building LLM agents rather than software? See Helix.