Guide · spec-driven engineering

Write the specification. Let the line build the part.

One agent is a project. Ten agents is an operating model: specifications, guardrails, shadow mode, and a review cadence. Engineers stop hand-writing every endpoint and start owning the line that produces them.

Founded 2022 · Founder in the Salesforce MVP Hall of Fame · Dubai HQ · Kochi studio

The shift

From handcrafted code to a line you designed.

This is not “the model writes the app”. It is the same discipline a plant engineer uses: specify, constrain, verify, then run the line.

  1. 01

    Specify

    The desk, the inputs, the allowed tools, the write, and the rollback. If it cannot be written down, it is not ready to be automated.

  2. 02

    Constrain

    A policy catalogue and a scaffold that already carries identity, logging, and budgets. New agents inherit the rules instead of re-arguing them.

  3. 03

    Verify

    A harness that runs before anything ships: schema checks on structured output, policy checks on tool use, tests on the deterministic parts.

  4. 04

    Approve

    A person signs the deploy. The point of the line is faster honest work, not unattended production changes.

  5. 05

    Operate

    Spend, refusals, and behaviour reviewed on a cadence, with an owner per agent.

Spec-driven delivery. The engineer authors the specification and the guardrails. Agents implement against them, the harness verifies, and a person approves the deploy.
Mermaid source
flowchart TD
  E["Engineer: specification, guardrails, policy catalogue"] --> A["Agents implement against the spec"]
  A --> V["Validation harness: tests, schema checks, policy checks"]
  V -->|"fails"| A
  V -->|"passes"| H["Human review and approval"]
  H --> D["Verified deployment"]
  D --> O["Fleet operations: spend, refusals, anomalies"]

Principles

Five rules we hold to.

The line

From one page to a running agent.

  1. Spec

    The job on one page

    Inputs, the write, the limit, who approves, what it may never do.

  2. Build

    The line generates the part

    Code and config from the spec, not by hand.

  3. Validate

    The harness checks it

    Schema, rules and past cases, on every change.

  4. Shadow

    It runs beside the person

    Writing nothing until its calls match.

  5. Gate

    It goes live behind a person

    The next agent is a new spec, not a new project.

Spec-driven engineering, as we run it on agent work.

Before the third agent

Three teams rebuilding the same part.

Typical signs that the next agent needs a spec, not a new project.

  • Example

    CTO, Riyadh consumer lender

    Today: Agent number four was built by hand, and no two of the four log the same way.

    After: A new agent starts from a template with identity, structured errors, telemetry and budgets already wired.

    For CTOs
  • Example

    Head of operations, Dubai property developer

    Today: Nobody in the business can say what the agent is allowed to write.

    After: One page names the inputs, the write, the limit and who approves. The business owner signs it.

    Real estate
  • Example

    Engineering manager, Austin software company

    Today: Every agent change is different, so review has become a rubber stamp.

    After: The harness checks schema, rules and past cases on every change, so review is quick enough to be real.

    Technology and software
Examples of the work, not case studies. Roles and cities are typical of the desks we see.

Questions

What we actually say.

Is this a licence to let agents commit to production?
No. A person approves the deploy. The harness and the guardrails make that review fast enough to be real rather than a rubber stamp.
Do we need this for our first agent?
No. You need it before the third. The cost of retrofitting scaffolds, budgets, and shadow mode across a handful of bespoke agents is the reason programmes stall.
How long does shadow mode run?
Until the proposals match what the desk would have done, on a sample the business owner accepts. We report the disagreements, not a score we invented.
Will you publish a productivity multiple?
No. We will show you the specification, the harness, and the review cadence. Anyone quoting a multiple for your estate has not read it.

The brief · one email

Send one process you keep rebuilding.

We will tell you whether a specification and a harness would have stopped that. The assessment is free: a short read of the org and a written note. If you go ahead, the first build week is a fixed AED/SAR 14,900 (about USD 4,050), credited in full when you sign the build within 60 days. The honest no: if the work is a software factory with a named delivery date, we are the wrong partner.