Follow an issue to main

Workflow walkthrough

Follow an issue to main.

One issue moves through seeded atomic workflows: research, proposal, graph generation, contracts, code work, integration and retrospective evidence. Scroll the line, and click any node to read its declaration.

APPROACH RESEARCH APPROACH PROPOSAL EXECUTION GRAPH EXECUTION CONTRACTS CONTRACT EXECUTION CODE INTEGRATION RETROSPECTIVE

Workflow 1 of 7

Research fans out into assessor lenses.

The seed authors a research artifact, runs interface accuracy, boundary fit, risk aggregate and test coverage assessors in parallel, collates findings, then routes completed, revise or exhausted.

Author skill workflows/approach-research/author

Policy codex_cli · gpt-5.5 · medium

Revise budget maxIterations 5

Accepted output RESEARCH ARTIFACT

Source: approachResearch.json

Workflow 2 of 7

Proposal work includes decisions and owner-backed review.

The proposal seed prepares decisions, waits for ratification, authors the proposal artifact, evaluates readiness and routes the final review through Product Inbox, Approvals and Progression.

Author skill workflows/approach-proposal/author

Reviews decision ratification · artifact approval

Revise budget maxIterations 5

Accepted output ACCEPTED PROPOSAL

Source: approachProposal.json

Workflow 3 of 7

The accepted approach compiles into FLOW.

Graph generation emits a WorkflowDefinitionVersion, graph index and node specs, then checks declaration coverage, boundary fit and contract readiness before handoff.

Author skill workflows/execution-graph/generate

Emits WorkflowDefinitionVersion · graph index · node specs

Revise budget maxIterations 3

Accepted output WORKFLOW DEFINITION

Source: executionGraph.json

Workflow 4 of 7

Contracts traverse graph nodes dependency-first.

The parent seed derives node contract subjects, runs dependency-aware node-contract subworkflows, collates the child results and accepts only when all node contracts are accepted.

Derive skill workflows/execution-contracts/derive-node-contract-subjects

Child workflow generate-node-contract per graph node

Child output nodeContractExecutionResultRef

Accepted output FINAL CONTRACTS

Source: executionContracts.json

Workflow 5 of 7

Code work follows graph and contract fences.

The generated graph runs against finalized contracts. Node work may parallelize only when graph dependencies, contract dependencies and write scopes allow it.

Definition generated per issue

Fences graph deps · contract deps · write scopes

Accepted output PATCH EVIDENCE

Workflow 6 of 7

Integration consumes evidence and conformance refs.

Integration receives the patch, evidence bundle and conformance refs, then decides merge-ready, merged, blocked or revise.

Consumes patch · evidence bundle · conformance refs

Routes merge-ready · merged · blocked · revise

Accepted output INTEGRATION REPORT

Workflow 7 of 7

Retrospective is another artifact loop.

The seed authors a retrospective record, evaluates signal quality, miss classification, guardrails, evidence grounding and actionability, then collates findings.

Author skill workflows/retrospective/author-record

Assessor lenses signal · miss · guardrail · grounding · actionability

Revise budget maxIterations 5

Accepted output IMPROVEMENT EVIDENCE

Source: retrospective.json

APPROACH RESEARCH · node config

The research author, as declared

Skill workflows/approach-research/author

Execution policy codex_cli · gpt-5.5 · medium

Runtime workflowDriverRuntime

Tool access nucleus_findings_read v1

Source: approachResearch.json

← Back to workflow

APPROACH RESEARCH · node config

Four assessor lenses in parallel

Lenses interface accuracy · boundary fit · risk aggregate · test coverage

Execution policy every assessor pins codex_cli · gpt-5.5 · medium

Hand-off findings collate before the branch

Source: approachResearch.json

← Back to workflow

APPROACH RESEARCH · node config

Deterministic branch, bounded revise

Branch keys ship · revise · exhausted

Revision strategy maxIterations 5 · retryUntilSatisfied

Exhaustion routes to the exhausted terminal

Source: approachResearch.json

← Back to workflow

APPROACH PROPOSAL · node config

The proposal author, as declared

Skill workflows/approach-proposal/author

Execution policy codex_cli · gpt-5.5 · medium

Decision before authoring Wait for decision ratification

Source: approachProposal.json

← Back to workflow

APPROACH PROPOSAL · node config

Readiness check, then owner-backed review

Readiness check fail routes to revise

Artifact review Wait for the declared approval response

Revise budget maxIterations 5

Source: approachProposal.json

← Back to workflow

APPROACH PROPOSAL · node config

Resolution routes the proposal

Resolution keys accept · revision-required

Revise budget maxIterations 5

Accepted output the ratified proposal

Source: approachProposal.json

← Back to workflow

EXECUTION GRAPH · node config

The graph generator, as declared

Skill workflows/execution-graph/generate

Execution policy codex_cli · gpt-5.5 · medium

Emits WorkflowDefinitionVersion · graph index · node specs

Source: executionGraph.json

← Back to workflow

EXECUTION GRAPH · node config

Structural checks on the graph

Checks declaration coverage · boundary fit · contract readiness

Execution policy every assessor pins codex_cli · gpt-5.5 · medium

Source: executionGraph.json

← Back to workflow

EXECUTION GRAPH · node config

A findings loop with a tighter budget

Revision strategy maxIterations 3

Findings route back to the generator

Accepted the definition hands off to contracts

Source: executionGraph.json

← Back to workflow

EXECUTION CONTRACTS · node config

The subject deriver, as declared

Skill workflows/execution-contracts/derive-node-contract-subjects

Execution policy codex_cli · gpt-5.5 · medium

Derives one contract subject per graph node

Source: executionContracts.json

← Back to workflow

EXECUTION CONTRACTS · node config

A child workflow per graph node

Child workflow generate-node-contract

Traversal dependency-first across the graph

Child output nodeContractExecutionResultRef

Source: executionContracts.json

← Back to workflow

EXECUTION CONTRACTS · node config

All node contracts must accept

Acceptance every node contract accepted

Child findings route back to revise

Source: executionContracts.json

← Back to workflow

CONTRACT EXECUTION · node config

Code work inside the fences

Definition generated per issue, not seeded

Fences graph deps · contract deps · write scopes

Parallelism only where all three fences allow

← Back to workflow

CONTRACT EXECUTION · node config

Evidence checks on the patch

Checks tests · standards · evidence · conformance

← Back to workflow

CONTRACT EXECUTION · node config

Patch, findings or stop

Routes findings · patch · stop

← Back to workflow

CODE INTEGRATION · node config

Integration consumes the evidence

Consumes patch · evidence bundle · conformance refs

← Back to workflow

CODE INTEGRATION · node config

Merge checks before authority

Checks merge readiness · evidence · authority · risk

← Back to workflow

CODE INTEGRATION · node config

Four integration routes

Routes merge-ready · merged · blocked · revise

← Back to workflow

RETROSPECTIVE · node config

The retrospective author, as declared

Skill workflows/retrospective/author-record

Execution policy codex_cli · gpt-5.5 · medium

Source: retrospective.json

← Back to workflow

RETROSPECTIVE · node config

Five lenses on the run itself

Lenses signal quality · miss classification · guardrail quality · evidence grounding · actionability

Execution policy every assessor pins codex_cli · gpt-5.5 · medium

Source: retrospective.json

← Back to workflow

RETROSPECTIVE · node config

Completed, revise or exhausted

Branch keys completed · revise · exhausted

Revision strategy maxIterations 5

Source: retrospective.json

← Back to workflow

Scroll to advance · click any node for its config