v0.0.5 — MAGI interactive-only contract

v0.0.5 — MAGI interactive-only contract

Documents /magi:magi as an interactive-only Claude Code skill in the SBTDD references and forbids headless invocation via claude -p captured-pipe subprocess. Addresses the MAGI-Hang Windows stdio-chain incident by ensuring future runtimes read an explicit contract before invoking the review gate.

What's new

• New §7 "MAGI Invocation Contract" in skills/sbtdd/references/review-gates.md. Self-contained: names the forbidden transport (claude -p "/magi:magi …"), enumerates the Windows failure mechanisms (pipe-buffer deadlock, asyncio.ProactorEventLoop hang on create_subprocess_exec under inherited non-TTY stdin, stdin reads against closed pipes), and lists the two supported alternatives (interactive handoff; direct magi-runner CLI invocation if/when published).
• interactive-only pointers at 6 documentation surfaces so a reader entering at any entry point encounters the contract before building a headless dispatcher:
  • SKILL.md delegation-table Plan-gate row + Pre-merge review row + §4 Gates blockquote
  • references/routing.md plan-gate row Action cell
  • references/review-gates.md §0 Plan Gate + §4 Final Gate blockquotes
  • README.md phase table
• 5 new presence/lint tests plus Loop 1/Loop 2 hardenings:
  • §7 polarity guard — no line presents claude -p co-located with permitted / acceptable / now allowed / is supported / no longer applies
  • Supported-alternative bullet anchors (- **Interactive handoff.**, - **Direct runner invocation.**)
  • §0/§4 first-line header cross-check (Plan Gate / Final Gate) guarding against silent wrong-section matches
  • SKILL.md per-surface row anchors with >=2 count fallback
• Tightened .gitignore from a broad docs/MAGI-Hang* pattern to explicit filenames (docs/MAGI-Hang.txt, docs/MAGI-Hang-Handoff.md), so future tracked post-mortems aren't silently hidden.

Quality gates

• pytest 51/51 passing
• Loop 1 (superpowers:requesting-code-review) clean-to-go after 3 refactor: mini-cycles
• Loop 2 (magi:magi interactive gate) verdict GO WITH CAVEATS (3-0) — all Caspar conditions applied as low-risk doc/test fixes per CLAUDE.local.md §6

Scope

This release is documentation only. The MAGI-Hang runtime fix itself lands in a separate SBTDD-runtime repository; the contract here ensures any future headless runtime reads the prohibition before invoking the review gate.

Install

/plugin install BolivarTech/SBTDD@v0.0.5