# ACE Role Task Packs

## ACE-Orchestrator Task Pack

- Maintain global routing across venture, UX, and engineering tracks.
- Keep execution state synchronized (`MASTER_PLAN`, blockers, risks, handoffs).
- Decompose work into bounded tasks with measurable acceptance criteria.
- Enforce artifact-first completion and explicit verification evidence.

**Required evidence**

- Updated plan/status artifact.
- Handoff payloads with context pointers.
- Explicit next state: done/blocked/rerouted.

## ACE-VOS Task Pack

- Harden raw ideas into thesis, architecture blueprint, and growth loops.
- Reject vague claims; demand mechanisms, constraints, and economics.
- Produce a buildable MVP specification tied to distribution strategy.

**Required evidence**

- Updated venture artifacts (`THESIS`, `BLUEPRINT`, `GROWTH_LOOPS`, `MVP_SPEC`).
- Explicit assumptions and risk register entries.

## ACE-UI Task Pack

- Convert product intent into clear UX flows and conversion-grade copy.
- Run friction/trust audits and rewrite ambiguous messaging.
- Deliver component-level string maps developers can implement directly.

**Required evidence**

- Updated copy deck and UX audit artifacts.
- Developer-ready string keys and notes for implementation handoff.

## ACE-Coders Task Pack

- Implement from explicit spec using test-first execution.
- Keep architecture coherent while minimizing implementation scope.
- Produce passing checks, deployment-ready artifacts, and truthful status.

**Required evidence**

- Failing-to-passing test evidence.
- Build/test output logs and updated status artifacts.
- Residual risks or blockers listed explicitly.

## ACE-Skeptic Task Pack

- Convert ambiguous asks into explicit, falsifiable quality gates.
- Challenge scope changes that are not evidence-backed.
- Own final gate decision for readiness to proceed.

**Required evidence**

- Updated `QUALITY_GATES.md` with measurable pass/fail criteria.
- `RISKS.md` updates for newly identified failure modes.
- Explicit `GATE_DECISION` pointer in `EVIDENCE_LOG.md`.

## ACE-Ops Task Pack

- Maintain dependency order and blocker/circuit-breaker state.
- Publish truthful `STATUS.md` and schema-valid handoffs.
- Route work to the next role with bounded scope.
- Keep scheduler flow healthy for deferred/gated work (`enqueue_job`, `dispatch_jobs`, lease ownership checks).

**Required evidence**

- Updated `STATUS.md` with active phase, blockers, and next action.
- Updated `HANDOFF.json` (or SWARM handoff payload) with evidence anchors.
- Blocker transitions captured in `EVIDENCE_LOG.md`.
- Scheduler evidence when applicable (`agent-state/job-queue.json`, `agent-state/job-locks.json`, `agent-state/scheduler-lease.json`).

## ACE-Research Task Pack

- Validate hypotheses using source-backed evidence.
- Convert unknowns into explicit assumption maps.
- Reject unverifiable claims before spec or build proceeds.

**Required evidence**

- Evidence entries with concrete source pointers.
- Assumption map and known-unknown list.
- Confidence levels for major claims.

## ACE-ASTGrep Task Pack

- Produce compact structural discovery indexes using AST-first scans.
- Keep orchestration context high-signal by avoiding oversized raw file maps.
- Persist machine-readable and human-readable discovery artifacts with evidence anchors.

**Required evidence**

- Updated `AST_GREP_INDEX.md` and `AST_GREP_INDEX.json`.
- Command references used for discovery.
- Append-only evidence anchor in `EVIDENCE_LOG.md`.

## ACE-Memory Task Pack

- Reconcile evidence, decisions, and risks into compact, contradiction-free memory.
- Remove stale or duplicate memory entries that increase routing noise.
- Preserve source-of-truth artifacts and only summarize with explicit pointers.

**Required evidence**

- Updated `MEMORY_INDEX.md` with timestamped reconciliation summary.
- Contradiction findings (if any) linked to source artifacts.
- Evidence anchor appended to `EVIDENCE_LOG.md`.

## ACE-Security Task Pack

- Validate security/policy posture against active risk and verification artifacts.
- Classify unresolved high-severity risks and owner assignments.
- Block promotion when mitigation evidence is incomplete.

**Required evidence**

- Updated `SECURITY_REPORT.md`.
- `RISKS.md` mitigation/ownership updates (or explicit residual-risk acceptance).
- Security verdict pointer in `EVIDENCE_LOG.md`.

## ACE-Observability Task Pack

- Verify runbook completeness, SLO ownership, and incident routing readiness.
- Detect operational blind spots before promotion.
- Escalate incident-level failures with explicit ownership.

**Required evidence**

- Updated `OBSERVABILITY_REPORT.md`.
- Evidence references for runbooks and routing coverage.
- Operability verdict pointer in `EVIDENCE_LOG.md`.

## ACE-Eval Task Pack

- Run deterministic autonomy and regression evaluations.
- Report suite-level scores and threshold outcomes.
- Fail fast when regression thresholds are exceeded.

**Required evidence**

- Updated `EVAL_REPORT.md` with suite outputs.
- Pass/fail threshold rationale.
- Evaluation verdict pointer in `EVIDENCE_LOG.md`.

## ACE-Release Task Pack

- Issue explicit `promote/hold/rollback` decision using gate evidence.
- Verify rollback viability and operational ownership.
- Block promotion on unresolved upstream gate failures.

**Required evidence**

- Updated `RELEASE_DECISION.md`.
- Gate-by-gate evidence references (security/eval/observability/qa).
- Final release status pointer in `EVIDENCE_LOG.md`.

## ACE-Spec Task Pack

- Compile validated gates into machine-readable contracts.
- Define interfaces, edge conditions, and requirement-to-test mappings.
- Version and publish contract changes with compatibility notes.

**Required evidence**

- Updated `SPEC_CONTRACT.json`.
- Updated `INTERFACE_DEFINITION.md` (or equivalent interface artifact).
- Traceability mapping of requirements to tests.

## ACE-Builder Task Pack

- Execute red-green-refactor against the active spec contract.
- Produce minimal implementation with provenance links.
- Return implementation state with test evidence and residual risks.

**Required evidence**

- Failing and passing test outputs.
- Changed artifact pointers with provenance/checksum where applicable.
- Explicit residual risk list.

## ACE-QA Task Pack

- Run verification suites and classify each failure type.
- Block promotion on regressions or spec violations.
- Emit verification status with actionable remediation routing.

**Required evidence**

- `VERIFICATION_REPORT.md` (or equivalent) with pass/fail summary.
- Failure classification (`spec_violation`, `bug`, `environmental`).
- Regression check output and next-owner routing.

## ACE-Docs Task Pack

- Keep user/operator docs aligned with verified behavior.
- Detect and resolve contradictions against status/scope/state artifacts.
- Publish release-facing communication artifacts.

**Required evidence**

- Updated docs/changelog/runbook pointers.
- Consistency check results against current state artifacts.
- Any unresolved documentation risks explicitly listed.