Skip to content

feat(rig-epic,rig-task): front-loaded spec review, advisor gate, squash child-merge - #29

Merged
pgebheim merged 2 commits into
mainfrom
rig/skills-frontload-advisor-squash
Jul 26, 2026
Merged

feat(rig-epic,rig-task): front-loaded spec review, advisor gate, squash child-merge#29
pgebheim merged 2 commits into
mainfrom
rig/skills-frontload-advisor-squash

Conversation

@pgebheim

Copy link
Copy Markdown
Contributor

Backports the skill learnings from the Smithers durable-workflow experiment (umbrella PR #28) onto main — skills-only, no smithers/ files.

  • rig-epic run: front-loaded spec review — review ALL children's specs up front, resolve blockers once, run children --spec-cleared so none re-pauses mid-run (a paused child stalls the whole epic — fatal under parallel/durable execution).
  • rig-epic run --advisor — decide that gate with a delegated architect advisor pass (proceed + per-child direction, or halt) instead of a human, so kicked-off epics run hands-off to child PRs.
  • rig-task --spec-cleared — the enabler: run spec review for notes but skip the blocking pause when the caller front-loaded it.
  • fix: child PRs squash-merge, not rebase — many repos disallow rebase; merge directly when no required checks.

Prompt-only, additive. Validated live: drove a full multi-epic slice to completion unattended.

🤖 Generated with Claude Code

https://claude.ai/code/session_015ENct54EpFjBkVMecSGh4z

pgebheim and others added 2 commits July 26, 2026 06:16
…thers-loop learnings)

Port two learnings from the paired Smithers durable workflow back into the
source-of-truth skills:

- rig-epic `run`: **front-loaded spec review** — review ALL children's specs up
  front (architect+qa over every child vs the integration branch), resolve
  blockers once, then run children `--spec-cleared` so none re-pauses mid-run. A
  child that pauses on a spec question stalls the whole epic (fatal under
  parallel/durable execution); front-loading makes it the single spec decision.
- rig-epic `run --advisor`: **unattended mode** — decide that front-loaded gate
  with a delegated architect advisor pass (proceed + synthesized per-child
  direction, or halt with a blocked report) instead of a human, so kicked-off
  epics run hands-off to child PRs. The Smithers workflow implements this with a
  cheap model (the "Fable advisor").
- rig-task `--spec-cleared`: skip Step 2's blocking pause (keep the notes, don't
  gate) when the caller already front-loaded the spec — the enabler for the above.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015ENct54EpFjBkVMecSGh4z
Child auto-merge said `gh pr merge --rebase --auto`, but many repos disallow
rebase merges (and a repo with no required checks can't arm `--auto` at all).
Switch to `--squash` for child PRs into the integration branch — into a stacked
branch or the trunk — and merge directly when there are no checks for `--auto` to
wait on. Matches the paired Smithers workflow.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015ENct54EpFjBkVMecSGh4z
@pgebheim
pgebheim merged commit 4b31733 into main Jul 26, 2026
@pgebheim
pgebheim deleted the rig/skills-frontload-advisor-squash branch July 26, 2026 06:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant