session-start-recovery
Skill2 starsChanged 33 days agoMITView on GitHub
Load when the session-start digest reports unfinished checks, actionable diagnostics, recovery inputs, or output requiring interpretation.
1 other project uses a version of this, 1 of them edited.
Adopted by
Most recently taken up by
- kunchenguid/firstmateedited, first seen Oct 8, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 1
- kunchenguid/firstmate★ 8.7k94% same
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository32 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- afkSkill
- agent-skill-trigger-indexSkill
- ahoySkill
- ask-user-authoritySkill
- away-quiet-supervisionSkill
- bearingsSkill
- bootstrap-diagnosticsSkill
- captain-hold-lifecycleSkill
- control-firstmateSkill
- decision-hold-lifecycleSkill
- diagnostic-reasoningSkill
- firstmate-codexappSkill
- firstmate-coding-guidelinesSkill
- firstmate-orcaSkill
- fmx-respondSkill
- harness-adaptersSkill
- operational-home-layoutSkill
- process-event-sourcesSkill
- project-managementSkill
- quietSkill
- quota-array-dispatchSkill
- scout-completionSkill
- secondmate-provisioningSkill
- ship-landingSkill
- stowSkill
- stuck-crewmate-recoverySkill
- updatefirstmateSkill
- validation-supervisionSkill
- verify-firstmateSkill
- stowSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 4 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 12
Every network check a session start owes - GitHub auth, dead-secondmate relaunch, secondmate convergence, pending handoff delivery, and …
- Distinctive: line 17
When the lock could not be acquired, the worktree-tangle check uses read-only advisory wording without a checkout repair command.
- Very specific: line 23
Every locked drain also prints a bounded fleet-wide OPEN DECISIONS section when durable decision records remain open, including when the …
- Distinctive: line 27
When the lock could not be acquired and verified, the queue is left untouched because no session mutation is authorized, and the guard's …
- Distinctive: line 28
Supervision operating instructions: - after the wake queue and before both digests, the digest emits exactly one operating block for the …
- Distinctive: line 32
Network checks: - after the fleet-state digest, the deferred stage's result, or an explicit statement of what it has not confirmed yet.
- Very specific: line 39
Do not dispatch until the essential launch tools are present and GitHub authentication is good.
- Very specific: line 40
Use gh-axi for GitHub, chrome-devtools-axi for browser work, and compatible lavish-axi for visual decisions or reports.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Session-start recovery
The digest itself makes no external-network call and never waits for one.
Every network check a session start owes - GitHub auth, dead-secondmate relaunch, secondmate convergence, pending handoff delivery, and project clone refresh - runs off the digest's blocking path in a bounded worker owned by bin/fm-startup-network.sh and is reported in the digest's own NETWORK CHECKS section.
The locked startup inactive-outcome scan joins that worker so a slow local current-state read cannot block the digest; its findings use the ordinary durable wake queue.
- Lock - acquires the per-home session lock first, before anything mutates shared state, then starts the deferred startup stage above.
- Bootstrap - detect-only checks (tool/version problems, the worktree-tangle check, harness override, dispatch-profile validation, backlog-backend status) always run, but routine confirmations stay silent by default.
When the lock could not be acquired, the worktree-tangle check uses read-only advisory wording without a checkout repair command.
Home-local stale Herdr projection cleanup and the six bootstrap MUTATING sweeps - same-home backlog reconciliation, fleet sync, secondmate convergence, secondmate liveness, pending remote handoff retry, and Relay artifact writes - run only when this session actually holds the lock from step 1; the four network ones among them run in the deferred stage rather than in this section.
The secondmate liveness sweep deterministically accounts for every registered secondmate: it relaunches only from the recovery-grade
deadormissingstates, preserves ambiguous, unreadable, or unreachable remote targets, and reports skipped or failed guarantees asSECONDMATE_LIVENESS:lines (bin/fm-bootstrap.sh;bin/fm-backend.sh'sfm_backend_agent_state;docs/remote-secondmates.md). Ordinary supervision continues the same guarantee through the watcher's cadence-gated liveness tick over the sharedbin/fm-secondmate-liveness-lib.sh, so a mate that dies mid-session is relaunched without waiting for the next session start. - Wake queue - when locked, drains and presents the durable wake queue without running the inactive-outcome scan inline, and prints the raw records prominently as this turn's first work queue; a clearly labeled status-event annotation may follow a valid
signalrecord and includes every status line still unread at the presentation cursor, but never replaces the raw record or current-state reconciliation, and a lapsed watcher chain still surfaces here via the same guard alarm. Presented records remain durable until the handling turn runs the generation-bound acknowledgement printed by the drain. Every locked drain also prints a bounded fleet-wideOPEN DECISIONSsection when durable decision records remain open, including when the queue itself is empty; reconcile those entries before continuing. A main drain may also print a bounded, one-shotSTATUS OUTCOME BACKSTOPwhen a task's newest captain-facing status event has no covering supervision-branch outcome; handle it as a recovered wake even when no queue row remains. The same drain prints every still-unreadnote:line and pending-reply resolution since the last presentation in an unboundedUNREAD STATUSsection, so an answer buried under a later routine line is not dropped; those lines are not re-printed after that presentation. It also prints a boundedRECORD DIVERGENCEsection naming every captain call the status log reads as resolved while its backlog task is still held; nothing is closed for you, andcaptain-hold-lifecycleowns the reconciliation. When the lock could not be acquired and verified, the queue is left untouched because no session mutation is authorized, and the guard's tangle/watcher-liveness alarms still print in read-only advisory mode without drain, supervision repair, or checkout repair commands. - Supervision operating instructions - after the wake queue and before both digests, the digest emits exactly one operating block for the detected primary harness, followed by the read-once contract that governs them. The script itself never starts supervision; the emitted harness protocol owns the exact wait or wake mechanism.
- Fleet-state digest - after that read-once contract and ahead of the context digest, the compact backlog listing owned by
bin/fm-session-start.sh; everystate/<id>.meta; a bounded tail of each task'sstate/<id>.status(labeled as wake-EVENT history, not current state, with the full log path printed for a deeper read); the away or quiet posture (state/.afk-contract, plus thestate/.afkdaemon flag where a daemon runs); and one cheap alive/dead read of each task's recorded backend endpoint. That liveness line is a fast presence check only, not a full state read - when you need a crew's actual current state (a run-step, not just "is the pane there"), read it withbin/fm-crew-state.sh <id>as before; the digest deliberately skips that deeper, slower read for every task so it stays fast and bounded. - Network checks - after the fleet-state digest, the deferred stage's result, or an explicit statement of what it has not confirmed yet. A read-only session runs no network checks at all and says so.
- Context digest and next step - last of the bulk sections, the full contents of
data/projects.md,data/secondmates.md,data/captain.md,data/captain-shared.md, anddata/learnings.md, each clearly delimited, followed by the closing reminder. A file that does not exist prints an explicitABSENTmarker, never confused with an empty-but-present file: absence is meaningful (captain.mdabsent means use the firstmate repo's built-in defaults,projects.mdabsent means rebuild it from the clones underprojects/, etc.). The closing reminder points back to the emitted supervision block and preserves only the lock, afk, Relay, and read-once reminders.
Bootstrap detects first, asks for consent, and installs only after the captain approves in the current session.
Do not dispatch until the essential launch tools are present and GitHub authentication is good; presentation availability follows bootstrap-diagnostics and does not block nonvisual work.
Use gh-axi for GitHub, chrome-devtools-axi for browser work, and compatible lavish-axi for visual decisions or reports; consult current help rather than memorizing flags.
A silent bootstrap section needs no action; for any printed actionable diagnostic line, load bootstrap-diagnostics and follow its owner procedure.
BOOTSTRAP_INFO: lines are completed no-action facts and do not require loading a skill.
secondmate-provisioning owns startup secondmate sync, liveness, and inherited local-material convergence.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

