shipwright

# Shipwright ⚓ A full-stack developer & designer agent that names itself on first run. ## What You Get - **Ticket-driven workflow** — every task gets a ticket before work starts (SQLite-backed) - **UX/UI design** — spawns a designer subagent loaded with the Impeccable suite (17 design skills) - **Autonomous execution** — chains work without waiting for permission between steps - **Parallel work** — spawns sub-agents for independent tasks - **Plans before building** — decomposes big tasks, validates assumptions early - **Memory system** — daily notes + curated long-term memory across sessions - **Picks its own name** — asks the user on first run ## Quick Start ```bash npm install -g @clawpack/cli clawpack login clawpack pull hmendes/shipwright --link ``` ## Skills ### 🎫 Ticket Manager SQLite-backed ticket CRUD. Every task = a ticket. Create → work → update → close. ### 🎨 UX Designer For any UI/UX task, spawns a specialized subagent with the full Impeccable design suite: - `i-frontend-design` — build production-grade interfaces - `i-audit` — accessibility/performance/responsive audit - `i-polish` — final quality pass - `i-animate` — purposeful animations - `i-critique` — design evaluation - `i-adapt` — responsive/cross-platform - And 11 more specialized design skills ### 🏥 Code Health Scanner One-command project health checks — no API keys needed: - **Security** — `npm audit` vulnerabilities with severity breakdown - **Dependencies** — outdated packages grouped by major/minor/patch - **Bundle size** — per-package size via Bundlephobia API - **Lighthouse** — performance, a11y, best practices, SEO scores - **Codebase stats** — files, lines, languages, disk usage - **Reports** — full scan to `HEALTH-REPORT.md` ## Philosophy 1. **Ticket first.** No exceptions. 2. **Come back with answers, not questions.** Be resourceful. 3. **Actions > words.** Ship the fix, skip the filler. 4. **Chain work autonomously.** Don't stop to ask "should I continue?" 5. **Honest > polite.** Flag the problem. Say why. Suggest the fix. ## Files | File | Purpose | |------|---------| | `SOUL.md` | Personality, values, work style, lessons learned | | `IDENTITY.md` | Name (user-chosen), vibe, strengths | | `AGENTS.md` | Workspace conventions, skill discovery, memory system | | `TOOLS.md` | Local environment notes, ticket manager reference | | `skills/` | ticket-manager + ux-designer (with Impeccable suite) | ## License MIT