Turn your GitHub board into a software factory.
idea → spec → board → agents build in parallel → independent review → CI → merged PR
You sign off on the plan and the merge. The agents do the rest.
unsupervised is an Agent Skill. Install it in
Claude Code, Codex or any agent that can run shell commands, say "set up the
software factory here", and your agent gets
Architech installed, linked to
your board and taking work.
- A plan before any code. Requirements, design, tasks and an acceptance spec. In the Full-Loop, nothing gets built until you approve it.
- Your board as the queue. The plan becomes a parent issue with one sub-issue per task, on your GitHub Project board.
- Agents that build the tasks in parallel and open the pull requests.
- Review by an agent that didn't write the code. It sends work back to the builder; after two rounds, it comes to you.
- CI that bounces back. On the cloud factory, failed CI on its branch sends the work back to the builder, not to you.
- A pull request waiting for one decision: yours.
Small fix? Skip the ceremony: /execute "fix the off-by-one in pagination"
plans, builds, gets the pull request reviewed and merges it as your merge
rules allow. In Fast Mode, the merge is what you approve.
Same pipeline, two places to run it:
| Local factory | Cloud factory | |
|---|---|---|
| Runs in | Your own Architech session | Mutagent Cloud sandboxes |
| Work starts when | You type /dispatch 42 |
Someone adds the pickup label to an issue |
| You approve by | Answering the session | Adding a label on the issue or PR |
| Best for | Trying it on one repository | A board that keeps moving with your laptop shut |
On the cloud factory, label an issue before you log off and the plan is waiting for you in the morning.
- Install the skill (below) and say: "Set up the software factory here, local mode."
- Your agent installs Architech. It asks first and shows you the
installer. You sign in with
/login, then/onboardlinks your GitHub Project board, writes project memory and rules, and commits two files:factory.yamland a one-line pointer inCLAUDE.md. - Hand it work:
/spec, then/publishand/dispatch. Or/executefor a quick fix, which goes on to merge. - Ready for Cloud? Your agent walks you through
architech factory pushandenable. Then the board runs itself, up to your approvals.
Claude Code (plugin):
/plugin marketplace add mutagent-io/unsupervised
/plugin install unsupervised@unsupervised
It loads when you ask about Architech or the software factory, or run it as
/unsupervised:unsupervised.
Any agent, with the skills CLI:
npx skills add mutagent-io/unsupervisedClaude Code, by hand (runs as /unsupervised):
git clone https://github.com/mutagent-io/unsupervised ~/.claude/skills/unsupervisedCodex, by hand:
git clone https://github.com/mutagent-io/unsupervised ~/.agents/skills/unsupervisedOr clone it into a repository's .agents/skills/ to use it there only. Any
other harness: clone it anywhere it can read, and see For agents.
Pinned versions: every release
attaches unsupervised-v<version>.tar.gz.
- "Set up the software factory here, local mode."
- "Plan this feature with Architech."
- "Why didn't the factory pick up my issue?"
- "Hand this bug to Architech and tell me when the PR is up."
- Approvals are labels only a person can add. The factory ignores labels from bots and apps. Your agent never adds one, never approves a gate for you, and never merges.
- Every change lands as a pull request. The merge waits for your approval at every autonomy level.
- It asks before it installs or writes anything, and shows you the installer before it runs.
- No keys in chat. You sign in inside Architech with
/login.
Running a harness that doesn't load skills natively? Read SKILL.md
and follow its three phases: start (install), setup (sign in, model, onboard)
and operate (hand work over, relay questions, read results). Its first section
says what your harness needs and what to do without tmux or without a shell.
For the Software Factory, read references/factory.md.
AGENTS.md points harnesses that load AGENTS.md to the same
place. A user can start you with: "Read github.com/mutagent-io/unsupervised and
set up Architech in this repo."
- Software Factory: https://docs.mutagent.io/factory/overview
- Architech: https://docs.mutagent.io/architech/overview
- Agent Skills format: https://agentskills.io/specification
See CONTRIBUTING.md. Licensed under the MIT License.