Skip to content

v2.3.1 — /plan external-review-handoff option (paired with toolkit v0.8.1)

Choose a tag to compare

View all tags
@alexherrero alexherrero released this 17 May 03:07
· 374 commits to main since this release
v2.3.1
41f725b

Patch — additive only, no breaking changes. Adds an external-review-handoff option to the harness's /plan phase, mirroring the option added to agent-toolkit v0.8.1's /design skill.

Operators can now hand off a drafted .harness/PLAN.md to Antigravity IDE for inline-comment review + Gemini-applies-comments revision, then resume in Claude Code with a diff-on-resume pass against a pre-handoff snapshot.

Why this shape

Dogfood-driven amendment from plan #6's first real design exercise (MemoryVault). The inline block-by-block walk pattern works but tires fast on long content. Antigravity has a native inline-comment UI + Gemini AI integration that handles bulk-apply dramatically better. The /plan phase faces the same pattern when drafting substantial plans; mirroring the option from /design means operators have the same workflow available in both surfaces with the same mechanics.

Mechanics

(mirrors toolkit v0.8.1 — shared template, shared workflow shape, shared cleanup discipline)

  1. Pre-handoff snapshot at .harness/PLAN.pre-handoff-<ts>.md.
  2. Transfer-context file at .harness/transfer/plan-<ts>.md using the toolkit-side template at agent-toolkit/skills/design/templates/transfer-context.md. DOC_TYPE: plan triggers plan-specific guardrails (harness PLAN.md shape per templates/PLAN.md; Status lifecycle draft → in-progress → done don't-transition; paragraph-long Status:[x] narratives required; Locked design calls section is load-bearing).
  3. Handoff prompt output to operator with explicit Antigravity steps: open PLAN.md + transfer-context, comment via Antigravity's native UI, ask Gemini to apply per the transfer-context.
  4. Resume flow (/plan --resume-external-review or natural "plan review complete"): diff revised PLAN.md against snapshot + read change-summary log + present findings + Accept / Iterate / Discard.

Files changed

  • harness/phases/02-plan.md — new §4b documenting the option (~70 lines)
  • CHANGELOG.md — v2.3.1 entry
  • wiki/reference/Completed-Features.md — v2.3.1 overview row + narrative

No adapter changes (canonical-reference inheritance per established convention). No script changes, no template changes (reuses toolkit-side transfer-context.md). No new harness ADR — shared design rationale in agent-toolkit ADR 0004 amendment (2026-05-16).

Graceful-skip if agent-toolkit absent: operator gets a message that external-review handoff requires agent-toolkit v0.8.1+ alongside; inline-only review still available.

Verification

  • check-syntax: 15 .sh files parse cleanly
  • validate-adapters: all adapter files parse + have required keys
  • check-references: all cross-references resolve
  • check-wiki --strict: 0 structural issues, 0 soft warnings
  • check-lib-parity: clean
  • check-no-pii: clean (all mode)
  • smoke-install-bash: OK

Pattern

First cross-repo dogfood-driven amendment shipped as a coordinated patch pair. Pattern: surface gap on both surfaces during a single dogfood, ship paired patches with shared rationale captured in one ADR.

Full changelog

CHANGELOG.md

Assets 2
Loading