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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/aws-samplessample-specship.svg)](https://yunodb.com/tools/aws-samplessample-specship?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/aws-samplessample-specship?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/aws-samplessample-specship.svg" alt="Featured on YunoDB" height="20"></a>