openmove/engineering-design-playbook / .agents/skills/design-docs-template/bootstrap
docs-template-bootstrap
UnverifiedBootstraps a new OpenMove design-docs repository from openmove/engineering-design-playbook (RFC, ADR, arc42, Starlight) and leaves agent skills inside the new repo. Day-zero scaffolding — the user should not clone templates by hand. Invoked via design-docs-template.
bootstrap — new docs repo
What: Create a docs project from the GitHub template; rebrand site config; ensure agent skills are present in the new repo.
When: Day zero — empty idea, new product docs, “scaffold the docs stack.”
Not: Writing architecture content; that comes after day-one pointers.
Promise
The human installs only this skill, then runs bootstrap. You create the full repo (including .cursor / .claude / .agents skills). Do not ask them to clone the template manually.
Process
1. Collect inputs
Ask only what is missing (one batch):
- Project name (folder + GitHub repo name)
- Parent directory (default: current workspace parent, or
~/Projects) - Visibility (
privatedefault) - GitHub owner (user or org; default: authenticated
ghuser) - Site
basepath (default:/<repo-name>) - Create GitHub remote? (default yes — required for the polished path)
- Template flavour: default
openmove/engineering-design-playbook. Usealessandroros/design-docs-templateonly if the user asks for the generic upstream.
2. Create the repo (GitHub template)
Default path — remote yes and gh available:
gh repo create <owner>/<name> --template <template-owner>/<template-repo> --private --clone
Use --public if they asked. cd into the clone.
The template already includes the skill trees. Confirm:
.cursor/skills/design-docs-template/SKILL.md.claude/skills/design-docs-template/SKILL.md.agents/skills/design-docs-template/SKILL.md
If any path is missing, copy from the skill directory you are executing (parent of this bootstrap/ folder) into all three destinations in the new repo.
Fallback only if gh / template create fails: tell them why, then offer (1) fix auth and retry, or (2) local copy from an existing template clone / degit of the template repo — never lead with (2).
Completion: working tree with docs/, website/, README.md, and the three skill paths.
3. Rebrand the site config
Edit website/site.config.mjs (or equivalent):
site— Pages origin (ask if unknown; placeholder OK)base—/<repo-name>unless they chose otherwiserepoUrl— the new GitHub URL
Update root README.md title/one-liner to the real project. Leave arc42/ADR/RFC templates intact; do not invent domain content.
4. Install and smoke-check
npm install --prefix website
npm run sync --prefix website # if the script exists
Offer preview (or start dev) only if they want localhost now.
5. Day-one pointer
Fill later (do not fill unless asked):
- arc42 §1 goals
- arc42 §3 + C4 context
- arc42 §4 strategy
- arc42 §5 + C4 containers
- first new-adr / new-rfc when trade-offs appear
6. Hand off
Summarise: path, remote URL, base, that skills are already in the repo, next command (preview or start writing). No commit unless they ask.
Hard rules
- Do not overwrite a non-empty project directory without explicit confirm.
- Do not invent ADRs/RFCs for the new domain.
- Prefer
gh repo create --templateover any manual clone narrative. - After bootstrap, the new repo must be usable with Cursor, Claude, Codex, and Pi without a second skill install.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |