> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mutagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# What is Architech

> The software-engineering harness: agents that plan, build and review your code changes.

> [!NOTE]
>
> **Early Access.** Commands and behavior can change between releases.

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](https://docs.mutagent.io/architech/agents.md). 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](https://docs.mutagent.io/factory/overview.md) 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](https://docs.mutagent.io/factory/cloud.md), where each stage runs in its own sandbox. One file,
`factory.yaml`, holds your board, repositories and approval rules.

> [!NOTE]
>
> You don't need a Factory to use Architech. If you pick a board during onboarding, your project
> gets a local `factory.yaml`. Moving it to Cloud is a separate step you take yourself.

## Get started

1. [Install Architech](https://docs.mutagent.io/architech/install.md).
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.

> **[Install Architech](https://docs.mutagent.io/architech/install.md)**
>
> Install the binary and start a session.

> **[Orchestrator and agents](https://docs.mutagent.io/architech/agents.md)**
>
> Who plans, builds and reviews your work.

> **[Software Factory](https://docs.mutagent.io/factory/overview.md)**
>
> Take an issue from plan to reviewed pull request.

> **[Explore the features](https://docs.mutagent.io/architech/features.md)**
>
> Sub-agents, workflows, Monitor, traces, project context and MCP.

Building LLM agents rather than software? See [Helix](https://docs.mutagent.io/helix/what-is-helix.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.