<p align="center"> <img src="./assets/Squid.png" alt="The Opinionated Squid Logo" /> </p>

<div align="center"> <h1>Squid: An Opinionated Software Factory for Claude Code</h1> </div>

[](LICENSE) [](https://claude.com/claude-code) [](https://github.com/iusztinpaul/squid/tags)

Claude Code writes code fast. It's worse at writing the code *your team* would actually ship — code that follows your conventions, has tests you trust, and survives review.

**Squid is a [Claude Code](https://claude.com/claude-code) plugin that turns a feature spec into a reviewed PR through a 5-agent pipeline — PA → SWE → Tester → PR Reviewer → On-Call — with exactly two human gates: plan approval and final merge.** No file templates, no render step: just markdown specs and agent contracts, and every file in your project gets written by an agent that reads them.

## How it works

Run `/squid-plan <feature-spec>` then `/squid-implement-night`, and Squid drives this end-to-end:

``` feature spec │ ▼ /squid-plan ┌──────────────────────────────────────────────────────────────┐ │ grill → PA grooms Tasks Plan (+ADR) → HUMAN approves (1/2) │ │ → branch + worktree │ └──────────────────────────────────────────────────────────────┘ │ /squid-implement-night (runs end-to-end in the worktree) ▼ ┌──────────────────────┐ ┌───────────────────┐ ┌─────────────────┐ │ /squid-implement-task│──▶ │ /squid-review │──▶ │ /squid-review-ci│ │ SWE ↔ Tester │ │ push → PA accept →│ │ On-Call drives │ │ commit each task │ │ PR-Reviewer │ │ CI to green │ └──────────────────────┘ └───────────────────┘ └─────────────────┘