squid AGENTS.md

Squid: An Opinionated Software Factory for Claude Code

This repo is a Claude Code plugin. The contract layer is markdown — agents and skills. Nothing else ships; there is no build step, no test suite, no language-specific runtime tooling.

Consumers install it two ways:

1. /plugin marketplace add iusztinpaul/squid && /plugin install squid@iusztinpaul — global, all Claude Code sessions. The repo is a one-plugin marketplace (.claude-plugin/marketplace.json) named iusztinpaul (the GitHub account) cataloguing the squid plugin (the repo). The plugin's source is fixed to github:iusztinpaul/squid, so the install always fetches from GitHub even when the marketplace itself was added from a local path — relative-path plugin sources aren't supported on Claude Code v2.1.x when the marketplace lives on the local filesystem.
2. claude --plugin-dir /path/to/squid — for plugin-development sessions only; loads the plugin from the working tree without registering or installing anything.

Either way they get an opinionated agent team plus a /squid-scaffold flow that bootstraps new repos from a light spec library. The plugin's job is to teach Claude Code how to build software the way this team builds it — nothing gets shipped as scaffolded files; everything gets generated by agents that read these specs.

For users of this plugin: read README.md. This file is for people editing the plugin itself.

Key Principles You Will Respect All Over Your Work

• Prefer removing instructions over adding them; write docs, code, and rules with the minimum words that achieve the goal.
• Whenever you add a new rule within the memory (such as AGENTS.md), resources or skills, support it with a clear, concise explanation, plus a set of good and bad examples. Good examples: "a 200-token chunk size", "sub-100ms latency". Bad examples: "a powerful architecture", "a robust pipeline".

What's in the repo

.
├── .claude-plugin/
│   ├── plugin.json                    # Claude Code plugin manifest (name, version, description)
│   └── marketplace.json               # one-plugin marketplace catalog so `/plugin install squid@iusztinpaul` works
├── agents/                            # five sub-agents
│   ├── product-architect.md
│   ├── software-engineer.md
│   ├── tester.md
│   ├── pr-reviewer.md
│   └── oncall-engineer.md
├── skills/
│   ├── squid-scaffold/                # /squid-scaffold — bootstrap a new repo (create) or audit drift (evaluate)
│   │   ├── SKILL.md
│   │   ├── rules.md                   # single source of truth for scaffold rules (create + evaluate)
│   │   ├── AGENTS_TEMPLATE.md         # template body /squid-scaffold distils into each project's AGENTS.md
│   │   └── specs/                     # reference specs read by scaffold
│   ├── squid-plan/                    # /squid-plan — feature spec → approved Tasks Plan (+ worktree)
│   ├── squid-implement-task/          # /squid-implement-task — autonomous task loop (SWE↔Tester, commit each)
│   ├── squid-implement-night/         # /squid-implement-night — end-to-end pipeline (thin orchestrator)
│   ├── squid-review/                  # /squid-review — push + PA acceptance + PR-Reviewer
│   ├── squid-review-ci/               # /squid-review-ci — On-Call drives CI green
│   ├── squid-grilling/                # /squid-grilling — stress-test a plan (used inside /squid-plan; adapted from mattpocock/skills, MIT)
│   ├── squid-testing-python/          # test-writing conventions
│   ├── squid-self-improve/            # end-of-session corrections capture (human-gated by /squid-implement-night)
│   ├── squid-refactor/                # /squid-refactor — standalone refactor planner (not wired into the pipeline)
│   ├── squid-triage-issue/            # /squid-triage-issue — standalone bug intake (not wired into the pipeline)
│   ├── squid-architecture-review/     # /squid-architecture-review — standalone audit (not wired into the pipeline)
│   ├── squid-clean-docs/              # /squid-clean-docs — standalone prose cleanup: docs, comments, docstrings (not wired into the pipeline)
│   ├── squid-clean-memory/            # /squid-clean-memory — standalone memory-file shrink: compress, dedupe, merge (not wired into the pipeline)
│   ├── squid-clean-harness/           # /squid-clean-harness — standalone .agents shrink: skills + resources, same logic fewer tokens (not wired into the pipeline)
│   └── squid-write-skill/             # /squid-write-skill — skill-authoring reference (vendored from mattpocock/skills, MIT; not wired into the pipeline)
├── LICENSE
├── README.md                          # user-facing (install + what's inside)
├── AGENTS.md                          # (this file; CLAUDE.md symlinks to it)
└── .gitignore