auto: daily sync

docs/guides/PKM_DASHBOARD_STANDARD.md

@@ -0,0 +1,48 @@
+# 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)