| name | toad-bootstrap-project |
| description | Choreograph Toad's end-to-end new-project flow — create a GitHub repo, link the local dir, scaffold with pjangler, and provision the Plane board + Hermes PM. Dry-run first, one explicit go-live gate. Use when creating and wiring a brand-new 33GOD project. |
Toad — Bootstrap a Project
Choreographs Toad's marquee flow. Each step dry-runs first; nothing with a
blast radius runs until the operator opts into live (TOAD_ALLOW_LIVE=1) and
confirms. The tools do the work; this skill sequences them and narrates.
Inputs to gather
- org — one of
AutomaticAI-io, delorenj, IntelliForia.
- name — kebab-case repo/project name.
- visibility —
public or private (default private).
- description — one line.
- dir — local directory (defaults to
~/code/<name>).
Flow
- Preview everything (dry-run). Call each tool with defaults (no
live):
git_repo_create { org, name, visibility, description } → prints the
gh repo create … plan. (net-new; pjangler cannot do this.)
project_link { dir, repoUrl } → prints the git init/remote/commit/push
plan. (net-new.)
project_init { name, dir } → dry-runs pjangler init (registry +
CommonProject scaffold + .project.json); writes nothing.
hermes_deploy { dir } → prints the pjangler hermes-agent plan (creates
the Plane board + canonical Hermes PM + Ticket Sentinel). Sprint-2 / heavy.
- Confirm. Show the operator the full ordered plan and the blast radius
(a real repo, a real board, a running agent). Get an explicit "go".
- Go live (only after confirmation): re-run steps 1–3 with
live:true /
apply:true in a shell where TOAD_ALLOW_LIVE=1. Run hermes_deploy with
live:true last, as its own decision.
- Verify.
project_audit { repo: dir } should show improved parity; the
.project.json should show a linked board.
Safety
- Never pass
live:true/apply:true before the operator confirms.
- If
TOAD_ALLOW_LIVE is unset, the tools refuse live and return the plan —
that is expected, not an error.
- Prefer
pjangler for anything it already does; only git_repo_create and
project_link are Toad-native.