You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .agents/skills/bootstrap-diagnostics/SKILL.md
-1Lines changed: 0 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,6 @@ The inline rules in `AGENTS.md` section 3 still bind: detect, then consent, then
17
17
18
18
-`MISSING: <tool> (install: <command>)` - list the missing tools to the captain with a one-line purpose each plus the printed install commands, wait for consent (one approval may cover the list), then run `bin/fm-bootstrap.sh install <approved tools...>`.
19
19
For `treehouse`, this also covers an installed version whose `treehouse get` lacks `--lease`; treat it as an upgrade request.
20
-
For `no-mistakes`, this also covers an installed version older than 1.31.2, because crewmate validation briefs delegate gate mechanics to no-mistakes' version-matched guidance.
21
20
For `tasks-axi`, this also covers an installed build that fails the compatibility probe (`docs/configuration.md` "Backlog backend" owns the definition); `config/backlog-backend=manual` only suppresses the `TASKS_AXI: available` capability line, not this missing-tool report.
22
21
For `quota-axi`, bootstrap requires it because crew-dispatch `quota-balanced` may call it and direct account-directory selection uses it; `bin/fm-dispatch-select.sh` still degrades at runtime when quota data is unavailable.
23
22
Direct account-directory selection also requires Agent Fleet's read-only profile registry to enforce worker-pool eligibility.
Copy file name to clipboardExpand all lines: .agents/skills/firstmate-coding-guidelines/SKILL.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -75,7 +75,7 @@ Firstmate adds this skill's load instruction to firstmate-repo briefs by hand in
75
75
- Plain dash `-`, never an em dash.
76
76
- Never add an agent name as a commit co-author.
77
77
-`bin/*.sh` and `bin/backends/*.sh` must pass `shellcheck`.
78
-
- Run `bin/fm-lint.sh` before treating a script change as done; it is the single owner of the lint definition (file set, config, and pinned ShellCheck version) that CI and the no-mistakes pre-push gate use with the same full-or-focused Azure-service scope, and it refuses to run under any other ShellCheck version.
78
+
- Run `bin/fm-lint.sh` before treating a script change as done; it is the single owner of the lint definition (file set, config, and pinned ShellCheck version) used by local development and CI, and it refuses to run under any other ShellCheck version.
79
79
- Colocate tests with the existing pattern in `tests/`, name them `<subject>.test.sh`, and extend an existing script rather than inventing a new runner.
80
80
-`bin/*.py` runs under whichever `python3` is first on the invoking shell's `PATH`, which is often older than the version CI pins, so a newer-only API fails at runtime rather than in CI.
81
81
- Prefer the idiom already used across `bin/`: `os.stat(path, follow_symlinks=...)`, not the Python 3.10+ `Path.stat(follow_symlinks=...)`.
- Captain-private material: the captain's name, product strategy, unreleased plans, revenue, internal URLs, file contents, or anything the captain has not made public.
85
85
- Secrets of any kind: tokens, keys, credentials, the pairing token, hostnames.
Copy file name to clipboardExpand all lines: .agents/skills/secondmate-provisioning/SKILL.md
+2-3Lines changed: 2 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -93,13 +93,12 @@ Direct seed without a preexisting brief requires `FM_SECONDMATE_CHARTER`.
93
93
Run `bin/fm-home-seed.sh validate` when checking registry integrity; it refuses duplicate ids, duplicate homes, and nested or overlapping homes.
94
94
95
95
Seeding is transactional.
96
-
If validation, cloning, no-mistakes initialization, or registry update fails, generated briefs, new homes, new project clones, and registry edits are rolled back.
96
+
If validation, cloning, or registry update fails, generated briefs, new homes, new project clones, and registry edits are rolled back.
97
97
Home provisioning, child spawn, and retirement use one canonical home lifecycle lock.
98
98
The lock order is home lifecycle, task lifecycle, then registry; recursive retirement acquires parent homes before child homes and holds each home lock through its final state check, removal, and registry update.
99
99
100
-
Secondmate project lists may include `no-mistakes` and `direct-PR` projects only.
100
+
Secondmate project lists may include `direct-PR` projects only.
101
101
`local-only` projects stay with the main firstmate.
102
-
For `no-mistakes` projects, seeding initializes only projects newly cloned into a secondmate home and refuses to mutate a preexisting clone that is not already initialized.
Copy file name to clipboardExpand all lines: .agents/skills/stow/SKILL.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,7 +35,7 @@ The goal is a session that is safe to reset or destroy because everything durabl
35
35
- Project-intrinsic knowledge: never hand-write a project's `AGENTS.md`.
36
36
Route it through a normal ship task so a crewmate records it via `bin/fm-ensure-agents-md.sh` and commits it through that project's delivery pipeline, exactly as section 6 describes.
37
37
If the fleet is live, delegate this to a crewmate rather than doing it inline.
38
-
- Knowledge generalizable to every firstmate user: this repo's own `AGENTS.md` (or other shared, tracked material), shipped through the normal branch -> no-mistakes -> PR -> captain-merge pipeline for this repo (section 1), never hand-committed straight to `main`.
38
+
- Knowledge generalizable to every firstmate user: this repo's own `AGENTS.md` (or other shared, tracked material), shipped through the normal branch -> PR -> green CI -> exact-head Crosscheck -> approved merge pipeline for this repo (section 1), never hand-committed straight to `main`.
39
39
- Task-scoped notes: inspect the relevant backlog item with `tasks-axi show <id> --full`, judge whether the new note is new, duplicate, superseding, or obsolete, then write a considered replacement body by running `tasks-axi update <id> --body-file <path>` through `bin/fm-data-write.py --data "$FM_HOME/data" -- <command>`.
40
40
When the replacement intentionally supersedes prior state that should remain recoverable, add `--archive-body` to that update command so the prior body stays recoverable without copying it into the replacement.
Copy file name to clipboardExpand all lines: .agents/skills/stuck-crewmate-recovery/SKILL.md
+2-15Lines changed: 2 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,8 +2,8 @@
2
2
name: stuck-crewmate-recovery
3
3
description: >-
4
4
Agent-only playbook for stuck firstmate direct reports.
5
-
Use after a stale wake, permission-prompt or system-dialog suspicion, no-mistakes reattach socket read timeout, looping pane, repeated confusion, an answered-by-brief question, an unresponsive crewmate, or a failed steer.
6
-
Routes permission grants and home-scoped validation recovery before the ordinary peek, steer, interrupt, relaunch, and failed-status ladder.
5
+
Use after a stale wake, permission-prompt or system-dialog suspicion, looping pane, repeated confusion, an answered-by-brief question, an unresponsive crewmate, or a failed steer.
6
+
Routes permission handling before the ordinary peek, steer, interrupt, relaunch, and failed-status ladder.
7
7
user-invocable: false
8
8
metadata:
9
9
internal: true
@@ -16,19 +16,6 @@ Use this playbook when a direct report is stale, permission-blocked, looping, re
16
16
Load `harness-adapters` before handling a permission prompt or sending an interrupt, exit command, resume command, or harness-specific skill invocation.
17
17
The target window's harness is recorded as `harness=` in `state/<id>.meta`.
18
18
19
-
## No-mistakes reattach timeout branch
20
-
21
-
Handle an error shaped as `drive run: reconcile run ...: read response: ... socket: i/o timeout` before the ordinary ladder.
22
-
That signature means an established daemon connection missed the bounded run-snapshot response deadline; it is not evidence that the daemon stopped.
23
-
24
-
1. Run `FM_HOME=<this-firstmate-home> bin/fm-no-mistakes-reattach.sh <id>` from the active firstmate repository unless `FM_HOME` already names the active home.
25
-
2. Let the helper own retry timing and task identity checks.
26
-
It retries only the observed transient signature and requires the daemon to report running before every attempt. This read-only preflight narrows risk but cannot guarantee no start because ordinary `axi run` calls `EnsureDaemon` after the check; strict protection requires an upstream attach-only operation.
27
-
3. Treat a returned gate or outcome as the current run result and continue the ordinary validation decision or completion workflow.
28
-
4. If the helper exhausts its retries, preserve its exact final error and escalate the lane as blocked without changing daemon lifecycle state.
29
-
5. Do not use this branch for another daemon error.
30
-
Diagnose that error through the ordinary ladder and retain the shared-daemon prohibition.
31
-
32
19
## Permission-blocked branch
33
20
34
21
Handle permission evidence before the ordinary recovery ladder because approving, denying, interrupting, or relaunching can change the security decision or hide the only useful evidence.
Copy file name to clipboardExpand all lines: .agents/skills/updatefirstmate/SKILL.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,13 +9,13 @@ metadata:
9
9
# updatefirstmate
10
10
11
11
Self-update firstmate in place.
12
-
Firstmate is its own repo behind the same no-mistakes gate as any project, so shared tracked material reaches `main` and then waits for each running firstmate to pull it; `AGENTS.md` section 12 owns that material's self-update boundary.
12
+
Firstmate is its own repo, so shared tracked material reaches `main`through a green PR and exact-head Crosscheck, then waits for each running firstmate to pull it; `AGENTS.md` section 12 owns that material's self-update boundary.
13
13
Only `AGENTS.md`, `bin/`, and `.agents/skills/` are a running firstmate instruction surface; public `skills/` is installer-facing and is not loaded by firstmate.
14
14
This skill performs that pull for the running main firstmate and every secondmate, without disturbing any in-flight work.
15
15
16
16
The update is **fast-forward only** - the same sanctioned self-write as the fleet sync firstmate already runs.
17
17
It never forces, never creates a merge commit, never stashes, and advances a target only on a clean fast-forward; anything dirty, diverged, offline, or on the wrong branch is skipped and reported.
18
-
A tracked-files fast-forward leaves the gitignored operational dirs (data/, state/, config/, projects/, .no-mistakes/) untouched, so a secondmate's in-flight work is never disrupted.
18
+
A tracked-files fast-forward leaves the gitignored operational dirs (data/, state/, config/, projects/) untouched, so a secondmate's in-flight work is never disrupted.
19
19
This touches only the firstmate repo and its own worktrees, never anything under `projects/`.
0 commit comments