Governed delivery · executable evidence · institutional learning

The SDLC as a learning flywheel.

A continuous operating model that connects signals, evidence, RFCs, accountable architectural decisions, living design, production readiness, runtime conformance, and durable organizational memory.

Primary system view

Evidence → decision → delivery → learning

Each stage has an explicit decision question, artifact role, and exit condition. Backward movement is expected whenever evidence invalidates an assumption, design, or implementation.

12 stages 2-speed governance 4 persistent rails
Evidence-driven SDLC flywheel Twelve connected stages move clockwise from Sense through Evolve. Each stage links to detailed guidance below. SDLC FLYWHEEL Evidence Decision Delivery Every release improves the next decision. 1 Sense · Signalrecord 2 Frame · Brief or RFD 3 Interrogate ·Evidence package 4 Propose · RFC 5 Decide · ADD 6 Remember · ADR 7 Shape · SystemDesign 8 Build ·Implementation 9 Prove · Eval +conformance 10 Release · ORR 11 Operate · Runtimeevidence 12 Evolve · Learningreview

Decision-artifact chain

Separate exploration, proposal, decision, memory, and current truth.

The chain prevents one document from becoming an overloaded substitute for research, approval, architecture, implementation, and operations.

RFD

Explore whether the idea is worth developing.

Evidence

Make claims, uncertainty, prototypes, and invalidation conditions visible.

RFC

Present a substantial proposal for cross-functional review.

ADD

Make the accountable architectural choice.

ADR

Preserve the decision, rationale, constraints, and consequences.

System Design

Maintain the living implementation truth.

Critical distinction: the ADD is the decision event. The ADR is the durable record of that decision. The System Design is the living description of how the system works now.

Stage reference

Twelve stages with explicit evidence and exit conditions.

Each stage can send work backward. Rework is routed to the failed assumption, decision, design, implementation, or operating model instead of being hidden inside delivery.

Detect material signals

Sense

Signal record

Is there a material signal worth investigating?

Capture customer, operational, security, accessibility, policy, and platform signals before they are translated into solution requests.

Artifacts and exit condition

Artifacts

  • Signal record
  • Problem intake
  • Incident record
  • Craft-debt entry
  • Evidence-debt entry

Exit condition

A grounded observation with source, impact, owner, and enough materiality to justify framing.

Define the decision

Frame

Brief or RFD

What outcome or decision are we trying to reach?

Establish purpose, audience, scope, constraints, assumptions, uncertainty, reversibility, and success criteria.

Artifacts and exit condition

Artifacts

  • Brief
  • RFD — Request for Discussion
  • Material-ambiguity gate
  • Initial risk classification

Exit condition

A clear decision boundary and an explicit plan for resolving material uncertainty.

Challenge assumptions

Interrogate

Evidence package

Are the problem model and candidate directions supported by evidence?

Use research, co-design, accessibility participation, threat modeling, representative data, and interrogation prototypes to expose weak assumptions.

Artifacts and exit condition

Artifacts

  • Evidence package
  • Interrogation prototype
  • Threat model
  • Accessibility study
  • Experiment plan
  • Evaluation dataset

Exit condition

Known facts, assumptions, alternatives, invalidation conditions, and remaining uncertainty are visible.

Make the case

Propose

RFC

Should the organization adopt this substantial proposal?

Present the recommended approach, evidence, alternatives, trade-offs, migration, rollback, operational model, and required reviewers.

Artifacts and exit condition

Artifacts

  • RFC — Request for Comments
  • Reviewer matrix
  • Material dissent record
  • Decision-readiness summary

Exit condition

The proposal is decision-ready, with material feedback resolved or explicitly preserved.

Commit with accountability

Decide

ADD

Which option are we committing to, under which constraints?

The accountable decision owner selects an option, defines guardrails, records rejected alternatives, and names reconsideration triggers.

Artifacts and exit condition

Artifacts

  • ADD — Architectural Design Decision
  • Decision owner
  • Guardrails
  • Reconsideration triggers

Exit condition

A named, accountable choice exists. Approval ambiguity is removed.

Preserve the rationale

Remember

ADR

How do we preserve what was decided and why?

Create an immutable decision record that captures context, rationale, consequences, evidence boundary, risks, controls, and supersession links.

Artifacts and exit condition

Artifacts

  • ADR — Architecture Decision Record
  • Evidence boundary
  • Consequences
  • Supersession metadata

Exit condition

The decision can be understood later without reconstructing the original discussion.

Define executable truth

Shape

System Design

How will the accepted decision work as a complete system?

Translate the decision into living architecture, versioned contracts, behavioral modes, accessibility requirements, operational design, and an evaluation plan.

Artifacts and exit condition

Artifacts

  • System Design
  • API/event/tool contracts
  • Threat model
  • Accessibility contract
  • Evaluation plan
  • Migration and rollback design

Exit condition

The system is coherent, implementable, testable, operable, and traceable to the decision.

Implement with traceability

Build

Implementation

Are we building the accepted design with operational completeness?

Deliver thin vertical increments while keeping requirements, contracts, tests, telemetry, runbooks, and artifact-quality memory connected.

Artifacts and exit condition

Artifacts

  • Implementation plan
  • Code and infrastructure
  • Automated tests
  • Runbooks
  • Migration tooling
  • Traceability map

Exit condition

A production candidate exists with executable controls, tests, documentation, and ownership.

Validate in the real medium

Prove

Eval + conformance

Does the implementation satisfy the accepted decision under realistic conditions?

Validate Utility, Usability, Feel, and Trust alongside security, accessibility, resilience, contract, policy, performance, and AI evaluations.

Artifacts and exit condition

Artifacts

  • Evaluation report
  • Conformance report
  • Accessibility validation
  • Security and resilience evidence
  • ORR draft

Exit condition

Evidence demonstrates readiness, or failures route back to the correct stage.

Accept production responsibility

Release

ORR

Is the system ready to operate safely and reversibly?

Complete the Operational Readiness Review, release manifest, migration, communication, support, rollback, and bounded exception records.

Artifacts and exit condition

Artifacts

  • ORR — Operational Readiness Review
  • Release manifest
  • Migration guide
  • Change communication
  • Known-issues register
  • Waivers

Exit condition

Production ownership, observability, support, recovery, and risk acceptance are explicit.

Observe actual behavior

Operate

Runtime evidence

Does the running system still conform to decisions and commitments?

Use SLOs, telemetry, policy logs, incidents, support feedback, cost, accessibility, model quality, and conformance checks as production evidence.

Artifacts and exit condition

Artifacts

  • Service catalog record
  • SLOs and dashboards
  • Runbooks
  • Policy decision log
  • Incident record
  • Conformance report
  • Expiring waiver

Exit condition

Operational evidence is visible and deviations have an explicit disposition.

Institutionalize learning

Evolve

Learning review

What should be repaired, standardized, or reconsidered?

Convert operating evidence into battle scars, regression fixtures, revised skills, craft-debt remediation, new RFCs, and superseding ADRs.

Artifacts and exit condition

Artifacts

  • Learning Review
  • Postmortem
  • Craft-debt ledger
  • Battle scars
  • Regression fixtures
  • Superseding RFC/ADR

Exit condition

The product and the organization are measurably better prepared for the next cycle.

Two-speed governance

Escalate by materiality, not by visibility.

The full artifact chain is reserved for consequential changes. Routine work stays lightweight. Experiments remain bounded until evidence justifies production authority.

Routine

Low-risk and reversible

Established patterns, localized impact, and no material identity, rights, security, or compatibility consequences.

Signal → Brief → Design or contract change → Build → Standard validation → Release → Observe

Governed

Material and difficult to reverse

Platform, cross-team, identity-sensitive, rights-sensitive, public, regulated, autonomous, or contract-breaking change.

Signal → RFD → Evidence → RFC → ADD → ADR → System Design → Build → ORR → Release → Learning Review

Experimental

Bounded learning

Prototype authority is deliberately constrained. Production adoption requires an explicit transition into the governed route.

Signal → RFD → Experiment charter → Bounded prototype → Evaluation report → Stop | Iterate | RFC

Persistent rails

The flywheel runs on shared evidence, decisions, quality memory, and provenance.

Evidence ledger

Facts, observations, assumptions, inferences, uncertainty, contradictory evidence, freshness, and source lineage.

Decision ledger

Owners, commitments, constraints, dissent, review dates, waivers, dependencies, and supersession history.

Quality memory

Artifact profiles, battle scars, craft debt, failed fixtures, repeated corrections, and validated reusable patterns.

Provenance ledger

Source versions, build identity, generator version, validations, approvals, evidence boundaries, and released artifacts.

Shared quality language

Utility, usability, feel, and trust.

UtilityShould this exist, and is the problem worth solving?
UsabilityCan intended audiences succeed, recover, and operate accessibly?
FeelDoes the experience appear coherent, deliberate, and contextually appropriate?
TrustCan people safely rely on the evidence, controls, provenance, and accountability?

Systems of record

Human reasoning and executable truth remain linked.

Confluence preserves organizational context and decisions. Repositories preserve versioned, executable contracts and implementation truth.

System Primary responsibility Representative artifacts
Confluence Human lifecycle, review, decision history, ownership, and governance record. RFDs, RFCs, ADR indexes, ORRs, waivers, learning reviews, review history.
Repository Executable and versioned system truth close to implementation. System Design, API/event/tool contracts, eval definitions, policy-as-code, tests, infrastructure, release manifests.
Operational platform Runtime state and production evidence. SLOs, dashboards, traces, policy decisions, cost, incidents, deployment status, conformance findings.
Quality memory Cross-artifact learning and prevention of repeated failure. Battle scars, craft debt, accessibility findings, regression fixtures, validated patterns.

Canonical formulation

Every release should improve the product and the organization’s ability to make the next decision.

Sense a material signal. Frame it through a Brief or RFD. Interrogate assumptions. Propose through an RFC. Make the accountable ADD. Preserve it in an ADR. Shape living System Design and versioned contracts. Build with traceability. Prove in the real medium. Establish production responsibility through the ORR. Operate with visible conformance. Evolve through learning reviews, postmortems, and superseding decisions.