Superfleys/agent-spec
64 stars · Last commit 2026-02-23
A reusable JSON template that governs how AI coding agents build your software. Defines agent roles, coding rules, validation gates, and drift prevention. Works with Claude Code agent teams out of the box.
README preview
# AgentSpec ### A structured JSON framework for building software with AI agents — designed for consistency, not chaos. --- ## What This Is A reusable project template that turns AI coding assistants (Claude, GPT, etc.) from unpredictable autocomplete into a disciplined engineering team. Instead of dumping your entire codebase into a chat window and hoping for the best, this template gives AI agents: - **Defined roles** — separate coding, validation, and critique agents with explicit personas and output formats - **Guardrails** — coding conventions, dependency policies, and project invariants that prevent drift - **Self-correction loops** — structured validation with severity gating so bad code can't silently advance - **Session memory** — handoff protocols and decision logs so you never lose context between conversations It's the difference between "write me some code" and running an actual engineering process. ---