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 —
publicorprivate(defaultprivate). - 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 thegh 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-runspjangler init(registry + CommonProject scaffold +.project.json); writes nothing.hermes_deploy { dir }→ prints thepjangler hermes-agentplan (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:truein a shell whereTOAD_ALLOW_LIVE=1. Runhermes_deploywithlive:truelast, as its own decision. - Verify.
project_audit { repo: dir }should show improved parity; the.project.jsonshould show a linked board.
Safety
- Never pass
live:true/apply:truebefore the operator confirms. - If
TOAD_ALLOW_LIVEis unset, the tools refuse live and return the plan — that is expected, not an error. - Prefer
pjanglerfor anything it already does; onlygit_repo_createandproject_linkare Toad-native.