AI workflow engine that chains 31 Claude Code skills into an autonomous feature pipeline — from idea to shipped PR.
git clone <repo-url> && cd tooiy-engine
bun install
bun run setup # Compiles skills → ~/.claude/skills/tooiy-*/Pre-compiled skills are included in skills/ for reference, but bun run setup installs them where Claude Code can find them.
The fastest path from idea to shipped code:
/tooiy-plan-and-build
Describe your idea. Tooiy will:
- Interview you to clarify requirements (
/tooiy-write-a-prd) - Break the PRD into a phased plan (
/tooiy-prd-to-plan) - File GitHub issues for each task (
/tooiy-prd-to-issues) - Implement each issue with tests (
/tooiy-conductor) - Review its own code (
/tooiy-review) - Ship PRs (
/tooiy-ship)
Or run each step manually: /tooiy-write-a-prd → /tooiy-prd-to-plan → /tooiy-prd-to-issues → /tooiy-conductor
| Skill | What it does |
|---|---|
/tooiy-write-a-prd |
Interview → PRD document → GitHub issue |
/tooiy-prd-to-plan |
Break PRD into phased vertical slices → plans/*.md |
/tooiy-prd-to-issues |
Convert plan into individual GitHub issues |
/tooiy-grill-me |
Aggressive interview to stress-test your idea |
/tooiy-triage-issue |
Analyze a GitHub issue, trace the code, plan a TDD fix |
| Skill | What it does |
|---|---|
/tooiy-new-project |
Spin up a new project from tooiy-starter |
/tooiy-new-feature |
Full scaffold: route, components, service, store, types, tests |
/tooiy-new-component |
Single component with tests |
/tooiy-new-page |
Route + page component |
/tooiy-new-form |
Form with react-hook-form + Zod validation |
/tooiy-new-api-service |
TanStack Query hooks + API fetch layer |
/tooiy-new-store |
Zustand store with typed selectors |
/tooiy-tdd |
Test-first development at pre-agreed seams: write test → make it pass |
/tooiy-diagnose-bug |
Feedback-loop-first diagnosis discipline for hard bugs |
/tooiy-prototype |
Throwaway prototype to answer one design question (logic or UI variants) |
| Skill | What it does |
|---|---|
/tooiy-review |
Two-axis parallel review: standards (bugs, smells, slop) + spec (diff vs issue/PRD) |
/tooiy-slop-scan |
Hunt AI slop: em dashes, filler phrases, comment noise, AI attribution |
/tooiy-qa |
Quality assurance checklist for feature completeness |
/tooiy-improve-architecture |
Architectural analysis + refactoring plan |
/tooiy-request-refactor |
Identify and plan targeted refactoring |
| Skill | What it does |
|---|---|
/tooiy-ship |
Pre-flight checks → create PR → update TODOS.md |
| Skill | What it does |
|---|---|
/tooiy-conductor |
Autonomous pipeline: reads TODOS.md → implement → review → ship |
/tooiy-plan-and-build |
End-to-end: idea → PRD → plan → issues → build → report |
/tooiy-advance |
Single-step executor for ralph-loop (10m intervals) |
| Skill | What it does |
|---|---|
/tooiy-delegate |
Send non-coding work to OpenClaw (Tier 3) |
| Skill | What it does |
|---|---|
/tooiy-context |
Load personal context from your Obsidian vault |
/tooiy-connect |
Find hidden connections across vault notes |
/tooiy-ideas |
Synthesize new ideas from recurring themes in notes |
/tooiy-graduate |
Promote a note fragment into a PRD, plan, or issue |
/tooiy-trace |
Trace how an idea evolved across the vault |
| Skill | What it does |
|---|---|
/tooiy-write-a-skill |
Create a new Tooiy skill template |
The hooks/ directory ships two Claude Code hooks that tooiy-starter installs into every new project (.claude/hooks/ + .claude/settings.json):
- block-dangerous.py (PreToolUse, Bash): denies catastrophic commands and converts risky ones (recursive deletes, force pushes, destructive SQL, curl-pipe-sh, publishes, prod deploys) into an explicit ask, even in auto-accept sessions
- slop-scan.py (PostToolUse, Edit/Write): flags AI slop in freshly written content and feeds the findings back so the agent fixes them immediately
See hooks/README.md for wiring details.
New feature (full pipeline):
/tooiy-plan-and-build
New feature (step by step):
/tooiy-write-a-prd → /tooiy-prd-to-plan → /tooiy-prd-to-issues → /tooiy-conductor
Quick component or page (skip planning):
/tooiy-new-component # or /tooiy-new-page, /tooiy-new-form, /tooiy-new-store, /tooiy-new-api-service
Bug fix:
/tooiy-triage-issue # analyze the issue, plan a TDD fix
/tooiy-tdd # write failing test → fix it
/tooiy-review # self-review
/tooiy-ship # create PR
Refactor:
/tooiy-request-refactor # identify what to change
/tooiy-improve-architecture # or just start coding
/tooiy-review
/tooiy-ship
Stress-test an idea before building:
/tooiy-grill-me
Autonomous background work:
/tooiy-conductor # works through TODOS.md until done
+-----------------------------------------------------+
| TIER 1: Claude Code (Interactive) |
| Deep coding, architecture, planning |
| Interface: Terminal, skills, SuperClaude |
+------------------------+----------------------------+
| spawns via Agent SDK
+------------------------v----------------------------+
| TIER 2: Agent SDK Background Workers |
| Automated PR reviews, CI watching, issue triage |
| Interface: Programmatic (Bun), event-driven |
+------------------------+----------------------------+
| delegates via MCP over Tailscale
+------------------------v----------------------------+
| TIER 3: OpenClaw (Remote Operations) |
| Marketing, content, customer comms, ops |
| Interface: WhatsApp/Slack/Telegram, autonomous |
+-----------------------------------------------------+
Skills share state through three files in each project:
| File | Tracked in git | Purpose |
|---|---|---|
TODOS.md |
Yes | Backlog of work items, managed by skills and tooiy-todos |
.tooiy/workflow.json |
No (gitignored) | Current pipeline phase, active issue, delegations |
plans/*.md |
Yes | Implementation plans from /tooiy-prd-to-plan |
| Command | Description |
|---|---|
bun run setup |
Install skills to ~/.claude/skills/tooiy-*/ |
bun run gen |
Compile templates (same as setup, also updates skills/) |
bun run gen:check |
Verify generated files are fresh (CI/pre-commit) |
bun run gen -- --dry-run |
Preview without writing |
bun run agents start |
Start webhook server on port 3847 |
bun run agents stop |
Stop the webhook server |
bun run agents status |
Show active background jobs |
bun run status |
Show workflow state for current project |
bun run todos add "desc" --issue 42 |
Add item to TODOS.md |
bun run todos complete 42 |
Move issue to Completed |
bun run todos backlog "desc" |
Add item to Backlog |
Background workers receive GitHub webhooks and run skill logic automatically:
| Worker | Trigger | Action |
|---|---|---|
| PR Review | PR opened/updated | Runs /tooiy-review checklist, posts findings |
| Issue Triager | Issue created | Explores codebase, posts TDD fix plan |
Start with bun run agents start. Configure GitHub webhook URL: http://<your-ip>:3847/webhook
Create your own skills with /tooiy-write-a-skill. Templates live in src/templates/ organized by category. Run bun run gen to compile after editing.
src/
templates/ # .md.tmpl source files (truth)
partials/ # Shared content injected into skills
planning/ # write-a-prd, prd-to-plan, etc.
development/ # new-feature, new-component, etc.
quality/ # review, qa, improve-architecture
shipping/ # ship
orchestration/ # conductor, plan-and-build, advance
meta/ # write-a-skill
openclaw/ # delegate
gen/ # Template compiler
agents/ # Agent SDK background workers
bridge/ # OpenClaw delegation helpers
skills/ # Compiled skills (mirrors ~/.claude/skills/tooiy-*/)
bin/ # CLI entry points
reference/ # Copied as-is (stack.md, tests.md, etc.)
tests/ # Bun tests
Built on the shoulders of:
- mattpocock/skills — Claude Code skill template system
- garrytan/gstack — AI-assisted development workflow patterns