How it works

Your production system is the specification.

We use production behavior as the starting evidence and turn it into a reviewed System Specification, which is the contract we build and prove against. The CLEAR method has five stages, Capture, Lock, Engineer, Attest and Release, and each produces an output your team can check.

The CLEAR method, step by step

Follow one workflow from Capture to Release.

Your team reviews the output of each step before the next begins. The diagram follows a single illustrative workflow.

Step 01

Capture: see what the running system actually does.

A guided, fully-automomous agentic AI setup connects application instrumentation, request traffic and available product analytics. We also read the schema and map reporting dependencies. Evidence accumulates with each pass, and behavior that has not been observed is recorded as a gap.

  • Requests, background jobs, errors and queries, tagged by release
  • Representative workflows, business cycles and rare paths
  • Sensitive payloads redacted and collection kept off the request path

Your customers see no change.

Step 02

Lock: agree what the new version must do.

Owners and engineers review workflows, rules, data relationships and exceptions. When coverage and confidence meet the level agreed for the scope, that version of the System Specification is approved and locked, with testable outcomes and stated limits. Later changes go through a new approved version. Unresolved gaps lead to more capture or a narrower scope.

  • Rules, inputs and outputs, data relationships and state transitions
  • Claims linked to evidence, with uncertainty and exclusions recorded
  • Acceptance criteria signed off by your team

Your owners approve each locked version.

Step 03

Engineer: rebuild the workflow in short sprints.

Engineering agents rebuild the scoped workflow on a modern architecture against the locked specification, and engineers review the results. When production changes in a relevant way, a new version of the specification is approved and its tests are updated, so the rebuild keeps pace with the business.

  • Work tracked on a shared board, with a named owner for each step
  • Changes reviewed against written standards
  • Spend capped per item and per day

Built alongside the current system, with no customer traffic.

Step 04

Attest: test the rebuild against the original.

Legacy and modernized implementations are compared against the same specification by routing traffic through both at the same time. We check business outcomes, data and reports, permissions and performance, and resolve differences before the replacement handles any live traffic.

  • Representative workloads replayed or shadowed with side effects controlled
  • Totals and reports reconciled against the current system
  • A proof report to support a go or no-go decision

Differences are measured and resolved before go-live.

Step 05

Release: move production when the evidence supports it.

We release a bounded workflow or customer cohort, with acceptance criteria, a data transition plan and rollback. Your team approves each transition, and the evidence and specification stay current for the next priority.

  • An illustrative path of 1%, 10%, 50% and 100%, with each step gated on evidence
  • Rollback tested before it is needed
  • Data cutover handled as its own workstream

Your team sets the pace and can roll back at any step.

If a freeze is required

Keep any freeze short and scoped.

Some replacement plans need a period of stable behavior or schema during reconstruction, validation or cutover. We don't assume one, because parallel builds and incremental replacement work without a whole-system freeze. Where a freeze is needed, we agree what it covers and how much interruption the business can accept.

People and agents on one board

Your team approves each gate that affects production.

Business analyst, architect, developer, qa and devops AI Aagents move each item through declared stages. People step in at plan review, merge, open findings and budget decisions, and no change reaches production without your team's approval.

Fabrica · NEXA TSOS · Boardloop armed · 2/3 running
To do2
fab-4h8kP2
Norma policy page: version history
normaF
fab-8q1zP1
Aula SSO session refresh loops on expired cookie
aulaAN
In progress9
AnalysisBA
fab-0p3mP2
Metra: weekly utilisation digest
analysis · running · 2m
metra$0.38F
Plan reviewhuman
fab-2k7vP1
Excelsior: import rate cards from spreadsheet
needs human · plan review2 REQ$3.10
ImplementingDev
fab-9k2pP1
Flag unbillable allocation lines when no rate card
implementing · pass 1 · 11m
assigna1 REQ$4.12F
Done38
fab-7w3eP2
Metra: utilisation chart ignores public holidays
metradeployed
fab-c214P2
Provenance panel on work item
deployed$14.30F
fab-ydmhP3
Human merge recorded by webhook
deployedAN

What you can inspect

Outputs your team can review at each stage.

Capture

Evidence map

Correlated requests, jobs, queries and outcomes, with provenance, version history and known gaps.

Lock

System Specification

A locked, versioned contract of rules, data and acceptance tests, with its limits stated. Changes create a new approved version.

Engineer

Board and pull requests

Items, owners, stage and cost for each workflow, with changes submitted as reviewed pull requests in your repository.

Attest

Proof report

Differences in outcomes, data, permissions and performance, and how each was resolved.

Release

Shift plan and log

Acceptance criteria, cohorts, rollback steps and a record of each transition.

Ongoing

Living documentation

Pages that stay current as linked work is completed, so the next renewal starts from what is already known.

Which priority is your system holding up?

Tell us about it on a 30-minute call. We'll suggest a first scope and what a technical review would need to confirm.

Book a 30-minute call