49 lines
1.3 KiB
Markdown
49 lines
1.3 KiB
Markdown
|
# 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)
|