agentii.implement

Before dispatch

1. Checklist soft gate (Q29): scan checklists/*.md; on unchecked items, stop and ask — the human may proceed (it is a soft gate, not a hard block).
2. Budget check (Q58): budget{max_tasks, max_retries_per_task} — exceeding halts with a Q39 approval card; never a silent overrun. The dispatcher checks budget first, max_in_flight second (Q82).
3. Resume matrix (Q56): absent → run; valid FR-090 → skip; corrupted → --resume; stale → leave for converge. The filesystem IS the checkpoint.
4. thesis_dir passed explicitly (Q37) — no singleton pointer; cwd fallback is human-only and journaled.

During dispatch

• Cross-vertical handoff passes artifact paths, never content (Q13 rule 3).
• skill_pin: {skill_name: version_hash} recorded before the first task (version_hash = content hash of SKILL.md + references/); a version change mid-thesis uses the new version and appends the new hash (Q57).
• [x] written on completion — display-only; converge never reads it.

Invocation

# Resolve the kit root first — contracts/kit-root.md. The kit's scripts do NOT ship
# with the skills, so never assume the CWD is the checkout.
KIT=""
for c in "${AGENTII_KIT_ROOT:-}" \
         "$(cat "$HOME/.claude/skills/agentii/.kit-root" 2>/dev/null)" \
         "${CLAUDE_PLUGIN_ROOT:-}"; do
  [ -n "$c" ] && [ -f "$c/scripts/agentii_cmd.py" ] && { KIT="$c"; break; }
done
if [ -z "$KIT" ]; then d="$PWD"; while [ "$d" != "/" ]; do
  [ -f "$d/scripts/agentii_cmd.py" ] && { KIT="$d"; break; }; d="$(dirname "$d")"; done; fi
[ -n "$KIT" ] || { echo "agentii kit not found — see contracts/kit-root.md" >&2; exit 1; }

python3 "$KIT/scripts/dispatch.py" --thesis-dir theses/001-ai-semiconductors --task "NVDA recent-quarter default" --journal theses/001-ai-semiconductors/shards/run1.ndjson

Gate 4 (before mass dispatch, consequential — never delegable) shows budget and parallelism; it must attach a budget estimate.