shipyard/
Learn AI. Build It. Ship It.

You want to use AI, but don't know where to start?

Shipyard is an AI coach that takes you from overwhelmed to a finished project. You can do more than you think.

Three gaps the coach closes

"I don't know where to start."

The coach gives you a choice of tool to build and helps you pick one. Then you make it yours: your voice, your rules, your standard — one field at a time.

"I've never built something."

The coach walks you through each step, and helps you to get to the finish line.

"I shipped but can't explain it."

The coach walks you through writing the story — what it does, who it's for, and why you built it — so you can show your work.

Not a chatbot. A coaching protocol.

🔄

Step Protocol

Every step follows the same loop: Teach, Assign, Review, Correct, Approve. No shortcuts, no skipping ahead.

Socratic Correction

When your answer misses, the coach states why — then asks one question to surface the gap. Never lectures.

💡

Knowledge Gap Detection

Say "I don't know" and the coach stops asking. It teaches the answer plainly, then re-assigns a simpler version.

Scope Kill

The moment you expand scope, the redirect IS the turn. No bundling. Cut first, teach next.

🧱

One-at-a-Time Building

Files are built one field at a time. The coach never generates a complete artifact in one turn. You do the reps.

🚧

Gate Criteria

Every phase has exit conditions. You can't advance until you've met them. No faking progress.

Six phases from overwhelmed to shipped

0
Settle
Defuse overwhelm. Get ready to pick.
1
Pick ONE
Choose from 4 presets. Make it yours.
2
Build
Write your tool's files, field by field.
3
Run It
Test your tool on your real input.
4
Ship
Confirm it works. Declare it done.
5
Show
Write the story. Save it. Done.

A folder, not an app

Open the folder in Claude or Codex and say hello. The Coach loads itself. No API keys, no setup, no code.

shipyard/ ├── identity.md ← who the coach is + phase routing ├── rules.md ← step protocol + coaching constraints ├── examples.md ← what good coaching sounds like ├── README.md ← setup instructions └── reference/ ← phase-by-phase playbooks ├── phase-0-settle/ ├── phase-1-pick-one/ ├── phase-2-define-done/ ├── phase-3-build/ ├── phase-4-ship/ ├── phase-5-show/ ├── voice.md ← tone, vocabulary, banned phrases └── presets/ ← file-organizer, brain-dump-planner, notes, decision-helper

Watch a real session

Live Demo

Set it up yourself in 2 minutes

The live demo gives you a taste. For the full 6-phase experience, run the Coach in your own Claude or Codex session:

  1. Clone the repo: git clone https://github.com/julianargus01/shipyard.git
  2. Open the shipyard folder as a project in Claude or Codex
  3. Say hello. The Coach loads itself and starts the session.
Get the repo