Gate File Schemas¶
Three gate files enforce workflow sequencing for CWP processing. All live in the
V004 repo root alongside .content-state.yaml and are .gitignored (ephemeral).
.cwp-plan-gate.yaml¶
Written by /vt-v-plan --cwp (Step 2). Checked by /vt-v-draft (Step 3, soft gate).
cwp: CWP-06
status: PASS # PASS | FAIL
date: "2026-03-11T10:30:00+01:00"
branch: feature/vms-content-cwp-06
file_count: 14
batch_count: 1 # ceil(file_count / batch_size)
batch_size: 14
dependencies_met: true
baseline_recorded: true
plan_file: docs/content-plans/cwp-06-plan.md
summary: "14 files in 1 batch. Dependencies met. No pending HA items."
Enforcement: Step 3 (/vt-v-draft) reads this file at entry.
- Missing → warn: "Plan gate not found. Run Step 2 first." Allow override.
- FAIL → warn: "Plan gate failed." Allow override.
- CWP mismatch → warn: "Gate is for different CWP." Allow override.
.cwp-review-gate.yaml¶
Written by /vt-v-review --cwp (Step 4). Checked by /vt-v-cwp complete (Step 5, hard gate).
cwp: CWP-06
status: PASS # PASS | FAIL
date: "2026-03-11T14:00:00+01:00"
branch: feature/vms-content-cwp-06
files_reviewed: 14
ratings:
approve: 11
revise: 2 # Auto-fixed, now approved
escalate: 1
unresolved_revise: [] # Files still rated revise after auto-fix; non-empty → FAIL
escalations:
- file: "vault/ISMSI/04/A.7.3.md"
reason: "Reifegrad 4 claimed but no Nachweise referenced"
acknowledged: true # User acknowledged during review
audit_metrics:
compliance_score: 91.2
content_depth_complete_pct: 85
cross_ref_rate_pct: 62
summary: "11 approved, 2 revised (auto-fixed), 1 escalated (acknowledged)."
Enforcement: Step 5 (/vt-v-cwp complete) reads this file at entry.
- Missing → BLOCKED: "Run Step 4 first (/vt-v-review --cwp CWP-NN)."
- FAIL → BLOCKED: "Review failed. Fix issues and re-run Step 4."
- CWP mismatch → BLOCKED: "Review gate is for a different CWP."
.cwp-checkpoint.yaml¶
Written at batch boundaries and session pauses. Read by /vt-v-start (Step 0)
and /vt-v-draft (Step 3) to enable session resume after /clear.
cwp: CWP-08
step: 3 # Workflow step number (1-5)
phase: draft # activate | plan | draft | review | complete
saved_at: "2026-03-11T12:00:00+01:00"
branch: feature/vms-content-cwp-08
batch_cursor: 25 # Index of next unprocessed file
files_processed: 25
files_remaining: 63
last_file: "vault/ISMSI/04/A.5.7.md"
next_action: "Run /vt-v-audit --changed, then continue with batch 2"
next_command: "/vt-v-draft --cwp CWP-08"
clear_recommended: true
Lifecycle:
- Created by /vt-v-draft and /vt-v-sprint at batch boundaries
- Created by /vt-v-interview when user pauses mid-CWP
- Read by /vt-v-start → shown as P0 priority with step number
- Read by /vt-v-draft → resumes from batch_cursor
- Deleted by /vt-v-cwp activate (clears stale checkpoint)
- Deleted by /vt-v-cwp complete (CWP finished)
File Locations¶
All three files are written to: REPOS_ROOT/03-VisiTrans/V004-VisiTrans Handbuch -dev/
Add to V004 .gitignore: