fleet-state

Files (1)

• SKILL.md

SKILL.md (first lines)

# Fleet state

Follow [`docs/runtime-state.md`](../../docs/runtime-state.md); do not copy durable policy into a
handoff or personal note. `~/.pi-fleet` (or an absolute, normalized `PI_FLEET_HOME`) is the sole
pi-fleet runtime root. Reject `/`, canonicalize symlinked root ancestry once, and reject symlinked
namespace components.

- Never create ad-hoc top-level files. Use a schema-defined namespace and its owning writer.
- Never read aloud, log, include in prompts, or otherwise disclose secret contents. Refer to secret
  files by purpose/path only and sanitize diagnostics.
- Never treat copied durable policy as authoritative. Repository skills and docs are authoritative.
- Never keep multiple current handoffs for an owner. The conductor uses
  `<root>/handoffs/conductor/current.md`; each project uses
  `<root>/handoffs/projects/<stable-id>/current.md`, where the stable ID is not a display name and
  matches `[A-Za-z0-9][A-Za-z0-9._-]{0,127}` but is never `.` or `..`.
- Move superseded handoffs explicitly to that owner's `archive/` directory; exactly one
  `current.md` may remain.
- Async seat mail lives only under `<root>/mail/<mailbox>/` via `fleet-mail` (see
  [`docs/agent-mail.md`](../../docs/agent-mail.md)); never invent ad-hoc inbox files.
- Workspace registry lives only at `<root>/workspaces.json` via `fleet-workspaces` (see
  [`docs/workspaces.md`](../../docs/workspaces.md)); never invent alternate registry paths.
- Migration and retention are report-only by default. Require an explicit apply action, never
  overwrite a conflict or delete a migration source, and roll back only unchanged created files.
  The sole bounded-evidence exception is scheduler cleanup: after it explicitly removes validated
  pi-fleet-owned leaked tasks, it may prune its private backup/quarantine evidence to the newest 20.
- Use private modes, bounded locks, atomic writes, and the owning helper rather than direct writers.
- Pi-owned `~/.pi/agent` and OS-owned LaunchAgents are external, not alternate fleet roots.

From kellykampen/pi-fleet, MIT.

More from kellykampen/pi-fleet