Sign in to create and edit playbooks. Sign In Register

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) with milestone_number populated
  • 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 Workflow
Assigned Agent

No agent assigned

Required Skills

No skills linked

Rules

No rules linked.

Input Artifacts

No input artifacts

Output Artifacts

No output artifacts