# PKM Dashboard Standard (Atomizer)

## Purpose
Standardize how project dashboards and reports are built across Atomizer.

## Core Standard
1. **Contracts-first:** every metric must map to structured source records.
2. **Markdown-first:** default delivery is markdown snapshots.
3. **Role-based views:** Executive, Technical, Operations.
4. **Governance-first:** clear owner, schema validation, gate policy.

## Directory split
- Project-specific: `projects/<project>/...`
- Foundational: `docs/...`

## Minimum required artifacts per project
- `dashboard/MASTER_PLAN.md`
- `dashboard/EXECUTIVE_DASHBOARD.md`
- `dashboard/TECHNICAL_DASHBOARD.md`
- `dashboard/OPERATIONS_DASHBOARD.md`
- `reports/` (daily/weekly/gate)
- `runs/` manifests
- `decisions/` append-only log
- `incidents/` append-only log

## Minimum required contracts
- `run_manifest.v1`
- `study_summary.v1`
- `trial_result.v1`
- `decision_record.v1`
- `risk_record.v1`
- `gate_evaluation.v1`
- `incident_record.v1`

## Gate semantics
- `PASS` / `CONDITIONAL_PASS` / `FAIL`
- `FAIL` blocks progression
- `CONDITIONAL_PASS` requires owner + due date + explicit acceptance

## Quality controls
- Ingestion schema validation
- Nightly integrity checks
- Freshness SLA checks
- Auditor spot checks

## Evolution policy
- Start markdown-native
- Add richer visual layer only over same contracts (no parallel truth)