SpecShip is an autonomous engineering workflow that orchestrates AI agents through a recon→plan→build→validate→ship pipeline with TDD, parallel execution, adversarial validation, and spec-driven quality gates.

Stars

213

7-day growth

No data

Forks

5

Open issues

0

License

MIT

Last updated

2026-07-13

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It introduces a structured, contract-first approach to AI-driven software development with built-in testing, validation, and self-healing, aiming to produce more reliable and complete code than typical AI agents.

Who it is for

  • AI-assisted software developers
  • Engineering teams exploring autonomous development
  • Developers working on brownfield projects
  • Quality-focused teams wanting rigorous validation

Use cases

  • Rapidly building prototypes with TDD and validation
  • Reverse engineering and extending existing codebases
  • Automating full feature development from requirements to PR
  • Enforcing quality gates in AI-generated code

Strengths

  • Test-Driven Development enforced at every milestone
  • Parallel execution of independent tasks and validators for speed
  • Adversarial validation where different agents judge the code
  • Brownfield reverse engineering before planning for existing repos

Considerations

  • Requires Kiro agent infrastructure (superpowers + gstack)
  • Experimental and has not undergone external security review
  • Generated code requires AppSec review before production use
  • Dependency on Playwright MCP for browser validation

README quick start

SpecShip

A Kiro Power autonomous engineering workflow that orchestrates AI agents through a complete recon → plan → build → validate → ship pipeline — with brownfield reverse engineering, TDD, parallel execution, adversarial validation, and spec-driven quality gates.

Architecture

Editable source: docs/architecture-diagram.svg

The 4 Phases (+ Brownfield Recon)

PhaseWhat happensOutput
RECON (brownfield only)Reverse engineer existing code before planning: repo map, technology stack, components, APIs, data models, business flows, baseline tests, preserved behavior, and change impact..specship/.../artifacts/reverse-engineering/
PLANBrainstorm → market research (real web search, minimum 5 queries) → sprint contract → pre-generate test cases → implementation plan. Each step feeds the next.requirements.md + design.md + tasks.md + artifacts
BUILDExecute tasks.md milestone-by-milestone. Parallel batches for independent tasks. Every behavior follows Test-Driven Development (write failing test → watch it fail → implement → pass → commit). Hard gate blocks each milestone until typecheck + tests + build pass.Tested, committed code per milestone
VALIDATEUp to 7 adversarial validators run in parallel as independent subagents, each delegating to its gstack specialist skill (code→review, security→cso, browser→qa-only). Code, Security, Integration, Browser, Design, Alignment (always) + Load (if performance NFR exists). Each produces a typed verdict with evidence. Aggregate decides: merge / recover / escalate.Typed verdicts → merge or recover
SHIPPR + changelog + archive. Ship report with timing, bugs caught, milestone breakdown. If no git remote, prepares locally with push instructions.PR ready to merge

Why SpecShip?

AI agents build fast but shallow — working skeleton in 7 minutes, 60% of features missing, no tests, no error handling. SpecShip fixes this:

PrincipleWhat it means
Test-Driven DevelopmentNo production code without a failing test first. The build gate blocks every milestone until typecheck + tests + build all pass. Catches bugs within minutes, not hours.
Parallel executionIndependent tasks run simultaneously. A

Description

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.

Related repositories

Similar projects matched by category, topics, and programming language.

S40911120
Featured
S40911120 GitHub avatar

recensa

Recensa is a self-hosted web viewer that indexes Claude Code session transcripts into a local SQLite database, enabling full-text search, replay, and audit of all past agent conversations without uploading data anywhere.

AI & Machine LearningLarge Language Models
67
bjan
Featured
bjan GitHub avatar

claudemux

Claudemux is a lightweight, dependency-minimal message bus that lets multiple Claude Code sessions communicate in real-time over tmux, enabling one session to ask another a question and receive the answer without manual intervention.

AI & Machine LearningAI Agents
9
mereyabdenbekuly-ctrl
Featured
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI & Machine LearningAI Agents
859