sample-specship
Spec-driven autonomous engineering workflow for AI coding agents: recon → plan → build → validate → ship — with TDD, adversarial validation, and anti-slop quali
What is sample-specship?
Spec-driven autonomous engineering workflow for AI coding agents: recon → plan → build → validate → ship — with TDD, adversarial validation, and anti-slop quality gates. Packaged as a Kiro Power.
Overview of sample-specship
What it is
SpecShip is a Kiro Power autonomous engineering workflow that orchestrates AI agents through a complete recon → plan → build → validate → ship pipeline. It includes brownfield reverse engineering, test-driven development, parallel execution, adversarial validation, and spec-driven quality gates. The workflow is packaged as a Kiro Power and is designed to produce robust, tested code with minimal manual intervention.
Key features
- Test-Driven Development: No production code without a failing test first; the build gate blocks every milestone until typecheck + tests + build all pass.
- Parallel execution: Independent tasks run simultaneously; all validators fire in parallel as independent subagents.
- Adversarial validation: The agent that built the code cannot judge it; independent validators produce typed verdicts with evidence.
- Self-healing recovery: When a validator finds a bug, a fresh agent fixes it surgically — one fix per issue, regression test first, max 3 cycles.
- Contract-first: Every build starts with acceptance criteria + failure modes + design spec defined before any code and stored in
.specship/specs/. - Brownfield-safe: Existing code gets reverse-engineered before planning; the contract includes preserved behavior, local conventions, baseline tests, files likely to change, and files to avoid.
- Market research: Conducts real web searches (minimum 5 queries) to study existing products in the same category; research is saved to
.specship/specs/artifacts/market-research.md.
Use cases
- Building new applications from scratch (e.g., “build me a Kanban board”).
- Adding features to existing codebases with reverse engineering (e.g., “reverse engineer this repo before adding billing”).
- Validating code quality with adversarial validators across code, security, integration, browser, design, alignment, and load.
- Shipping code with a pull request, changelog, and archive; if no git remote, prepares locally with push instructions.
- Resuming interrupted missions with the
where was I?command.
Getting started
bash./install.shThe installer automatically detects and installs missing dependencies (superpowers + gstack), copies SpecShip steering files into ~/.kiro/steering/, and sets up Playwright MCP if not configured. To scope to a single project, run ./install.sh ./.kiro/steering.
License and pricing
Licensed under the MIT License. Open source.
Based on the project's public README and repository metadata.