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

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