psychology

chevp-ai-framework

Lifecycle Gates Guidelines Commands Agents Templates
verified Quality Gates

G1 · G2 · G3

Three checkpoints — one between each step. Gates are blockers.

No forward movement until every criterion is satisfied.

The Three Gates

Each gate gates a specific transition

G1
Context → Exploration

Foundation in place. Problem understood. Architecture documented.

See Context step arrow_forward
G2
Exploration → Production

Plan approved. Prototype confirmed. Challenger output recorded.

See Exploration step arrow_forward
G3
Production → Done

Code ships. Acceptance criteria met. Insights recorded.

See Production step arrow_forward

Evidence-Based Gates

Approval requires evidence — not a rubber-stamp

Every gate transition records three explicit fields in the plan's frontmatter evidence: block:

evidence: hypothesis: "We believed X would work because Y" result: "Prototype confirmed/refuted X via Z" reasoning: "Therefore we are/are not proceeding"

A blank or boilerplate evidence block is a gate failure. The Gatekeeper subagents (gatekeeper-g1/g2/g3) refuse to issue a pass verdict if the block is empty or generic.

info Three rules: hypothesis names something the team could be wrong about · result is observable, not opinion · reasoning bridges to one of: proceed, fall back, kill.

G1 Criteria

Context → Exploration

check_circleContext-Plan confirmed
check_circleUncertainty triplet drafted (Problem Statement, Hypotheses, Risks)
check_circleSystem Spec exists
check_circleArchitecture documented
check_circleFundamental ADRs written
check_circleExisting artifacts catalogued
check_circleScope confirmed by human
check_circleEvidence block filled
check_circleGatekeeper-G1 verdict recorded
check_circleCross-platform: targets declared, PAL boundary identified, asset format strategy

G2 Criteria

Exploration → Production

check_circleFeature plan/spec approved with exploration-mode: A | B
check_circlePrototype visually confirmed (where applicable)
check_circleAcceptance criteria defined
check_circleKill Criteria defined
check_circleinsights.md exists
check_circleChallenger output present (top-3 failures, ≥2 alternatives, counter-argument)
check_circleEvidence block filled
check_circleGatekeeper-G2 verdict recorded
check_circleHuman approved
check_circleCross-platform: plan covers all declared targets, no single-platform design

G3 Criteria

Production → Done

check_circleProduction-Plan approved before implementation
check_circleAll acceptance criteria fulfilled
check_circleBuild passes
check_circleNo regressions
check_circleDocumentation updated
check_circleinsights.md updated with implementation surprises
check_circleGatekeeper-G3 verdict recorded
check_circleHuman approved
check_circleCross-platform: build passes on all declared targets, no platform-specific code outside PAL

Gatekeeper Subagents

Specialised gate validators — mechanically check criteria, spawn proposals for out-of-scope items

gatekeeper-g1

Context gate

Validates uncertainty triplet, scope confirmation, evidence block.

gatekeeper-g2

Exploration gate

Validates plan approval, Challenger output, Kill Criteria, insights.md.

gatekeeper-g3

Production gate

Validates acceptance criteria, build success, documentation updates.

Read more about agents →

Out-of-Scope → Proposals

Items raised at a gate become PROP-NNN proposals — never disappear into prose

When the Gatekeeper or the Challenger surfaces something that should be out of scope, it must be filed as a numbered proposal. Proposals are the framework's memory — nothing valuable is lost between gates, even when we choose not to act on it now.

Each proposal has a clickable triage decision: /promote · /defer · /reject.

menu_book

Read the source

LIFECYCLE.md · Quality Gates open_in_new