Repository navigation
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 + usefulinvariant 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-freshordering fix: COMMANDS.md Behavior list now writesdispatch_continuation: trueBEFORE 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
--bgisolation,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 viarepo_path; all work-product paths resolve against the worker's owngit rev-parse --show-toplevel. Step 9 push contract becomesgit push origin HEAD:<branch>(with rebase first), landing commits on the real branch ref without checkout. --queueflag 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-pendingshows queued entries with aSTALEflag at >24h.
v7.5.0 — Worker model selection (cluster)
/falcon work beads --model <model-id|auto|inherit>: defaultinheritin ALL modes including--autopilot.autoconsults themodel_defaultsblock infalcon-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_budgetpolicy 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.mdnew at the kit root — the full 6-step bootstrap prompt extracted fromREADME.md. Two usage modes:Follow @BOOTSTRAP.md with my PRD @PRD.mdin 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.mdrestructure — TOC, mega-bullet → Path/Description table for "What this distribution contains", sub-bullets for--minimaland Architecture entries, mini-headings throughout. Version pointer rewritten to reference the latest release tag rather thanSKILL.mdfrontmatter (one component among several).- Example PRDs (
examples/asteroids_prd.md,examples/snake_prd.md) — headers point atBOOTSTRAP.mdwith the direct@-reference invocation. AUTOPILOT-RULES.mdgains themodel_defaultstemplate section 7 +escalation_ladder/escalation_budgetsection 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"(defaultinherit)worker_model_rationale: string | nullescalations[]arraymodel_defaults,escalation_ladder,escalation_budgetinfalcon-autopilot.mdtemplatefalcon-queue.yaml(queue file schema)