# DashClaw Capability Classification

This document defines the DashClaw product taxonomy. DashClaw is organized into a focused governance runtime with modular extensions.

---

## Tier 1: Core Runtime (`app/(core)`)
**Rule:** Participates directly in the lifecycle of a governed decision.

| Capability | SDK Golden Path | API Namespace | UI Surface |
|------------|-----------------|---------------|------------|
| **Policy Engine** | `guard()` | `/api/guard` | Policies |
| **Action Recording** | `createAction()` | `/api/actions` | Decisions |
| **Approval Gating** | `waitForApproval()` | `/api/approvals` | Approvals |
| **Assumption Ledger** | `recordAssumption()` | `/api/assumptions` | Decisions |
| **Risk Signals** | `getSignals()` | `/api/signals` | Mission Control |
| **Fleet Health** | -- | `/api/health` | Mission Control |

---

## Tier 2: Extensions (`app/(extensions)`)
**Rule:** Modular operational intelligence. Not required for core governance.

| Extension | Focus | API Namespace |
|-----------|-------|---------------|
| **Compliance** | Audit evidence and SOC 2 reporting | `/api/compliance` |
| **Drift** | Detection of reasoning and metric drift | `/api/drift` |
| **Evaluations** | LLM-as-judge accuracy scoring | `/api/evaluations` |
| **Prompts** | Versioning and governance of agent prompts | `/api/prompts` |
| **Scoring** | Multi-dimensional risk profiles | `/api/scoring` |
| **Webhooks** | Event-driven notifications | `/api/webhooks` |

---

## Tier 3: Archived (`app/(archive)`)
**Rule:** Historical features from the "Agent Platform" era. Physically isolated to prevent bloat.

- **Messaging:** Agent-to-agent communication.
- **Workspace:** Calendar, Goals, Relationships, and Task lists.
- **Orchestration:** Swarm mapping, Workflow SOPs, and Routing.
- **Intelligence:** Learning loops and Memory maintenance.

---

## Infrastructure: `livingcode/`
**Rule:** Internal self-monitoring framework. Not a product feature — DashClaw's immune system for its own codebase.

| Component | Responsibility |
|-----------|----------------|
| `collectors/` | 5 sensing collectors (git_stats, test_health, code_quality, dependency_health, ci_health) |
| `immune/` | 6 checks → verdict (merge / fix_required / needs_discussion) |
| `planner/` | Tiered work item generation (5 tiers) + backlog persistence |
| `orchestrator/` | Lifecycle cycle (SENSE → PLAN → REVIEW → REFLECT) + safety systems |
| `heartbeat/` | Quick (post-commit) and full (scheduled) heartbeat runner |
| CLI | `python -m livingcode sense|plan|review|cycle|heartbeat|status` |

State persists to `.organism/` at the repo root. Zero external dependencies — stdlib only.

---

## The Category Test

1. **Does it block an agent?** &rarr; **CORE**
2. **Does it record a decision?** &rarr; **CORE**
3. **Does it analyze decisions?** &rarr; **EXTENSION**
4. **Does it help agents "work"?** &rarr; **ARCHIVED**
