[ e-networld.de ]

Squad-Spec-Repository-Template

Template for spec-driven development with AI agents: a shared squad, one rule set for Claude, Codex and Copilot, and profiles for .NET, Go and Node.

MITClaude Code · Codex · GitHub Copilot · .NET · Go · Node
Flow from plan through test, code and review to the pull request

Overview

The Squad-Spec-Repository-Template bundles everything a repository needs to work with AI agents: a team of fixed roles, a single rule set and the scaffolding for documentation and GitHub. It consists of a stack-neutral core plus one profile per technology stack. It is not used through GitHub’s “Use this template” button; the adopt-template skill applies it to an existing or new repository and refreshes it there later.

The squad runs through the skills squad-issue for bug fixes and squad-spec for new features. The flow: plan, challenge, security review, tests first, implementation to at least 80 % coverage, format and analyzer gate, review loop, Lead approval and finally the pull request.

CLAUDE.md for Claude Code, AGENTS.md for Codex and .github/copilot-instructions.md for GitHub Copilot are identical from their first ## heading on. The same goes for the skills create-pr, review-pr, squad-issue and squad-spec, which exist in all three environments.

Files in a target repository come in three kinds: managed files are overwritten on every refresh, marked files are rebuilt and keep their project blocks, and seed files are written once and never touched again. That keeps the core stack-neutral and means project-specific knowledge survives a refresh. Placeholders of the form {{TODO: …}} make config-check.py fail until they are filled in.

Features

Squad of Lead, Devil's Advocate, Security, Tester, Dev, Code Officer and Reviewer
Skills squad-issue for bug fixes and squad-spec for new features
One rule set for three agents, CLAUDE.md, AGENTS.md and the Copilot instructions are identical
Quality gates before the pull request for format, analyzer and at least 80 % test coverage
Profiles for .NET, Go and Node with the matching formatter, analyzer and coverage format
Documentation scaffolding with contributing guide, architecture, decision records and spec templates
GitHub scaffolding with PR and issue templates, CI, CodeQL and Dependabot
Repeatable refresh through the adopt-template skill, project-specific content is kept

Releases

All releases on GitHub ↗