Skip to content

v1.6.0 — hyper-recap: Claude-only cycle-recap skill

Choose a tag to compare

@zeikar zeikar released this 13 Jul 22:27
· 47 commits to main since this release

What's new

/hyperclaude:hyper-recap — a new Claude-only gate skill (no Codex spawn, no agent dispatch) that collapses ONE completed cycle (a plan archived under .hyperclaude/plans/done/) into a single human-readable recap at .hyperclaude/recaps/<timestamp>[-<slug>].md. Kills cycle cognitive debt: the request, the decisions taken (and rejected), what actually changed, and the critic rounds — in one screen.

Highlights

  • Two context modes: context: live (originating session — verbatim request, per-commit change set incl. the implement-loop's fix(review): convergence commit) and context: artifacts-only (fresh session — explicitly partial, with an "Unrecoverable gaps" note; never fabricates commits, associations, or rationale).
  • Exact cycle linkage where provable, caveats where not: plan-reviews match by frontmatter plan-path + cwd full-path resolution; research/specs are slug-matched with an ambiguity caveat (skipped entirely for empty-slug / collision-ambiguous plan names); code-reviews are live-only.
  • Story over ledger: TL;DR-first content contract — area-level "what changed" with commit range, one-line critic-verdict arcs, decision table scoped to outcome-shaping decisions only.
  • Loop integration: hyper-implement-loop Step 9 (and hyper-auto's relay, exactly once) now recommend /hyperclaude:hyper-recap at cycle completion — recommendation only, never auto-run.
  • Registered in the smoke required-files roster + a new manual-acceptance item (5b) with per-scenario fixtures; docs roster updated across architecture / gates-and-agents ("Gate skills (12)") / workflow / README / site.

Hardened through 8 Codex plan-review rounds and 3 Codex code-review rounds (path-traversal-safe target resolution, evidence-only rationale rule in both modes, JSON-serialized slug:/plan: frontmatter).

No breaking changes.