Shipwright Pipeline
Overview
Shipwright converts a plain-English app description into a fully built, tested, and deployment-ready application. It delegates execution to product-agent, an autonomous 9-phase build engine available on PyPI.
Prerequisites
- Python 3.10+ available in PATH.
product-agent installed (pip install product-agent).- Node.js 18+ for JavaScript/TypeScript stacks.
Supported Stacks
- Next.js + Supabase — Full-stack with auth, database, and edge functions
- Next.js + Prisma — Full-stack with type-safe ORM
- SvelteKit — Lightweight full-stack with Svelte
- Astro — Content-focused static and hybrid sites
Instructions
- Gather the app description from the user. Ask clarifying questions if the description is vague.
- Confirm the target stack. If none specified, recommend based on the app type:
- Data-heavy with auth: Next.js + Supabase
- API-first with complex models: Next.js + Prisma
- Lightweight interactive: SvelteKit
- Content or marketing site: Astro
- Run
product-agent with the app description and selected stack.
- Monitor the 9-phase pipeline: Intake, Architecture, Scaffold, Implement, Test, Integrate, Polish, Validate, Ship.
- Report results to the user including test summary and any warnings.
Output
- A complete, buildable project directory with all source code, tests, and configuration.
- A test report summarizing pass/fail counts.
- Build verification output confirming the project compiles and starts.
Error Handling
- If
product-agent is not installed, prompt the user to install it with pip install product-agent.
- If a phase fails, report the phase name, error message, and suggested fix.
- If the selected stack is not supported, list available stacks and ask the user to choose.
Examples
Build a SaaS dashboard:
/shipwright-build Build a real-time analytics dashboard with user auth, team workspaces, and Stripe billing. Use Next.js + Supabase.
Add features to an existing project:
/shipwright-enhance Add dark mode toggle, export-to-CSV on all tables, and email notification preferences.
Scaffold a content site:
/shipwright-build Create a developer documentation site with search, versioned docs, and a blog. Use Astro.
Resources
1---2name: shipwright-pipeline3description: Autonomous app builder that converts plain-English descriptions into fully built, tested applications. Use when the user wants to build a new app, scaffold a project, generate a full-stack application, or create an app from a description. Trigger with "build me an app", "create a new app", "shipwright build", "scaffold a project", "generate an application".4license: MIT5---6# Shipwright Pipeline
7
8## Overview
9
10Shipwright converts a plain-English app description into a fully built, tested, and deployment-ready application. It delegates execution to `product-agent`, an autonomous 9-phase build engine available on PyPI.
11
12## Prerequisites
13
14- Python 3.10+ available in PATH.
15- `product-agent` installed (`pip install product-agent`).
16- Node.js 18+ for JavaScript/TypeScript stacks.
17
18## Supported Stacks
19
20- **Next.js + Supabase** — Full-stack with auth, database, and edge functions
21- **Next.js + Prisma** — Full-stack with type-safe ORM
22- **SvelteKit** — Lightweight full-stack with Svelte
23- **Astro** — Content-focused static and hybrid sites
24
25## Instructions
26
271. Gather the app description from the user. Ask clarifying questions if the description is vague.
282. Confirm the target stack. If none specified, recommend based on the app type:
29 - Data-heavy with auth: Next.js + Supabase
30 - API-first with complex models: Next.js + Prisma
31 - Lightweight interactive: SvelteKit
32 - Content or marketing site: Astro
333. Run `product-agent` with the app description and selected stack.
344. Monitor the 9-phase pipeline: Intake, Architecture, Scaffold, Implement, Test, Integrate, Polish, Validate, Ship.
355. Report results to the user including test summary and any warnings.
36
37## Output
38
39- A complete, buildable project directory with all source code, tests, and configuration.
40- A test report summarizing pass/fail counts.
41- Build verification output confirming the project compiles and starts.
42
43## Error Handling
44
45- If `product-agent` is not installed, prompt the user to install it with `pip install product-agent`.
46- If a phase fails, report the phase name, error message, and suggested fix.
47- If the selected stack is not supported, list available stacks and ask the user to choose.
48
49## Examples
50
51**Build a SaaS dashboard:**
52
53```
54/shipwright-build Build a real-time analytics dashboard with user auth, team workspaces, and Stripe billing. Use Next.js + Supabase.
55```
56
57**Add features to an existing project:**
58
59```
60/shipwright-enhance Add dark mode toggle, export-to-CSV on all tables, and email notification preferences.
61```
62
63**Scaffold a content site:**
64
65```
66/shipwright-build Create a developer documentation site with search, versioned docs, and a blog. Use Astro.
67```
68
69## Resources
70
71- [Shipwright on GitHub](https://github.com/Wynelson94/shipwright)
72- [product-agent on PyPI](https://pypi.org/project/product-agent/)
73- See `${CLAUDE_SKILL_DIR}/references/examples.md` for usage examples.
gabrielmoreira