# Toad Bootstrap Project

> 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.

- Skill: `delorenj/toad-bootstrap-project` (Agent Skill)
- Install (CLI): `npx skillmds@latest add delorenj/toad-bootstrap-project`
- Raw SKILL.md: https://api.skillmd.com/api/skills/delorenj/toad-bootstrap-project/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: delorenj (https://skillmd.com/u/delorenj)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/delorenj/toad-bootstrap-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

1. **Preview everything (dry-run).** Call each tool with defaults (no `live`):
   1. `git_repo_create { org, name, visibility, description }` → prints the
      `gh repo create …` plan. *(net-new; pjangler cannot do this.)*
   2. `project_link { dir, repoUrl }` → prints the git init/remote/commit/push
      plan. *(net-new.)*
   3. `project_init { name, dir }` → dry-runs `pjangler init` (registry +
      CommonProject scaffold + `.project.json`); writes nothing.
   4. `hermes_deploy { dir }` → prints the `pjangler hermes-agent` plan (creates
      the Plane board + canonical Hermes PM + Ticket Sentinel). **Sprint-2 / heavy.**
2. **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".
3. **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.
4. **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.