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.
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.
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.
03
Verify
A harness that runs before anything ships: schema checks on structured output, policy checks on tool use, tests on the deterministic parts.
04
Approve
A person signs the deploy. The point of the line is faster honest work, not unattended production changes.
05
Operate
Spend, refusals, and behaviour reviewed on a cadence, with an owner per agent.
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.
Spec
The job on one page
Inputs, the write, the limit, who approves, what it may never do.
Build
The line generates the part
Code and config from the spec, not by hand.
Validate
The harness checks it
Schema, rules and past cases, on every change.
Shadow
It runs beside the person
Writing nothing until its calls match.
Gate
It goes live behind a person
The next agent is a new spec, not a new project.
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 CTOsExample
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 estateExample
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
The team
What people do instead.
Nobody is removed. The work moves up a level, and the review gets sharper.
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.
Next
What to read next.
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.
