haipipe-application-check

name	haipipe-application-check
description	Application-specific CHECK phase worker (internal). Runs when a stage's local contract declares its human gate. It opens with markdown and probe-file checks whose failures block green, seeds CHECK comments in stage docs while keeping deliverable artifacts clean, presents exit criteria, and on explicit approval writes the Gate Ledger row in STATUS.md and advances current_layer. Venue-scaled depth controls inline versus full reporting, and attendance modes govern whether a stand-in may approve. Trigger: check, gate, approve stage, exit criteria, /haipipe-application check.
allowed-tools	Bash, Read, Write, Edit, Grep, Glob, Skill
metadata	{"argument_hint":"[stage: seed|descriptions|themes|claims|advice|pitch|narrative|display|section-edit|draft] [--persona strict|balanced|creative|lenient] [--unattended[=Ns]]","version":"0.4.3","last_updated":"2026-08-04","summary":"Application-specific CHECK worker layered on haipipe-board-page-check; runs local checkers, seeds findings, and applies the application's declared human gate."}

Skill: haipipe-application-check (CHECK phase worker)

CHECK phase worker -- the 🧑 phase. Reviews the artifacts produced during one lifecycle stage's DRAFT-PROBE-REVISE and proposes the next move:

LOAD THE PAGE LAYERS FIRST: ../../../../board/page-types/haipipe-board-page-for-stage/SKILL.md, then ../../../../board/page-phases/haipipe-board-page-check/SKILL.md. The generic contract owns judgment and phase routing. This file adds the application's deterministic checks, comment surface, and Gate Ledger.

approve   → Gate Ledger row + advance current_layer to the next non-skipped stage
grow      → GROW-loop rungs (1a-1d) only (JL 2026-07-09: "after the check, they
            can think about adding more probes in the draft"): the gate ASKS
            "which data topics / probes are still missing?" -- the user's
            questions are the strongest lens; grow converts them to new slots
            + planned probe skeletons and re-opens DRAFT as [ROUND n+1].
            Approve at these rungs means: saturated AND the user added nothing.
revise    → loop back with feedback (same stage; the restarted phase reads the
            stage-doc > CHECK: threads + > USER: replies; upstream problems are
            named as loopback suggestions, the user decides)
done      → early exit: jump to draft (artifact) with remaining stages waived
            (recorded in the ledger notes)

A stage is only "done" when this approval is EXPLICIT. The system never auto-advances. Full protocol: ../../../haipipe-application/SKILL.md (Stage Gate Protocol section).

Before any of that, CHECK opens with a MECHANICAL Run step (next section): a ❌ from ./checks.sh or a FAIL from the probe-file checker means the gate CANNOT go green -- at any venue depth, under any persona.

Mechanical checks (step 1 -- Run)

Two checkers open every CHECK, before the judgment ask. They fire at EVERY venue depth -- venue scaling governs how the report is presented (inline vs full), never whether the checkers run.

1. Deterministic markdown checks -- ./checks.sh <artifact-or-dir> [--md <working-doc>] ... (this folder; --md repeatable, --depth N widens the dir scan). Em-dash (❌, house rule), AI-voice tells (⚠️), TODO/FIXME (❌), bibtex-in-markdown (❌). Paste its ✅/⚠️/❌ lines into the CHECK report verbatim; exit 0 = no ❌. Paper's tex checks (\cite/\ref/\label, Pn.Sn, --compile) are deliberately absent -- application artifacts are markdown.

2. Probe-file invariants -- sh "$CHK" <intervention_root> (resolve $CHK per Locating the probe-file checker below). Any FAIL line (a state: planned section, a dangling ref, a harvest: OWED lane, dead vocabulary) means the gate CANNOT go green: a planned section surviving to CHECK is a probe that never ran.

A mechanical ❌/FAIL is not a judgment call: no persona preset, no --unattended timeout, and no venue-profile override can approve over it. Fix (revise), re-run, then proceed to the judgment ask.

Locating the probe-file checker

Installed skills flatten the tree, so the hard-coded relative path (../../1-probe/...) is NOT reliable, and TWO files named check-probe-cards.sh exist on disk (paper's under haipipe-paper-probe/, application's under haipipe-application-probe/). Glob for it, FILTER on the path so it cannot resolve to the paper family, and FAIL LOUDLY when nothing matches:

CHK=$(find -L ~/.claude/skills ./.claude/skills "${CLAUDE_PLUGIN_ROOT:-/nonexistent}" -maxdepth 4  \
        -path "*haipipe-application-probe*" -name check-probe-cards.sh 2>/dev/null | head -1)
[ -n "$CHK" ] || { echo "FAIL: application probe-file checker not found"; exit 1; }

sh "$CHK" <intervention_root>    # whole-pool section pass

A missing checker is a FAIL, never a silent skip: a gate that cannot run its checker has not checked anything.

> CHECK: comment seeding (stage docs ONLY)

Every flagged item that lives in a 0-lifecycle stage doc (0-seed.md, 1a-descriptions.md, 1c-claims.md, ...) is planted as ONE > CHECK: comment at its exact spot -- one line stating the issue + the judgment needed, with concrete values, never an abstract description. The chat report is the map; the in-file threads are what the human walks.

0-artifacts/*.md are NEVER annotated: the artifact IS the deliverable text (unlike paper's .tex, where % comments never render), so a seeded comment would ship. Artifact-level findings go into the Gate Ledger notes column instead, quoted with file:line so they stay actionable (R2c RULED, JL 2026-07-07).

The human replies > USER: under each thread. On revise, the restarted phase (DRAFT/PROBE/REVISE) reads the stage-doc > CHECK: threads + their > USER: replies and responds to each -- an unanswered > CHECK: comment is surfaced back, never silently dropped. Resolved threads archive to the stage _LOG.

Gate Ledger (STATUS.md)

On approve, append/update the row and bump current_layer:

## Gate Ledger

| Stage | Confirmed | Date | By | Notes |
|-------|-----------|------|----|-------|
| seed | yes | 2026-07-06 | JL | kill criteria set |
| claims | yes | 2026-07-06 | JL | settlement: light met |
| draft | yes | 2026-07-07 | JL | artifact: em-dash sms.md:4 fixed pre-approve |

By records who approved: the human (copilot mode) or persona:<preset> (unattended mode). The stage strip's ✅ means "confirmed in this ledger", NOT "artifact exists on disk". The Notes column is also where artifact-level checker findings land (0-artifacts/*.md are never annotated in-file -- see comment seeding above).

Venue-scaled depth (when CHECK fires)

simple (sms, push, reminder)      INLINE — present the exit criteria as one short
                                  checklist in the reply; user's "ok" = approve.
medium (checklist, email)         INLINE by default; full report on request (--report).
complex (dashboard, ui-card,      FULL — render the complete CHECK report (criteria
report)                           + evidence spot-checks + flags) before the ask.

The venue profile's README can override with gate: inline | report. Depth scales the REPORT, not the mechanics: ./checks.sh + the probe-file checker run even for inline/simple venues (an sms message text still gets the em-dash/AI-voice/TODO scan).

Per-stage exit criteria

seed:          kill criteria present? audience hunch specific? >=1 evidence path named?
descriptions:  every **D<n>** entry anchored (statistic + resolving pointer + as-of
               date)? no raw data / inline computation? no unconsumed
               [FORWARD -> CLAIMS] pointer in seed's _LOG?
themes:        every **T<n>** grounded (>=1 D id or project-side source)? hooks or
               context-only note per theme? Parked honest? no unresolved [STALE] tags?
claims:        every claim a **C<n>** line with theme tag + role + status + → PP ref?
               theme tags resolve to 1b? every probe a **PP<nn>** plan? Evidence
               Campaign complete (dispatch order + deps, no load-bearing GAP without a
               row)? settlement bar met against the campaign for the pinned depth
               (light/medium/full — claims skill §Settlement Gate)? no [STALE] tags?
advice:        every **A<n>** derived from >=1 resolving C id at/above the settlement
               bar? W-actionability passed? Rejected section honest? no [STALE] tags?
               (the LADDER GATE lands here for light/medium venues — batching per
               Stage Gate Protocol; one approval writes the batched rungs' ledger rows)
pitch:         one-sentence goal testable? mechanism (theory of change) plausible?
               venue + audience named?
narrative:     arc follows venue rules? all load-bearing claims mapped to beats?
display:       every primary claim has a content element? every element has a job +
               evidence anchor? materialization routed (task refs) where needed?
section-edit:  every section's prose does its assigned job? flagged NEEDs resolved
               or explicitly parked?
draft:         venue self-review checklist passes? audience constraints met? artifact
               cites only adopted advice entries (adopted_A resolve: A -> C -> anchor)?

Persona presets (unattended stand-in ONLY)

preset       strictness  ambition  default outcome
─────────    ──────────  ────────  ───────────────
strict       8           4         revise
balanced     5           5         revise
creative     3           8         approve
lenient      2           3         approve

In copilot mode (default) the human decides and personas only SHAPE the report's recommendation. In --unattended[=Ns] runs the persona decides after the timeout and the ledger records persona:<preset>. Full schema: ./gate-persona.md; attendance modes: ./attendance-modes.md.

Return contract

status:     approved | revise | done | awaiting-user
stage:      <stage-name>
mechanical: checks.sh <n ✅ / n ⚠️ / n ❌> · probe-files <PASS | FAIL>
seeded:     <n> > CHECK: comments (stage docs; artifact findings → ledger notes)
criteria:   <n passed> / <m total> (+ per-item marks in the report)
ledger:     <row written or "pending user">
next:       <next stage command or the revise instruction>

Risk profile

READ-ONLY on 0-artifacts/*.md -- the deliverable text is never annotated or modified. Writes: > CHECK: comments in 0-lifecycle stage docs (at flag sites), the STATUS.md Gate Ledger + current_layer (on approve), and a [CHECK] entry in the stage _LOG.