jhgaylor/captain-picard-template
Watch
1
0
Fork
You've already forked captain-picard-template
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Template for captain-picard Agent on Demand bus-repos. Includes a /bootstrap Claude Code skill that seeds the operating docs.
3 commits 1 branch 0 tags 38 KiB
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Jake Gaylor 2537fa3048 Rename AoD → Fountain across template 
The orchestrator now runs on the hosted Fountain SaaS at fountain.inevitable.fyi
instead of a self-hosted Agent on Demand instance. Updated CLI invocations
(aod → fountain), env vars (AOD_* → FOUNTAIN_*), specs repo
(jhgaylor/aod-specs → jhgaylor/agent-specs), vault apiVersion (aod/v1→fountain/v1),
and rewrote the PREREQUISITES "what you need" section around the SaaS sign-up
flow (dropping the local-dev path and ravi-hq link).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-10 22:19:44 -04:00
.claude/skills/bootstrap Rename AoD → Fountain across template 2026-05-10 22:19:44 -04:00
decisions Initial template — bus-repo scaffolding for the captain-picard agent 2026-05-09 20:37:01 -04:00
.gitignore Rename AoD → Fountain across template 2026-05-10 22:19:44 -04:00
OPERATING_MODEL.md Rename AoD → Fountain across template 2026-05-10 22:19:44 -04:00
PREREQUISITES.md Rename AoD → Fountain across template 2026-05-10 22:19:44 -04:00
README.md Rename AoD → Fountain across template 2026-05-10 22:19:44 -04:00
ROADMAP.md Initial template — bus-repo scaffolding for the captain-picard agent 2026-05-09 20:37:01 -04:00

README.md

captain-picard-template

Bus-repo template for the captain-picard Fountain orchestrator.

captain-picard is the project-agnostic product engineering team lead from the jhgaylor/agent-specs fleet. It expects every product it works on to seed three files at the bus-repo root:

  • OPERATING_MODEL.md — the product, the team's roles, and the gate ladder.
  • ROADMAP.md — Now / Next / Gated lanes.
  • decisions/ — ADRs as they accumulate.

This template seeds those with <TODO> placeholders and ships an interactive /bootstrap skill for Claude Code that walks you through filling them in.

Use it

First time? This template needs captain-picard already provisioned in your Fountain workspace. If you haven't done that, do the one-time setup in PREREQUISITES.md first.

  1. Click Use this template on GitHub (top-right of the repo page) → create your bus repo under whatever owner runs the product (e.g. BinaryBourbon/birdwatcher).

  2. Clone it locally and run claude in the working tree.

  3. Type /bootstrap. The skill interviews you (product, owner, vault, specialists, gates, initial slice), fills the templates, and offers to commit and push.

  4. Run captain-picard against the bus repo:

    fountain run captain-picard --vault <project-vault> -p \
  "repo_url=https://github.com/<owner>/<repo>
   vault_name=<project-vault>
   operating_doc_path=OPERATING_MODEL.md

   begin phase 0 per ROADMAP.md."

What's in here

.
├── OPERATING_MODEL.md       # template — fill via /bootstrap
├── ROADMAP.md               # template — fill via /bootstrap
├── decisions/
│   └── 0001-template.md     # ADR template, copy when writing a real ADR
├── .claude/skills/bootstrap/
│   └── SKILL.md             # the /bootstrap skill
├── PREREQUISITES.md         # one-time agent-specs setup — survives /bootstrap
└── README.md                # this file (replaced post-bootstrap with your product's README)

After bootstrapping

The orchestrator's plan/<slice>/<role>-brief.md files appear when captain-picard dispatches its first specialist — you don't seed plan/ manually.

You should replace this README with one describing your actual product before the bus repo gets used by humans. The template README.md is meant to be deleted; the operating model and roadmap stay.