Skip to content

v7.7.0 — Wake-opportunism, worktree-aware lifecycle, worker model selection

Latest

Choose a tag to compare

@r-teller r-teller released this 13 Jun 04:36

Cumulative release covering v7.5.0, v7.6.0, and v7.7.0 since v7.4.0. Three falcon-skill minor versions land in one squashed snapshot per the kit's public-release convention.

v7.7.0 — Wake-opportunism convention + respawn ordering

  • Wake-opportunism convention: on any steering-session wake (cron fire, operator message, monitor event), after the triggering role exits, probe all active dispatches for pending actionable state and process under the appropriate role's rules. Scheduled crons become the AFK latency floor, not a ceiling when the operator is present. Telemetry gains a source= attribution label; fires == silent + useful invariant preserved. New CRONS.md cross-cutting section; each cron template carries an exit-step pointer; PROTOCOL.md Step 3 gains the awake-supersedes-cadence note.
  • /falcon respawn-fresh ordering fix: COMMANDS.md Behavior list now writes dispatch_continuation: true BEFORE spawning the successor, matching PROTOCOL.md's authoritative walkthrough. Closes a race where the successor's bootstrap could read the file before the flag landed and skip the three-step recovery sequence.

v7.6.0 — Worktree-aware worker lifecycle + --queue flag

  • Worktree-aware lifecycle: under default --bg isolation, git checkout <branch> was impossible (steering holds the branch). Step 1 now branches on worktree detection — ancestry verify (git merge-base --is-ancestor origin/<branch> HEAD) replaces the checkout call when isolated, retained checkout path for non-isolated workers. Edit-root rule made explicit: only .claude/tmp/* paths resolve via repo_path; all work-product paths resolve against the worker's own git rev-parse --show-toplevel. Step 9 push contract becomes git push origin HEAD:<branch> (with rebase first), landing commits on the real branch ref without checkout.
  • --queue flag for /falcon work beads: lock-conflict HARD-reject converts into a registered pending-dispatch in .claude/tmp/falcon-queue.yaml (cross-session FIFO). Both release paths (Step 4 auto-release + /falcon release) re-run the full pre-dispatch sequence for the eldest non-conflicting entry. New /falcon dequeue <queue-id> verb; /falcon list-pending shows queued entries with a STALE flag at >24h.

v7.5.0 — Worker model selection (cluster)

  • /falcon work beads --model <model-id|auto|inherit>: default inherit in ALL modes including --autopilot. auto consults the model_defaults block in falcon-autopilot.md; if no match, falcon evaluates the bead (cynefin + size + Effort Forecast) and proposes with recorded rationale. Hard invariant: orchestrator always indicates the model, resolved before worker init; worker has no self-selection role.
  • /falcon respawn-fresh --model <id> --thinking <mode>: prompted override at respawn — operator can escalate (or downgrade) a successor's model without re-authoring the dispatch.
  • Intent-gate model escalation: orchestrator can kill a poor-intent worker and respawn on a stronger model. Manual: escalate <dispatch-id> [--model <id>]. Autopilot: escalation_ladder + escalation_budget policy keys (commented out in all profiles), escalations[] audit shape on dispatch files. Budget is separate from amendment budget; default 1 escalation per dispatch.

Documentation

  • BOOTSTRAP.md new at the kit root — the full 6-step bootstrap prompt extracted from README.md. Two usage modes: Follow @BOOTSTRAP.md with my PRD @PRD.md in a fresh session, or copy-paste the prompt block as before. README's Bootstrap section shrinks to a ~15-line stub (same heading + anchor preserved).
  • README.md restructure — TOC, mega-bullet → Path/Description table for "What this distribution contains", sub-bullets for --minimal and Architecture entries, mini-headings throughout. Version pointer rewritten to reference the latest release tag rather than SKILL.md frontmatter (one component among several).
  • Example PRDs (examples/asteroids_prd.md, examples/snake_prd.md) — headers point at BOOTSTRAP.md with the direct @-reference invocation.
  • AUTOPILOT-RULES.md gains the model_defaults template section 7 + escalation_ladder/escalation_budget section 8 (both shipped commented in all profiles).

Breaking changes

None. Default behavior preserved on every flag.

Schema additions (dispatch file + autopilot rules)

  • worker_model: "inherit" | "<model-id>" | "auto" (default inherit)
  • worker_model_rationale: string | null
  • escalations[] array
  • model_defaults, escalation_ladder, escalation_budget in falcon-autopilot.md template
  • falcon-queue.yaml (queue file schema)