Documentation

Coroid documentation

Learn how to set the standard every change to your codebase must meet, so anyone in your company can ask for work and every change is built, tested and reviewed to it.

Coroid is an AI software factory for production systems. Engineering sets the standard once: the project context, the quality policies every change must pass, the review rules and who approves. After that, anyone in your company can ask for a change in plain language, without a CLI or knowing how the code is built. Coroid plans the work, writes the code, tests it, reviews it to that standard, and opens a pull request in your repository for you to approve.

These docs cover the product as it ships today. If a feature is not documented here, it is not available yet.

New here

Work through Get started in order. It takes you from an empty account to a merged pull request: create an organization, connect a repository, create a project, run a task, review the result.

Understand how it works

How a task becomes a pull request is the page everything else refers back to — the full path from your description to a PR, with every stage named.

Then Agent roles for who does what, and the specification-driven development guide, which is the highest-leverage thing you can get good at. The quality of what Coroid builds is bounded by the quality of what it is asked to build.

  1. 1Specification

    What will be built, and how you will know it worked

    ArchitectYou can edit
  2. 2Plan

    Ordered steps, reviewed before any code is written

    ArchitectYou approve
  3. 3Build

    Code and tests written in an isolated workspace

    Developer
  4. 4Verify

    Your test suite, plus checks and quality gates

    QA
  5. 5Review

    An automated review pass over the diff

    Reviewer
  6. 6Pull request

    On a branch in your repository, waiting for you

    You merge

Failed verification and fixable review findings go back to the developer as rework, before any pull request opens.

Six stages, each with one owner. You step in at the specification, the plan and the merge.

Find your way around

SectionWhat it covers
Get startedAccount to first merged pull request
ConceptsHow the system actually works
Work and planningStarting work, tasks, plans, releases
Projects and codeRepositories, build and test setup, context
The factoryRunning work, automations, reports
Quality and reviewGates, findings, evidence, browser tests
GlobalizationLanguages, translations, world-ready code
Operations and monitoringMission Control, findings, notifications
Organization settingsMembers, keys, policy, retention
Billing and capacitySlots, credits, usage, invoices
IntegrationsSource control, chat, MCP, evidence, hooks
ReferenceGlossary, statuses, limits, troubleshooting

Three things worth knowing immediately

Agent slots control how many tasks run at once — not how fast one runs. A single task's duration comes from the size of the change and your test suite. See Capacity and agent slots.

NEEDS_HUMAN_REVIEW is not a failure. It means the work hit a decision only you can make. Answer it and the task continues. See Task statuses.

Something not behaving as expected

Start at the troubleshooting index, which maps symptoms to answers.