Agents

The package ships namespaced Pi agents for common Stack Ops roles. Normal users usually interact with prompts rather than calling these agents directly.

Packaged agents

Agent	Purpose
stack-ops.architect	Reviews architecture direction and tradeoffs.
stack-ops.spec-writer	Drafts and edits specs or ADRs.
stack-ops.planner	Creates implementation plans.
stack-ops.slice-builder	Implements one approved slice.
stack-ops.reviewer	Reviews specs, plans, and diffs.
stack-ops.security-reviewer	Reviews security, privacy, auth, and dependency risk.
stack-ops.bug-hunter	Diagnoses failures, regressions, stack traces, and unexplained behavior.
stack-ops.test-strategist	Designs focused coverage, regression cases, and flake triage.
stack-ops.contract-reviewer	Reviews public contracts and compatibility across APIs, CLIs, schemas, and observable behavior.
stack-ops.delivery-engineer	Diagnoses CI, build, packaging, versioning, and distribution failures.
stack-ops.data-reliability-engineer	Reviews persistence, migrations, queries, and data-integrity risks.
stack-ops.performance-engineer	Reviews measurable performance and resource concerns.
stack-ops.search-rag-engineer	Reviews search, retrieval, embeddings, grounding, and RAG evaluation.
stack-ops.validator	Runs validation and summarizes evidence.
stack-ops.workflow-reviewer	Audits workflow and artifact hygiene; reports only.
stack-ops.readiness	Returns the READY/BLOCKED gate decision.
stack-ops.blocker-resolver	Applies only explicitly accepted blocker fixes for the active slice.
stack-ops.stack-operator	Handles stack and PR mechanics after readiness and explicit approval.
stack-ops.state-keeper	Performs optional state-only maintenance.

Next steps

Read Agents and roles for the conceptual model.