Skip to main content
Compendium · Compositions · Process Flows

Process Flows

Items
16
of 1002 total

Full-featured composed scenes — one per row so each design has room to breathe. Click for the live render, the spec, and the source.

№ 106

IRAF Expanded

Scene STA
Procedure № IRAF cyclic · four signatures

Every loop turn
has a contract.

Intent, Reasoning, Action, Feedback. At each stage a human owns a decision, an agent does the labour, and an artefact is signed before the baton passes.

I

Intent

DECLARE
Human
Authors the spec — intent, acceptance, constraints, failure modes.
AI
Drafts spec scaffolds, flags ambiguity, scores ICS.
Signed Approved spec @ v1.0
II

Reasoning

DELIBERATE
Human
Architects the approach — picks the design within the spec’s constraints.
AI
Generates plan, surfaces trade-offs, simulates likely failure modes.
Signed Plan + diff outline
III

Action

EXECUTE
Human
Owns the merge gate. Reads the PR, asks the awkward questions.
AI
Writes the change, runs tests, opens the PR, self-reviews against spec.
Signed Merged PR + green CI
IV

Feedback

REVIEW
Human
Decides whether intent was met, whether to widen autonomy, where to clamp it.
AI
Logs telemetry, drafts AAR, surfaces drift against approved spec.
Signed Signed AAR + GTR delta

// The loop turns only when the signature is in place. No signature, no turn.

expanded view · 020 is the atom

Compositions / process flows

Full-bleed expanded IRAF loop — four large pillar-coloured stages arranged in a circle with annotated arrows. Each stage names what humans do, what AI does, and what gets signed at the handoff.

open ↗
№ 107

Spec Lifecycle

Scene STA
Spec Lifecycle 6 stages · 6 gates

From paragraph
to production.

A spec moves through six named stages. Each stage names its artefact, its owner, and the ICS gate that lets the baton continue.

  1. 01

    Draft

    Artefact
    spec.md
    Owner
    Author
    ICS ≥ 40
  2. 02

    Review

    Artefact
    spec.md + diff
    Owner
    Author + peer
    ICS ≥ 60
  3. 03

    Approved

    Artefact
    spec @ v1.0
    Owner
    Architect
    Sign-off
  4. 04

    Composed

    Artefact
    PR + tests
    Owner
    Composer
    CI green
  5. 05

    Demonstrated

    Artefact
    Demo + telemetry
    Owner
    Gatekeeper
    AC met
  6. 06

    Governed

    Artefact
    AAR + GTR delta
    Owner
    Governor
    No drift

// No gate skipped. The baton waits at every threshold.

ics gates · always closed by default

Compositions / process flows

Horizontal six-stage flow of a DoCoDeGo specification — DRAFT → REVIEW → APPROVED → COMPOSED → DEMONSTRATED → GOVERNED — with the artefact, owner, and ICS gate at every stage, and an animated baton handing across the chain.

open ↗
№ 108

Maturity Journey

Scene STA
Maturity Journey 4 stages · each builds on the last

You don't adopt DoCoDeGo.
You climb it.

Every stage adds one capability. No stage is skipped — and no team is "behind" for sitting on a rung that fits them.

Current stage
2 / 4
  1. STAGE 1 ✓ Done

    Augmented

    Any team, any size

    What's added

    DO + CO: spec-first, AI-assisted. Manual review.

  2. STAGE 2 ◉ Here

    Collaborative

    Growing team, shipping regularly

    What's added

    + DE: validation-gated delivery, observability

    You are here
  3. STAGE 3 ○ Ahead

    Orchestrated

    Multi-agent, multi-team

    What's added

    + GO: alignment checks, scope limits, agent monitoring

  4. STAGE 4 ○ Ahead

    Autonomous

    Autonomous agent systems

    What's added

    Full GO: confidence thresholds, audit trails, kill switches

// Each rung adds a pillar. Stage 1 is DO + CO. Stage 4 is full GO.

data · src/shared/data/pillars.ts

Compositions / process flows

A horizontal walk through the four DoCoDeGo maturity stages — Augmented, Collaborative, Orchestrated, Autonomous — with what gets added at each step up, a current-stage marker, and a path that visibly thickens as the team climbs.

open ↗
№ 109

Governance Loop

Scene STA
Governance Loop continuous · never closes

Approval expires.
The loop does not.

Sign-off grants autonomy under a ceiling. Drift detection compares behaviour to intent. When drift crosses the threshold, the loop returns to re-sign — narrower, wider, or revoked.

I

Sign-off

Trigger
New spec or revised intent
Artefact
Approval record + scope
II

Autonomy ceiling

Trigger
Agent operating in scope
Artefact
Confidence + budget limits
Governance · continuous
III

Drift detection

Trigger
Telemetry vs intent diff
Artefact
Drift report + severity
IV

Re-sign-off

Trigger
Drift over threshold
Artefact
Renewed approval or revoke

// Trust is not a flag set once. It is a loop that re-signs.

drift threshold · team-tunable

Compositions / process flows

A closed continuous cycle — sign-off → autonomy ceiling → drift detection → re-sign-off — with an animated tracer arc showing the loop is never finished, only re-signed.

open ↗
№ 110

AI Compose Cycle

Scene STA
Agent Trace approved spec → shipped PR

Six steps. Six signatures.
One PR.

Each named agent runs one operation, leaves one artefact, and hands the baton to the next. Total wall-clock from approved spec to merged change: ten to fifteen minutes — most of it spent waiting on the human review.

Total budget
~12 min
  1. 01

    Read spec

    Duration
    ~30s
    Agent
    reader-1.2
    Output
    Parsed intent + constraints
  2. 02

    Reason

    Duration
    ~2m
    Agent
    planner-4.7
    Output
    Plan + file diff outline
  3. 03

    Produce PR

    Duration
    ~6m
    Agent
    composer-4.7
    Output
    Branch + commits + PR
  4. 04

    Self-check

    Duration
    ~1m
    Agent
    checker-1.0
    Output
    CI green + ICS ≥ 75
  5. 05

    Human review

    Duration
    human
    Agent
    Gatekeeper
    Output
    Approve / request changes
  6. 06

    Ship

    Duration
    ~1m
    Agent
    shipper-1.0
    Output
    Merged + deployed + AAR
    ✓ Shipped

// Five agents do machine work in ~10 minutes. One human spends the time that matters: the review.

trace-id · sample-run

Compositions / process flows

Step-by-step trace of what an AI agent does given an approved spec — read, reason, produce PR, self-check, request review, ship — each step annotated with duration estimate and agent identity.

open ↗
№ 1121

Red Green Refactor Flow

Scene STA co
Red Green Refactor 4 phases · permanent loop

Fail first.
Pass minimally.
Shape it. Repeat.

The TDD loop is not a ceremony — it is the only honest way to prove a spec has teeth. Each phase has one job, one verb, one ledger state.

  1. 01

    Red

    Intent
    Write a failing test
    Verb
    add spec
    1 failing · 0 passing
  2. 02

    Green

    Intent
    Make it pass — minimum
    Verb
    add impl
    0 failing · 1 passing
  3. 03

    Refactor

    Intent
    Clean up without breaking
    Verb
    shape code
    0 failing · 1 passing
  4. 04

    Repeat

    Intent
    Next failing test
    Verb
    loop back
    queue +1

// The loop never closes. It just gets sharper.

tdd · red ⇒ green ⇒ refactor ⇒ red

Compositions / process flows

Full Red-Green-Refactor loop rendered as a four-phase strip — failing test, minimal pass, refactor, repeat — with the test ledger and the code shape at each phase.

open ↗
№ 1122

Spec Grilling Flow

Scene STA do
Spec Grilling three acts · adversarial

Specs survive
by being attacked.

Pre · author readies. During · reviewers attack. After · author rewrites. The grilling is the work — the spec is the residue.

  1. 01

    Pre

    Setup

    Author submits the spec cold

    Questions

    • Is the intent one sentence?
    • Are AC binary?
    • Is the failure mode named?
    spec.md @ draft
  2. 02

    During

    Setup

    Reviewers attack every claim

    Questions

    • What does it not do?
    • How will it fail?
    • Who pays the cost?
    spec.md + annotated diff
  3. 03

    After

    Setup

    Author revises and re-submits

    Questions

    • Was every question answered?
    • Did AC narrow?
    • Did scope shrink?
    spec.md @ v1.0 + AAR

// No question is too cruel for a draft to face.

ics gate · 60+ to ship

Compositions / process flows

Three-act process of spec grilling — pre, during, after — with the interrogation questions, the artefacts produced, and the score delta gating progression.

open ↗
№ 1123

Plan Approval Flow

Scene STA go
Plan Approval 4 steps · 1 return loop

Plans don't pass.
They get re-passed.

Submit. Review. Revise. Approve. The loop between review and revise is the work — sign-off is just the bookmark that says the loop has stopped for now.

  1. 01

    Submit

    Actor
    Author
    Artefact
    plan.md @ draft
    Plan complete
  2. 02

    Review

    Actor
    Reviewers
    Artefact
    plan.md + notes
    Pass or return
  3. 03

    Revise

    Actor
    Author
    Artefact
    plan.md @ rN
    Address every note
  4. 04

    Approve

    Actor
    Governor
    Artefact
    plan @ v1.0 + sig
    Sign-off recorded

// Approval is not a destination. It is a bookmark.

return loop · normal, not punitive

Compositions / process flows

Four-step approval chain — submit, review, revise, approve — with revision return-loop arrow and per-step decision artefact.

open ↗
№ 1124

Drift Routing Flow

Scene STA de
Drift Routing detect · classify · route

Drift is data,
not disaster.

Detect the delta. Classify by shape. Route to the queue that can act. Every drift has a destination — none gets lost.

  1. 01

    Detection

    Observed delta

    spec.AC#4 → expected: idempotent
    impl.observed: side-effect on retry
    drift-report.json
  2. 02

    Classification

    • Cosmetic

      no behaviour change

    • Semantic

      AC moved, spec stale

    • Structural

      failure mode unprovable

    severity tag
  3. 03

    Routing

    • Auto-fix

      Composer · if cosmetic

    • Human review

      Reviewer · if semantic

    • Block

      Governor · if structural

    queue write

// Every drift has a destination. None gets lost.

de · drift routing

Compositions / process flows

Drift handling as a detection-classification-routing strip — what was seen, how it was tagged, which queue it was routed to.

open ↗
№ 1125

Brownfield Archaeology Flow

Scene STA do
Brownfield Archaeology dig · write · characterise

The code is the artefact.
The intent is buried.

Find what the system does. Write the spec it should have had. Name the gap between the two. That gap is the backlog.

  1. 01

    Find the code

    • Trace entry points
    • Walk call graph by usage
    • Read tests as oracles
    inventory.csv
  2. 02

    Write the spec

    Spec scaffold

    ## Intent
    What the code is for.
    
    ## AC
    - [ ] Observed behaviour 1
    - [ ] Observed behaviour 2
    
    ## Constraints
    - Inherited from system
    spec.md @ retro
  3. 03

    Characterise gaps

    • Undocumented

      no spec yet

      14
    • Contradicted

      spec disagrees with code

      3
    • Orphan

      code without intent

      6
    gap-report.md

// You don't refactor without a spec. You write the spec first.

do · retro spec capture

Compositions / process flows

Brownfield rescue as a three-act dig — find the code, write the spec it should have had, characterise the gap.

open ↗
№ 1126

Convention Extraction Flow

Scene STA co
Convention Extraction pattern · candidate · review · promote

Habits become rules
only on purpose.

A pattern is just repetition. A convention is repetition reviewed and signed off. The pipeline makes the difference deliberate.

  1. 01

    Pattern

    Artefact
    observation log
    Exit
    ≥3 recurrences
    step 01
  2. 02

    Candidate

    Artefact
    convention draft
    Exit
    AC + rationale
    step 02
  3. 03

    Review

    Artefact
    review notes
    Exit
    pass or kill
    step 03
  4. 04

    Promote

    Artefact
    convention @ v1.0
    Exit
    in canon · indexed
    step 04

// Most candidates get killed. That is the point.

co ⇒ go · habit ⇒ canon

Compositions / process flows

Four-step pipeline that turns a recurring pattern into a promoted convention — pattern, candidate, review, promote.

open ↗
№ 1127

Release Gate Flow

Scene STA go
Release Gates 4 gates · all closed by default

A gate is evidence,
not a checkbox.

Build produces the binary. Audit produces the report. Sign-off produces the signatures. Deploy produces the rollout. Skip a gate, lose the chain.

  1. 01

    Build

    Artefact
    binary + sbom
    Criterion
    reproducible · signed
    Composer
  2. 02

    Audit

    Artefact
    audit report
    Criterion
    no critical findings
    Auditor
  3. 03

    Sign-off

    Artefact
    release manifest
    Criterion
    two-key sign
    Governor
  4. 04

    Deploy

    Artefact
    live release
    Criterion
    rollback ready
    Operator

// Gates close by default. Evidence opens them.

go · release chain

Compositions / process flows

Four-gate release pipeline — build, audit, sign-off, deploy — each gate carrying the artefact under inspection and the pass criterion.

open ↗
№ 1128

Spec Lifecycle Flow

Scene STA do
Spec Lifecycle 4 stages · versioned · aged

Specs are born, lived,
and retired.

Draft is cheap. Review is honest. Impl is expensive. Archive is real. Every stage stamps a version and waits for its exit condition.

  1. 01

    Draft

    Version
    v0.x
    Age
    0-14d
    ICS ≥ 40
  2. 02

    Review

    Version
    v0.x
    Age
    1-7d
    ICS ≥ 60 · sign
  3. 03

    Impl

    Version
    v1.x
    Age
    2-12w
    AC met · GTR clear
  4. 04

    Archive

    Version
    v∞
    Age
    forever
    superseded or retired

// A spec that never archives is a spec that never finished.

do · versioned

Compositions / process flows

Four-stage compact spec lifecycle — draft, review, impl, archive — with the version stamp, age, and exit condition for each stage.

open ↗
№ 1129

Composition Pipeline Flow

Scene STA co
Composition Pipeline plan · execute · review

AI proposes.
AI executes.
Human signs.

The agent plans steps from the spec, runs them under a budgeted sandbox, and presents a diff. Human authority lives at one gate — review.

  1. 01

    Plan

    Input
    spec.md @ approved
    Action
    propose steps + budget
    Artefact
    plan.json
    budget · 5 min
  2. 02

    Execute

    Input
    plan.json
    Action
    compose under sandbox
    Artefact
    PR + diff
    budget · 30 min
  3. 03

    Review

    Input
    PR + diff
    Action
    AC check + sign-off
    Artefact
    merge or kill
    budget · 15 min

// The signature is the only step the agent cannot take.

co · ai labour · human authority

Compositions / process flows

AI composition pipeline as a three-phase strip — plan, execute, review — with the inputs, the agent action, and the artefact at each step.

open ↗
№ 1130

Governance Action Flow

Scene STA go
Governance Action anomaly · review · action · audit

Action without audit
did not happen.

Telemetry surfaces an anomaly. Review judges severity. Action chooses a response. Audit binds the decision to the record. Skip the audit step and the chain breaks.

  1. 01

    Anomaly

    Input
    telemetry signal
    Decision
    is it real?
    anomaly ticket
  2. 02

    Review

    Input
    anomaly ticket
    Decision
    severity + ownership
    review note
  3. 03

    Action

    Input
    review note
    Decision
    fix · throttle · revoke
    change record
  4. 04

    Audit

    Input
    change record
    Decision
    sign + retain
    audit-log.jsonl

// The log is the only memory the system has of itself.

go · single-signal response

Compositions / process flows

Four-step governance response chain — anomaly, review, action, audit — turning a single signal into a recorded decision.

open ↗
№ 1131

Continuous Convergence Flow

Scene STA de
Continuous Convergence 4 beats · permanent loop

Small batches.
Permanent loop.

Observe. Compare. Adjust. Redeploy. The cycle never closes — it just keeps catching the next delta before it becomes a disaster.

  1. 01

    Observe

    Action
    collect signals
    Artefact
    telemetry slice
    continuous
  2. 02

    Compare

    Action
    diff vs intent
    Artefact
    delta report
    < 5 min
  3. 03

    Adjust

    Action
    small patch · small risk
    Artefact
    PR · scoped
    < 1 day
  4. 04

    Redeploy

    Action
    ship + watch
    Artefact
    release · v+1
    < 1 hour

// Convergence is not a state. It is a pulse.

de · permanent beat

Compositions / process flows

Continuous convergence as a permanent four-beat loop — observe, compare, adjust, redeploy — with cycle-time stamp and a looping baton.

open ↗
Alpha · Honest about it

The framework is real.
The community is forming now.

DoCoDeGo is in Alpha. The framework is documented, the practices are battle-tested at small scale, and the next release is being shaped in public.

If it produces anything, it should produce engineers and teams who think more clearly about what they are building and why.

Two doors in
Join the Discord

Discord is where specs are debated, the framework gets sharper, and decisions land in writing. The conversation is the artefact.