{"id":43743406,"url":"https://github.com/stefan-stepzero/shipkit","last_synced_at":"2026-02-28T08:16:26.275Z","repository":{"id":336211308,"uuid":"1120334711","full_name":"stefan-stepzero/shipkit","owner":"stefan-stepzero","description":"Shipkit — AI-assisted product development framework for Claude Code. Skills, agents, and workflows for shipping MVPs fast.","archived":false,"fork":false,"pushed_at":"2026-02-28T04:58:01.000Z","size":2985,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-28T05:43:17.966Z","etag":null,"topics":["ai-tools","anthropic","claude","claude-code","claude-skills","developer-tools","framework"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stefan-stepzero.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-21T01:32:03.000Z","updated_at":"2026-02-28T04:57:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/stefan-stepzero/shipkit","commit_stats":null,"previous_names":["stefan-stepzero/shipkit"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/stefan-stepzero/shipkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefan-stepzero%2Fshipkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefan-stepzero%2Fshipkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefan-stepzero%2Fshipkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefan-stepzero%2Fshipkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stefan-stepzero","download_url":"https://codeload.github.com/stefan-stepzero/shipkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stefan-stepzero%2Fshipkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29928399,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"online","status_checked_at":"2026-02-28T02:00:07.010Z","response_time":90,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-tools","anthropic","claude","claude-code","claude-skills","developer-tools","framework"],"created_at":"2026-02-05T12:09:04.123Z","updated_at":"2026-02-28T08:16:26.263Z","avatar_url":"https://github.com/stefan-stepzero.png","language":"Python","readme":"# Shipkit - Streamlined Product Development Framework\n\nA focused collection of **Claude Code skills** for efficient product development, from discovery to shipped code.\n\n**\u003c!-- sync:skill_count --\u003e37\u003c!-- /sync:skill_count --\u003e skills** organized for streamlined workflow:\n\u003c!-- sync:readme_summary --\u003e- **Vision \u0026 Discovery** (8) - why-project, product-discovery, project-context, ...\n- **Spec \u0026 Planning** (4) - spec, feedback-bug, plan, ...\n- **Knowledge \u0026 Memory** (5) - architecture-memory, data-contracts, integration-docs, ...\n- **Execution** (7) - build-relentlessly, test-relentlessly, lint-relentlessly, ...\n- **Quality \u0026 Communication** (9) - verify, preflight, scale-ready, ...\n- **System** (3) - update, get-skills, get-mcps\u003c!-- /sync:readme_summary --\u003e\n\nPlus **\u003c!-- sync:agent_count --\u003e9\u003c!-- /sync:agent_count --\u003e agent personas** that specialize behaviors for different workflow stages.\n\n---\n\n## What's Inside\n\n### Skills (\u003c!-- sync:skill_count --\u003e37\u003c!-- /sync:skill_count --\u003e total)\n\nAll skills use the `shipkit-` prefix for clarity.\n\n**Core Workflow (5 skills):**\n- `shipkit-master` - Meta skill for workflow orchestration\n- `shipkit-project-status` - Health check and gap analysis\n- `shipkit-project-context` - Codebase scanning, stack detection\n- `shipkit-codebase-index` - Semantic codebase indexing\n- `shipkit-claude-md` - CLAUDE.md management\n\n**Discovery \u0026 Planning (9 skills):**\n- `shipkit-why-project` - Strategic vision definition\n- `shipkit-product-discovery` - Personas, journeys, user needs\n- `shipkit-product-definition` - Product blueprint (features, patterns, differentiators)\n- `shipkit-engineering-definition` - Engineering blueprint (mechanisms, components, stack)\n- `shipkit-goals` - Success criteria \u0026 stage gates\n- `shipkit-spec` - Feature specification\n- `shipkit-feedback-bug` - Process feedback into investigated bug specs (5 Whys root cause)\n- `shipkit-plan` - Implementation planning\n- `shipkit-thinking-partner` - Think through decisions with cognitive frameworks\n\n**Implementation (3 skills):**\n- `shipkit-architecture-memory` - Decision logging\n- `shipkit-data-contracts` - Type definitions (Zod patterns)\n- `shipkit-integration-docs` - Integration patterns\n\n**Execution (7 skills):**\n- `shipkit-test-cases` - Generate code-anchored test case specs\n- `shipkit-build-relentlessly` - Build until compiles\n- `shipkit-test-relentlessly` - Test until green\n- `shipkit-lint-relentlessly` - Lint until clean\n- `shipkit-implement-independently` - Parallel implementation in isolated worktree\n- `shipkit-team` - Create agent team from implementation plan for parallel execution\n- `shipkit-cleanup-worktrees` - Clean up stale implementation worktrees\n\n**Quality \u0026 Documentation (10 skills):**\n- `shipkit-verify` - QA and acceptance criteria\n- `shipkit-preflight` - MVP production readiness audit\n- `shipkit-scale-ready` - Scale \u0026 enterprise readiness audit\n- `shipkit-prompt-audit` - LLM prompt architecture audit\n- `shipkit-semantic-qa` - Semantic QA for API outputs and UI screenshots\n- `shipkit-qa-visual` - Visual QA with Playwright: UI goals + autonomous test generation\n- `shipkit-ux-audit` - UX analysis and patterns\n- `shipkit-user-instructions` - User-facing documentation\n- `shipkit-communications` - Communication and formatting\n- `shipkit-work-memory` - Session memory and context\n\n**System (3 skills):**\n- `shipkit-update` - Install or update Shipkit from GitHub\n- `shipkit-get-skills` - Discover and install Claude Code skills\n- `shipkit-get-mcps` - Discover and install MCP servers\n\n*System infrastructure (not counted — auto-triggered, not user-invocable):*\n- `shipkit-detect` - Pattern detection and queue creation (hook infrastructure)\n\n### Agent Personas (\u003c!-- sync:agent_count --\u003e9\u003c!-- /sync:agent_count --\u003e)\n\n\u003c!-- sync:readme_agent_table --\u003e| Agent | Used For |\n|-------|----------|\n| `shipkit-project-manager-agent` | Coordination \u0026 context |\n| `shipkit-product-owner-agent` | Vision \u0026 requirements |\n| `shipkit-ux-designer-agent` | UI/UX design |\n| `shipkit-architect-agent` | Technical decisions |\n| `shipkit-implementer-agent` | Code implementation |\n| `shipkit-implement-independently-agent` | Isolated parallel implementation |\n| `shipkit-reviewer-agent` | Code review \u0026 quality |\n| `shipkit-researcher-agent` | Research \u0026 analysis |\n| `shipkit-thinking-partner-agent` | Cognitive discussion \u0026 thinking partner |\u003c!-- /sync:readme_agent_table --\u003e\n\n---\n\n## Quick Start\n\n### Installation\n\n```bash\ncd your-project\nnpx shipkit-dev init\n```\n\n\u003e **Pre-publish note:** Until the npm package is published, use:\n\u003e `npx github:stefan-stepzero/shipkit init`\n\nAdd `-y` for non-interactive mode (uses sensible defaults): `npx shipkit-dev init -y`\n\n**Update an existing installation:**\n```bash\nnpx shipkit-dev update\n```\n\n\u003cdetails\u003e\n\u003csummary\u003eAlternative: Python installer\u003c/summary\u003e\n\n```bash\ncurl -O https://raw.githubusercontent.com/stefan-stepzero/shipkit/main/installers/install.py\npython install.py --from-github\n```\n\u003c/details\u003e\n\nThe installer will:\n- Install all \u003c!-- sync:skill_count --\u003e37\u003c!-- /sync:skill_count --\u003e skills\n- Set up \u003c!-- sync:agent_count --\u003e9\u003c!-- /sync:agent_count --\u003e agent personas\n- Configure session hooks\n- Create `.shipkit/` workspace\n\n### After Installation\n\nYour project will have:\n```\nyour-project/\n├── CLAUDE.md                    # User preferences \u0026 learnings (editable)\n├── .claude/\n│   ├── settings.json            # Permissions + hooks\n│   ├── rules/\n│   │   └── shipkit.md           # Framework rules (managed by /shipkit-update)\n│   ├── skills/                  # 37 skill definitions\n│   ├── agents/                  # 9 agent personas\n│   └── hooks/                   # Session hooks\n└── .shipkit/                    # Your workspace\n    ├── specs/                   # Feature specifications\n    ├── plans/                   # Implementation plans\n    └── [context files...]       # Stack, architecture, etc.\n```\n\n### Basic Workflow\n\n```\n/shipkit-why-project         → Define vision \u0026 purpose (new projects)\n    ↓\n/shipkit-product-discovery   → Personas, pain points, journeys\n    ↓\n/shipkit-product-definition  → Product blueprint (features, patterns, differentiators)\n    ↓\n/shipkit-engineering-definition → Engineering blueprint (mechanisms, components)\n    ↓\n/shipkit-goals               → Success criteria \u0026 stage gates (feature phasing)\n    ↓\n/shipkit-spec                → Create feature specification\n    ↓\n/shipkit-plan                → Generate implementation plan\n    ↓\n(implement)                  → Build the feature (natural capability)\n    ↓\n/shipkit-verify              → Verify quality before commit\n    ↓\n/shipkit-work-memory         → Checkpoint progress for next session\n```\n\n\u003e **Shortcut:** If you already know what to build, skip straight to `/shipkit-spec`. The discovery chain (why → discovery → product-definition → engineering-definition → goals) is most valuable for new products or when exploring problem space.\n\n---\n\n## How It Works\n\n### 1. Session Hooks Enforce Skills\n\nWhen Claude Code starts:\n1. Runs session-start hook\n2. Loads `shipkit-master` into context\n3. Skills become the primary workflow method\n\n### 2. Context Lives in `.shipkit/`\n\nYour project context is stored in:\n```\n.shipkit/\n├── specs/               # Feature specifications\n├── plans/               # Implementation plans\n├── architecture.json    # Architecture decisions\n├── stack.json           # Technology stack\n├── implementations.json   # What's been built\n└── contracts.json       # Data contracts\n```\n\n### 3. Skills Chain Together\n\nSkills naturally flow from one to another:\n\n```\n/shipkit-why-project → Defines vision\n    → /shipkit-product-discovery → Understands users\n    → /shipkit-product-definition → Defines what to build\n    → /shipkit-engineering-definition → Designs how to build it\n    → /shipkit-goals → Defines success criteria \u0026 phasing\n    → /shipkit-spec → Creates feature spec\n    → /shipkit-plan → Generates implementation plan\n    → (implement) → Builds the feature\n    → /shipkit-verify → Checks quality\n```\n\n---\n\n## Repository Structure\n\n```\nshipkit/\n├── cli/                             # npx CLI (zero dependencies)\n│   ├── bin/shipkit.js               # Entry point\n│   └── src/                         # Commands, prompts, utilities\n│\n├── install/                         # Everything that gets installed\n│   ├── skills/                      # \u003c!-- sync:skill_count --\u003e37\u003c!-- /sync:skill_count --\u003e shipkit-* skill definitions\n│   ├── agents/                      # \u003c!-- sync:agent_count --\u003e9\u003c!-- /sync:agent_count --\u003e shipkit-*-agent personas\n│   ├── rules/\n│   │   └── shipkit.md               # Framework rules (auto-loaded)\n│   ├── profiles/\n│   │   └── shipkit.manifest.json    # Skill manifest\n│   ├── settings/\n│   │   └── shipkit.settings.json    # Permissions + hooks\n│   ├── claude-md/\n│   │   └── shipkit.md               # CLAUDE.md template (user-editable)\n│   ├── shared/\n│   │   ├── hooks/                   # Session hooks\n│   │   └── scripts/                 # Shared utilities\n│   └── templates/                   # Queue templates\n│\n├── installers/                      # Alternative installers\n│   ├── install.py                   # Python installer (legacy)\n│   └── uninstall.py                 # Uninstaller\n│\n├── docs/                            # Documentation\n│   ├── getting-started.md\n│   ├── architecture.md\n│   ├── skill-reference.md\n│   └── creating-skills.md\n│\n├── package.json                     # npm package config\n└── README.md                        # This file\n```\n\n---\n\n## Key Features\n\n### Streamlined Workflow\n- \u003c!-- sync:skill_count --\u003e37\u003c!-- /sync:skill_count --\u003e focused skills\n- All skills use `shipkit-` prefix for clarity\n- Context stored in single `.shipkit/` folder\n- No complex workspace structure\n\n### Specification-Driven\n- Features start with `/shipkit-spec`\n- Plans reference specs\n- Implementation follows plans\n- Quality checks verify alignment\n\n### Session Persistence\n- `/shipkit-work-memory` maintains context\n- `/shipkit-project-context` detects your stack\n- Context files persist between sessions\n\n### Natural Capabilities\nImplementation, debugging, testing, refactoring, and code documentation are **natural Claude capabilities** that don't need skills. Skills focus on:\n- Human decisions that must be explicit\n- Persistence that survives sessions\n\n---\n\n## Common Workflows\n\n### New Feature\n```bash\n/shipkit-spec \"Add user authentication\"\n/shipkit-plan\n# implement the feature\n/shipkit-verify\n```\n\n### Explore Codebase\n```bash\n/shipkit-project-context\n/shipkit-project-status\n```\n\n### Document Architecture\n```bash\n/shipkit-architecture-memory\n```\n\n### Get External Resources\n```bash\n/shipkit-get-skills     # Find Claude Code skills\n/shipkit-get-mcps       # Find MCP servers\n```\n\n---\n\n## Updating\n\n```bash\nnpx shipkit-dev update\n```\n\nOr use the `shipkit-update` skill from within Claude Code:\n```bash\n/shipkit-update\n```\n\nThis preserves your `.shipkit/` context files and custom settings while updating skill definitions.\n\n---\n\n## License\n\nMIT License\n\n---\n\n**Ready to ship faster?**\n\n```bash\nnpx shipkit-dev init\n```\n\n**Streamlined product development, guided by AI.**\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefan-stepzero%2Fshipkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstefan-stepzero%2Fshipkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstefan-stepzero%2Fshipkit/lists"}