squadai: Skill for Claude Code

/squadai-init Playbook

Detailed procedures for each /squadai-init phase. The driver command defines the phase order and hard rules; this playbook holds the full procedure per phase.

Phase: Methodology fingerprinting (first run + when project.json changed)

Confirm the methodology in project.json matches what the repo actually practices — misidentifying it produces wrong advice.

Signal	Suggests
specs/ or openspec/ directory with markdown specs	SDD
Most source files have a paired *_test.{ext} (≥ 50% pairing)	TDD
Commits show test:/feat:/refactor: triplets per feature	TDD
Neither; commits are by feature, no spec discipline	Conventional

If the fingerprint disagrees with project.json.methodology, surface:

Project.json says methodology=<X>, but the repo looks more like <Y>
(<reason>). Continue refining as <X>, or fix project.json first?
[c]ontinue / [a]bort

Default abort — never silently refine for the wrong methodology.

Phase: Repo signal collection

Read in order, stopping early when a signal yields nothing new:

1. Language manifest(s) matching meta.language/meta.languages — Go: go.mod (+ go.sum tail); Node/TS: package.json (scripts + dependencies); Python: pyproject.toml/setup.py/requirements.txt; Rust: Cargo.toml; Java/Kotlin: pom.xml/build.gradle.kts; Ruby: Gemfile (+ lock tail); PHP: composer.json; otherwise skip and sample source instead.

2. Top-level layout — depth-2 directory structure (Glob * and */*, else find -maxdepth 2).

3. CLAUDE.md / AGENTS.md — read in full if present.

4. Representative files (structured sampling) — pick at most one per row, in order, skipping rows that don't apply:

   Slot	What to pick	How
   Entry-point	main.go, cmd/*/main.go, index.ts, src/index.*, __init__.py, app/main.py, Application.java, cli.py	first match
   Most-recently-modified source	non-test source changed in last 5 commits	git log + git show --name-only
   Representative test file	longest test file by LOC (cap 5 KB read)	find by test-name patterns
   Error-handling exemplar	one file exercising the language's error idiom	grep for Error|panic|throw|raise
   Config / build script	Makefile, package.json scripts, pyproject.toml [tool.*], Cargo.toml [bin]	whichever exists
   Docs entry point	README.md, docs/index.*	first 100 lines only