| name | setup-autonomous-fleet |
| description | User-invoked setup only — do not auto-activate. Configure a repo for autonomous-fleet: runtime adapter, branch prefix, default campaign bundle, optional community installs. Run when the user says setup autonomous fleet, configure fleet, or first fleet run on a repo. |
| license | MIT |
| compatibility | Requires git; gh CLI recommended for PR workflows |
| metadata | {"author":"ravidsrk","version":"1.1.3","fleet-component":"setup"} |
Setup autonomous-fleet
Scaffold per-repo fleet configuration so coordinators, fleet-program, and missions start
with consistent defaults. Prompt-driven — explore, confirm with the user, then write.
Process
1. Explore
Read what already exists; do not assume:
git rev-parse --show-toplevel, git remote -v, default branch
CLAUDE.md / AGENTS.md — existing agent sections?
docs/agents/fleet-config.md — prior setup output?
DECISIONS.md — recorded BRANCH_PREFIX or adapter choice?
.agents/skills/ or host skill dirs — which fleet skills are installed?
gh auth status — PR workflow available?
2. Present findings — one section at a time
Walk the user through the sections sequentially — A–C are decisions, D is an
optional install, E is detect-and-record only. Each section: short explainer,
choices, default.
Section A — Runtime adapter.
Which host will run fleet coordinators? This picks the adapter skill that maps engine
primitives to real commands.
| Choice | Adapter skill |
|---|
| Orca (recommended) | autonomous-fleet-adapter-orca |
| Grok Build | autonomous-fleet-adapter-grok |
| Claude Code | autonomous-fleet-adapter-claude-code |
| OpenAI Codex | autonomous-fleet-adapter-codex |
Default: Orca — reference runtime with structural build-blind review and native orchestration.
Use another adapter only when Orca is unavailable.
Section B — Branch prefix.
Fleet missions branch as <prefix><task-slug>. Default derives from git user.name
(slugified) or fleet/.
Confirm override or accept default (fleet/ or slugified maintainer name).
Section C — Default bundle.
When intent is vague, which fleet-program preset should the umbrella suggest?
| Bundle | Preset | When |
|---|
| Fix my repo | repo-health | Docs/tests/cleanup pass |
| Ship safely | ship-with-proof | Pre-merge hardening |
| Finish product | align-then-ship | Tier 3 — explicit only |
| Production check | quality-gate | Readiness without full doc-sync |
| Single mission | none | User always names a mission |
Default: repo-health.
Section D — Community skills (optional).
Third-party skills attach as Optional/Worker only — see community-skills.md. Install per
bundle, not the full catalog. Gstack-derived missions declare community-recommends with
mode: warn; preflight-community.sh prints hints when bundles are absent.
Ask which bundle ids apply (gstack-browser, gstack-security, gstack,
agent-skills, mattpocock). Map the default campaign preset (Section C) to bundles when
obvious (e.g. quality-gate → gstack-browser). Record choices in fleet-config.md; do not
install without user consent.
When the user confirms, print or run:
./scripts/install-community.sh <bundle-id> --dry-run
./scripts/install-community.sh <bundle-id> --execute --host <adapter-host>
Section D2 — Authorship mode.
How should fleet commits record agent involvement? Default attributed:
commits are authored as the maintainer AND carry a Co-Authored-By trailer
naming the agent — transparent provenance. Choose maintainer-only only if
this repo's contribution policy forbids trailers; that choice is recorded.
Section E — Substrate path (no user decision; detect and record).
Resolve where the Python verification substrate lives and record it as
SUBSTRATE_PATH in fleet-config.md:
- Framework clone (
./scripts/validate_run_archive.py exists) → scripts/.
- Skills-install →
.agents/skills/autonomous-fleet-core/assets/substrate/
(ships with autonomous-fleet-core; version pinned in its
substrate-manifest.json).
- Neither present → record
SUBSTRATE_PATH: none and note that the four
verification layers run as prose-only disciplines until the core skill is
installed.
Offer to install the substrate's Python deps into the repo's environment
(python3 -m pip install -r <SUBSTRATE_PATH>/requirements.txt) — ask before
touching any environment.
Also probe for a published docs-site toolchain (docusaurus.config.,
mkdocs.yml, docs/conf.py, starlight in astro.config.) and record
LEDGER_DIR accordingly (.fleet/docs/ when found, else docs/) — fleet
ledgers must never break or publish through a site build.
Also probe which research tools exist on this host (monid on PATH, a
Context7/library-docs MCP, a deep-research-class skill) and record them as
RESEARCH_TOOLS in fleet-config.md; record native-web when none are
found (engine-workers.md RESEARCH DISCIPLINE resolves through this field first).
3. Confirm draft
Show draft of:
Let the user edit before writing.
4. Write
Pick host doc: edit CLAUDE.md if present, else AGENTS.md, else ask which to create.
Update ## Autonomous fleet in-place if it exists — no duplicate blocks.
Write docs/agents/fleet-config.md.
Append a one-line setup record to DECISIONS.md with adapter, prefix, bundle, date.
5. Install skills (if missing)
First detect install mode — the helper scripts only exist in a framework clone, not in a
skills-installed repo (npx skills copies only skills/ into .agents/skills/, never
scripts/):
if [ -f ./scripts/install-skills.sh ]; then echo clone; else echo skills-install; fi
Skills-install mode (no ./scripts/) — the common case. Print npx skills commands; do
not reference ./scripts/*, which is not shipped here:
npx skills@1.5.12 add https://github.com/ravidsrk/autonomous-fleet \
--skill setup-autonomous-fleet \
--skill autonomous-fleet \
--skill autonomous-fleet-core \
--skill fleet-program \
--skill autonomous-fleet-adapter-<chosen> \
--skill doc-sync \
-y
Clone mode (./scripts/install-skills.sh present) — contributor path:
./scripts/install-skills.sh --all
./scripts/install-skills.sh autonomous-fleet fleet-program autonomous-fleet-core \
autonomous-fleet-adapter-<chosen> doc-sync
For community bundles, print install commands from
skills/autonomous-fleet-core/references/community-skills.md.
6. Verify
Skills-install mode (no ./scripts/) — there is no ./scripts/run-campaign.sh to call.
Confirm the install instead: the listed skills now resolve under .agents/skills/, and the
chosen adapter is among them. Drive the first run interactively from the agent's chat
(/setup-autonomous-fleet is done; invoke a mission or fleet-program next).
Clone mode — suggest a headless dry-run:
./scripts/run-campaign.sh <adapter-runtime> --preset <bundle> --dry-run
After setup
Coordinators read docs/agents/fleet-config.md during SELF-ORIENTATION (override defaults
there over engine defaults when present). Re-run this skill when changing adapter, prefix, or
default bundle.