Atomizer/docs/guides/PKM_DASHBOARD_STANDARD.md

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)