Skip to content
All use cases
Unfamiliar codeOnboardingRepository conventions

A feature in a service nobody on the team owns

Add the endpoint without first reading the whole service

Land a feature in a codebase you have not worked in — where the real risk is not writing the code, it is putting it in the wrong layer and inventing an abstraction that does not match the house style.

127.0.0.1:8787
The Organisation page: the roles that exist, grouped by department, with what each role owns.
Who exists, what they own, and where they sit in the office. Thirteen roles across eight departments, each with its own model band and skills.
The problem

What actually goes wrong today

Stated plainly, because the approach below only makes sense as an answer to something specific.

  • 01

    The change is small and the surrounding context is not. Reading a service end to end to add one capability is days of work that produces nothing shippable.

  • 02

    A single agent handed the feature will produce something plausible and unidiomatic: a new service class in a repository that has none, a helper where the project keeps utilities in one file, a migration where the project has never used them.

  • 03

    The decision that actually matters — does this belong in the existing module or a new one — is exactly the decision a single voice skips, because it never has to defend the choice.

  • 04

    Nobody notices the seam was wrong until review, which is the most expensive moment to find it.

The approach

How the hierarchy and the router do it

Concretely, stage by stage: which mode the stage uses, who owns it, and why the router prices it the way it does.

  1. 01

    Intake on the cheapest capable model, because classifying "add an endpoint" does not need a frontier call.

  2. 02

    Parallel research: one specialist maps the call path, another finds the conventions actually used in the repository (naming, error shape, how tests are written) by reading files rather than guessing them.

  3. 03

    A debate between the roles that would own the change on either side of the seam. The chair records the ruling, so the shape of the change is a decision with a reason, not an accident of which file the agent opened first.

  4. 04

    The CTO writes the file-level plan with the falsifier stated: what would show that placing the feature here was wrong.

  5. 05

    Developer agents write the files, then QA tries to break it — the new path exercised, the error case probed, the surrounding contract checked for a change nobody intended.

  6. 06

    Routine turns stay on lower tiers; only the plan, the implementation and the review escalate. The tier band is declared per role, so the cheap posture cannot quietly downgrade the architecture decision.

The outcome

What you actually end up with

Artifacts, not assurances. Every one of these is something you can open, diff, review or throw away.

  • The feature, plus a written record of where it was placed and why, which is what the next person to touch the service actually needs.

  • Conventions are followed because they were read from the repository in the research stage, not inferred from a training distribution.

  • Review gets a plan and a diff to argue with, instead of a finished change with no visible reasoning.

Staffing

Which part of the company is involved

Six of the thirteen roles, four of the eight departments. The rest of the office stays idle, and that is what keeps the run affordable.

Roles by stageper-floor org chart
Intake
CEO

Classifying "add an endpoint" does not need a frontier call, and the router does not make one.

Research (parallel)
Researcher, business analyst

One maps the call path, another finds the conventions actually in use — naming, error shape, how tests are written.

Debate
CTO as chair, design and engineering on either side

The seam decision is the whole point: which module owns the change, argued rather than assumed.

Plan
CTO

Names the files and states the falsifier — what would show that placing the feature here was wrong.

Build
Developers

Implements against the conventions that were read rather than against a training-distribution average.

QA
QA engineer

Exercises the new path, probes the error case, and checks the surrounding contract for an unintended change.

The org chart is data. A floor can hire, fire, re-seat and re-price its own company, and a plugin can contribute a role template — which is the point of naming roles rather than numbering agents.

Modes used

Intake runs single, research runs parallel, contested decisions run as a debate, and anything that produces files ends in a review-loop.

Where the money goes

Reading and summarising sit on cheap bands. The plan, the implementation turns and the review escalate, because those are the turns where being wrong is the expensive mistake.

What is recorded

Per-turn cost, the route decision and the models the router rejected, the files touched, and the debate ruling including the position that lost.

Run this in mock mode first

Node 24, one install, no API keys. The pipeline, the stages, the file writes and the review loop all run against scripted employees, so you can watch the shape of the work before it costs anything.

Before you point it at production

Nothing in the orchestrator authenticates, so bind it to localhost. The tools are confined to the run workspace, but that workspace is a normal directory on the machine and the orchestrator is not inside an operating-system sandbox — give it a checkout you would be willing to lose.