Commands Cheatsheet

Quick reference for every SNIPER command. Jump to a command or browse by category.

Quick Lookup

Command	Description	Gate
`init`	Scaffold `.sniper/` directory and config	--
`ingest`	Reverse-engineer artifacts from existing code	FLEXIBLE
`discover`	Research market, risks, and users	FLEXIBLE
`plan`	Produce PRD, architecture, UX spec, security	STRICT
`solve`	Shard PRD into epics and stories	FLEXIBLE
`sprint`	Implement stories with parallel dev team	STRICT
`review`	Run the review gate for the current phase	per-phase
`feature`	Scoped mini-lifecycle for a single feature	FLEX / STRICT
`debug`	Structured bug investigation	FLEXIBLE
`audit`	Refactor, review, test, security, or perf audit	varies
`workspace`	Multi-repo workspace management	varies
`compose`	Assemble a spawn prompt from persona layers	--
`doc`	Generate or update project documentation	FLEXIBLE
`status`	Show lifecycle status and artifact state	--
`memory`	Manage conventions, anti-patterns, decisions	--

Lifecycle Commands

`init`

Scaffold the .sniper/ directory and walk through interactive project configuration.

Phase	Setup
Team	None (single agent)
Outputs	`.sniper/config.yaml` · `.sniper/` directory tree · `CLAUDE.md`
Gate	--
Reference	Full command reference

`ingest`

Reverse-engineer project purpose, architecture, and conventions from an existing codebase.

Phase Ingest

Team ingest (3 members)

Members

Name	Process	Technical	Cognitive
code-archaeologist	code-archaeologist	--	systems-thinker
architecture-cartographer	architecture-cartographer	backend	systems-thinker
convention-miner	convention-miner	--	systems-thinker

Outputs docs/brief.md · docs/architecture.md · docs/conventions.md

Gate FLEXIBLE · ingest-review

Coordination Parallel (no dependencies)

Reference Full command reference

`discover`

Research the market landscape, assess technical and business risks, and study target users.

Phase Discover

Team discover (3 members)

Members

Name	Process	Technical	Cognitive
analyst	analyst	--	systems-thinker
risk-researcher	analyst	infrastructure	devils-advocate
user-researcher	analyst	--	user-empathetic

Outputs docs/brief.md · docs/risks.md · docs/personas.md

Gate FLEXIBLE · discover-review

Coordination Parallel (no dependencies)

Reference Full command reference

`plan`

Produce a PRD, system architecture, UX specification, and security analysis. Uses Opus-class models.

Phase Plan

Team plan (4 members)

Members

Name	Process	Technical	Cognitive
product-manager	product-manager	api-design	systems-thinker
architect	architect	backend	security-first
ux-designer	ux-designer	frontend	user-empathetic
security-analyst	architect	security	security-first

Outputs docs/prd.md · docs/architecture.md · docs/ux-spec.md · docs/security.md

Gate STRICT · plan-review

Dependencies architect, ux-designer, security-analyst all blocked by product-manager (PRD first)

Plan approval architect must present approach before writing

Model Opus

Reference Full command reference

`solve`

Break the PRD into epics and self-contained stories with acceptance criteria.

Phase	Solve
Team	Single agent (no team spawned)
Agent	[scrum-master](/reference/personas/process/scrum-master) · [systems-thinker](/reference/personas/cognitive/systems-thinker)
Outputs	`docs/epics/.md` · `docs/stories/.md`
Gate	FLEXIBLE
Reference	Full command reference

`sprint`

Implement stories with a parallel development team. Members are drawn from a pool based on story ownership.

Phase

Sprint

Team

sprint (2--5 from pool)

Members

Name	Process	Technical	Cognitive	Model	Owns
backend-dev	developer	backend	systems-thinker	Sonnet	backend
frontend-dev	developer	frontend	user-empathetic	Sonnet	frontend
infra-dev	developer	infrastructure	systems-thinker	Sonnet	infrastructure
ai-dev	developer	ai-ml	performance-focused	Opus	ai
qa-engineer	qa-engineer	backend	devils-advocate	Sonnet	tests

Outputs

Source code · test files

Gate

STRICT

Coordination

backend <-> frontend · backend <-> ai · backend <-> qa

Note

qa-engineer is always included. Other members are spawned on demand based on story ownership.

Reference

Full command reference

`review`

Run the review gate for the current phase. Evaluates artifacts against the phase checklist.

Phase	Any (runs the gate for whichever phase is active)
Team	None (single agent)
Outputs	Review report with PASS / WARN / FAIL per criterion
Gate	Determined by current phase
Reference	Full command reference

Extended Commands

`feature`

Scoped mini-lifecycle for a single feature: brief, spec, architecture delta, stories, then sprint.

Phase Feature (multi-phase)

Team feature-plan (2 members) + sprint team

Planning members

Name	Process	Technical	Cognitive
feature-pm	product-manager	--	systems-thinker
feature-architect	architect	backend	systems-thinker

Outputs docs/features/SNPR-{XXXX}/spec.md · arch-delta.md · stories · source code

Gate FLEXIBLE (planning) · STRICT (sprint)

Dependencies feature-architect blocked by feature-pm

Plan approval feature-architect must present approach before writing

Model Opus

Reference Full command reference

`debug`

Structured investigation of a bug with parallel log analysis and code tracing.

Phase Debug

Team debug (2 members)

Members

Name	Process	Technical	Cognitive
log-analyst	log-analyst	--	devils-advocate
code-investigator	code-investigator	backend	systems-thinker

Outputs docs/bugs/BUG-{NNN}/investigation.md

Gate FLEXIBLE · debug-review

Coordination Parallel (no dependencies)

Reference Full command reference

`audit`

Run a targeted audit. The --target flag determines the team and scope.

`audit --target refactor`

Scope a refactoring effort with impact analysis and migration planning.

Phase	Refactor
Team	Single-agent phases (no team spawned)
Agents	Impact analysis: [impact-analyst](/reference/personas/process/impact-analyst) · [devils-advocate](/reference/personas/cognitive/devils-advocate) Migration planning: [migration-architect](/reference/personas/process/migration-architect) · [backend](/reference/personas/technical/backend) · [systems-thinker](/reference/personas/cognitive/systems-thinker)
Outputs	Scope assessment · migration plan · stories
Gate	FLEXIBLE · refactor-review

`audit --target review --pr N`

Automated code review of a pull request.

Phase PR Review

Team review-pr (3 members)

Members

Name	Process	Technical	Cognitive
code-reviewer	code-reviewer	--	devils-advocate
security-reviewer	code-reviewer	--	security-first
test-reviewer	qa-engineer	--	systems-thinker

Outputs docs/reviews/PR-{NNN}-review.md

Gate AUTO

`audit --target review --release TAG`

Assess release readiness with changelog and breaking-change analysis.

Phase Release Review

Team review-release (3 members)

Members

Name	Process	Technical	Cognitive
release-manager	release-manager	--	systems-thinker
breaking-change-analyst	code-reviewer	--	devils-advocate
doc-reviewer	doc-writer	--	user-empathetic

Outputs docs/releases/{version}-readiness.md

Gate AUTO

`audit --target tests`

Analyze test coverage gaps and diagnose flaky tests.

Phase Test Audit

Team test (2 members)

Members

Name	Process	Technical	Cognitive
coverage-analyst	coverage-analyst	--	systems-thinker
flake-hunter	flake-hunter	--	devils-advocate

Outputs docs/audits/TST-{NNN}/coverage-report.md · flaky-report.md

Gate FLEXIBLE · test-review

`audit --target security`

Threat modeling and vulnerability scanning.

Phase Security Audit

Team security (2 members)

Members

Name	Process	Technical	Cognitive
threat-modeler	threat-modeler	security	systems-thinker
vuln-scanner	vuln-scanner	security	devils-advocate

Outputs docs/audits/SEC-{NNN}/threat-model.md · vulnerability-report.md

Gate FLEXIBLE · security-review

`audit --target performance`

Profile bottlenecks and produce an optimization plan.

Phase	Performance Audit
Team	Single agent (no team spawned)
Agent	[perf-profiler](/reference/personas/process/perf-profiler) · [backend](/reference/personas/technical/backend) · [systems-thinker](/reference/personas/cognitive/systems-thinker)
Outputs	Performance profile · optimization plan · stories
Gate	FLEXIBLE · perf-review

Workspace Commands

`workspace init`

Initialize a multi-repo workspace with shared configuration.

Command	`/sniper-workspace init`
Team	None (single agent)
Outputs	Workspace configuration · repo manifests

`workspace feature`

Plan and execute a feature that spans multiple repositories.

Command /sniper-workspace feature

Team workspace-feature (2 members) + sprint teams per repo

Members

Name	Process	Technical	Cognitive
orchestrator	workspace-orchestrator	--	systems-thinker
contract-designer	contract-designer	api-design	systems-thinker

Outputs features/WKSP-{XXXX}/brief.md · plan.md · contracts/*.contract.yaml

Gate STRICT · workspace-review

`workspace status`

Show the current state of all repos in the workspace.

Command	`/sniper-workspace status`
Team	None (read-only)
Outputs	Console output

`workspace validate`

Validate that repo implementations match interface contracts.

Command	`/sniper-workspace validate`
Team	workspace-validation (1 member)
Agent	[integration-validator](/reference/personas/process/integration-validator) · [backend](/reference/personas/technical/backend) · [devils-advocate](/reference/personas/cognitive/devils-advocate)
Outputs	`features/WKSP-{XXXX}/validation-wave-{N}.md`

Utility Commands

`compose`

Assemble a spawn prompt from persona layers. Used internally by phase commands and available for manual composition.

Team	None (single agent)
Inputs	`--process` · `--technical` · `--cognitive` · `--domain` · `--name` · `--ownership`
Outputs	`.sniper/spawn-prompts/{name}.md`
Reference	Full command reference

`doc`

Generate or update project documentation with a sequential writing pipeline.

Team doc (3 members)

Members

Name	Process	Technical	Cognitive
doc-analyst	doc-analyst	--	user-empathetic
doc-writer	doc-writer	from-config	mentor-explainer
doc-reviewer	doc-reviewer	--	devils-advocate

Outputs README.md · docs/*.md · docs/.sniper-doc-review.md

Gate FLEXIBLE · doc-review

Coordination Sequential: analyst -> writer -> reviewer

Reference Full command reference

`status`

Show lifecycle status, artifact state, and the next recommended action. Read-only.

Team	None (read-only)
Outputs	Console output
Reference	Full command reference

`memory`

Manage the agent memory system -- conventions, anti-patterns, and architectural decisions.

Team	None (single agent)
Outputs	`.sniper/memory/` entries
Reference	Full command reference

Common Flags

Most phase commands accept these flags:

Flag	Description
`dry-run`	Compose prompts without spawning agents
`skip-review`	Skip the review gate (ignored on STRICT gates)
`--context "{text}"`	Label for the phase log entry
`--feature SNPR-{XXXX}`	Scope sprint to a feature

CLI Commands

The sniper binary provides project scaffolding and management:

bash

sniper init                    # Scaffold .sniper/ directory
sniper status                  # Show lifecycle status
sniper update                  # Update framework files to latest version
sniper add-pack <pack-name>    # Add a domain pack
sniper remove-pack <pack-name> # Remove a domain pack
sniper list-packs              # List installed and available packs
sniper memory                  # Manage agent memory
sniper workspace               # Workspace management

Phase Flow

init -> ingest (existing) -> feature / discover -> plan -> solve -> sprint -> sprint -> ...
                \                                                      |
                 \-> discover -> plan -> solve -> sprint ---------------/

ingest is for existing codebases; discover is for greenfield projects.
sprint repeats until all stories are complete.
feature, debug, and audit can run at any time after ingest or discover.

Commands Cheatsheet ​

Quick Lookup ​

Lifecycle Commands ​

init ​

ingest ​

discover ​

plan ​

solve ​

sprint ​

review ​

Extended Commands ​

feature ​

debug ​

audit ​

audit --target refactor ​

audit --target review --pr N ​

audit --target review --release TAG ​

audit --target tests ​

audit --target security ​

audit --target performance ​

Workspace Commands ​

workspace init ​

workspace feature ​

workspace status ​

workspace validate ​

Utility Commands ​

compose ​

doc ​

status ​

memory ​

Common Flags ​

CLI Commands ​

Phase Flow ​

Commands Cheatsheet

Quick Lookup

Lifecycle Commands

`init`

`ingest`

`discover`

`plan`

`solve`

`sprint`

`review`

Extended Commands

`feature`

`debug`

`audit`

`audit --target refactor`

`audit --target review --pr N`

`audit --target review --release TAG`

`audit --target tests`

`audit --target security`

`audit --target performance`

Workspace Commands

`workspace init`

`workspace feature`

`workspace status`

`workspace validate`

Utility Commands

`compose`

`doc`

`status`

`memory`

Common Flags

CLI Commands

Phase Flow