Phase Checklist

Status: Permanent
Applies to: Every baseline freeze
Executor: ChatGPT Desktop (Architect) validates · Developer executes Git/backup steps
Canonical reference: AI_DEVELOPMENT_ENVIRONMENT.md

---

Purpose

Permanent checklist before every repository baseline. Every item must be explicitly confirmed before commit, tag, or push.

---

Pre-Phase Checklist

Baseline (Idea → Architecture entry)

• [ ] Baseline Verification — Latest release doc, Git tag, commit, previous baseline, current phase, frozen platforms, working tree per DEVELOPMENT_WORKFLOW.md
• [ ] Written baseline confirmation — Architect stated verified tag, commit (or pending), and phase before Specification or implementation

---

Pre-Baseline Checklist

Architecture

• [ ] Architecture Approved — Phase design reviewed against PROJECT_CONSTITUTION.md and MODULE_BOUNDARIES.md
• [ ] Specification Approved — Architecture Specification accepted before Prompt Design
• [ ] Frozen boundaries respected — No modifications to prior frozen platform modules
• [ ] Contract-first confirmed — One public contract per platform module
• [ ] Registry ownership confirmed — Metadata in registries; engines consume registries only
• [ ] Preview-safe confirmed — persisted: false, no forbidden side effects (if applicable)

---

Implementation

• [ ] Runtime Implementation Complete — All phase requirements delivered via Runtime Adapter (Adapter v1: Cursor Agent or Codex)
• [ ] Hardening Complete — Type abstractions and architecture guards (if required)
• [ ] Scope boundary verified — Only approved files changed
• [ ] Architect Context policy followed — Live Context, Uploaded Context, Visual/Text Context per CONTEXT_FILE_POLICY.md
• [ ] Runtime Implementation Context followed — @files / folder scope per Architect prompt
• [ ] Autonomous output reviewed — If autonomous agent used (Adapter v1: Codex), Developer reviewed diff before Architect review

---

Testing

• [ ] Tests Passed — All phase unit, feature, and architecture tests green
• [ ] Test commands recorded — Exact php artisan test commands in implementation report
• [ ] Regression spot check — Frozen platform diff empty for protected paths
• [ ] Governance integrity — GovernanceDocumentationTest passes (if governance in scope)

---

Review

• [ ] Architecture Review — Architect reviewed implementation report (loop exited with Decision: Approved)
• [ ] Remaining Risks — Documented; pre-existing issues labeled
• [ ] Freeze Review — Architect approved freeze sequence

---

Documentation

• [ ] Release Document — docs/releases/{version}.md created or updated
• [ ] Tag name confirmed — Matches release doc header
• [ ] Commit placeholder — TBD until commit; hash updated after
• [ ] Prior baseline chain — Documented in release header
• [ ] Frozen platforms table — All consumed platforms listed with tags
• [ ] Next phase declared — “Phase {N+1} not started” in release doc

---

Execution (Developer — on Architect instruction only)

• [ ] Backup — Local zip per BACKUP_POLICY.md (if instructed)

---

Git Freeze Checklist

See GIT_FREEZE_PROCEDURE.md. Developer runs all commands.

Pre-Commit

• [ ] Pre-commit verification — git status --short; approved scope only
• [ ] Frozen platform spot check — git diff {prior-tag} -- {frozen-paths} empty (if applicable)
• [ ] Final test run — Phase tests pass

Commit through Remote

• [ ] Scoped staging · Release commit · Hash recorded · Release doc updated
• [ ] Docs follow-up commit (or N/A) · Working tree clean
• [ ] Annotated tag · Tag verified locally
• [ ] Branch pushed · Tag pushed · Remote verified

---

Quick Reference Table

#	Item	Owner	Canonical stage
0	Baseline Verification	Architect + Developer	Idea → Architecture
1	Specification Approved	Architect	Specification
2	Implementation Complete	Cursor/Codex + Developer	Implementation
3	Tests Passed	Runtime Adapter (Adapter v1)	Runtime Implementation
4	Architecture Review Loop	Architect	Review
5	Hardening (if needed)	Cursor/Codex + Architect	Hardening
6	Freeze Review	Architect	Freeze
7	Release Document	Architect + Developer	Release
8	Git Freeze Procedure	Developer	Freeze → Release

---

Related Documents

• AI_DEVELOPMENT_ENVIRONMENT.md
• DEVELOPMENT_WORKFLOW.md
• GIT_FREEZE_PROCEDURE.md

---

An unchecked item blocks the baseline. No exceptions without explicit Developer decision.