Human Acceptance
PIN-5 Order: #5 Construction Has Dependencies
Updated 3 weeks, 2 days ago
Guidance
Purpose
Verify CLAUDE.md iteration protocol sections are current, obtain explicit human approval, and deliver the single activation instruction for MIN. This is the final gate — do not proceed without explicit human go.
STOP — mandatory human gate.
Prerequisites
- All skeleton commits on iteration branch
- Execution manifest finalized (
ITER-*.yaml) withmilestone_numberpopulated - GitHub/GitLab Milestone + Issues published (PIN-04 complete)
Steps
Step 1: Verify CLAUDE.md Iteration Protocol Sections
Read the ## Iteration Protocol, ## Drift Handling, ## Session Resume Protocol, and ## Authority Model sections of CLAUDE.md.
Required sections must exist and contain:
- Iteration Protocol — references <!-- MANIFEST --> block, status-queued, fresh subagent per feature_execution_graph node with pytest gates
- Drift Handling — absorbed and escalated thresholds (checkpoint_fail retry once; escalate on footprint_violation, method_explosion, sao_violation)
- Session Resume Protocol — find status-in-progress → re-run checkpoint → PASS: close and continue / FAIL: retry
- Authority Model — can-decide / must-escalate / cannot-do bounds for the iteration runner
If any section is missing or substantially absent: update CLAUDE.md and commit:
git commit -m "docs(claude): sync iteration protocol to current MIN workflow"
Do NOT compare against a doctrine_version field in the manifest — protocol version is managed by the Edda playbook release, not the manifest.
Step 2: Present Review Summary
=== PIN COMPLETE — REVIEW REQUIRED ===
Iteration: {iteration_goal}
Milestone: #{milestone_number} — {milestone_title}
Scenarios: {N} | Groups: {A,B,...}
{for each scenario:}
S{N} [{group}] {title}
Checkpoint: {command}
Graph nodes: {N} (BPE-02...06)
Footprint: {N} files
Depends on: {deps or "none"}
Sample: review one scenario's feature_execution_graph in Plan mode
Conflict map:
{file} -> [{S_N}, {S_M}] (serialized)
{or "No conflicts — all scenarios parallel"}
Platform: {github|gitlab}
Milestone: #{milestone_number}
CLAUDE.md protocol: {current / updated at {timestamp}}
Activate MIN with: "Work on Milestone #{milestone_number}"
======================================
Step 3: Await Human Decision
GO — "Approved" or "Work on Milestone #{N}"
# GitHub:
gh issue comment {first_issue} --body "PIN approved at {timestamp}. MIN authorized."
# GitLab:
glab issue note {first_issue} --message "PIN approved at {timestamp}. MIN authorized."
NO-GO options:
- Skeleton issue on S{N} → return to PIN-03 for that scenario only
- Re-sequencing needed → return to PIN-03 Step 8-9 to revise conflict map
- Drop S{N} → close issue (won't-fix), remove from manifest, update Milestone description
Success Criteria
- CLAUDE.md iteration protocol sections are current (no doctrine_version comparison)
- Explicit human go/no-go decision obtained
- If go: approval comment posted on GitHub/GitLab
- Human has the activation instruction with the concrete milestone number
Rules
- Never skip this gate regardless of time pressure
- If human is unavailable: pause PIN, do not proceed to MIN
- A no-go with a fix takes minutes; a bad MIN run wastes an hour
Details
- Order:
- #5
- Phase:
- Predecessor:
- PIN-4 Publish
- Created:
- May 20, 2026
- Last Updated:
- Aug 28, 2026
Workflow
Plan Iteration
Dark-factory sprint planning. Use PIN when ESM, DTA, DSP, and BSP are complete and you want to deliver a full …
View WorkflowAssigned Agent
No agent assigned
Required Skills
No skills linked
Rules
No rules linked.
Input Artifacts
No input artifacts
Output Artifacts
No output artifacts