Skin Analytics Clinical Data Model — Documentation¶
This is the documentation entry point for the clinical-data-model platform. Documentation is organised by audience.
I'm a...¶
- Senior leader / SMT member → start at
audiences/smt/ - Engineer joining the team → start at
audiences/tech/ - Auditor or compliance reviewer → start at
audiences/compliance/ - External integrator → start at
audiences/integrators/(currently scaffold-only) - Procurement / commercial reviewer → start at
audiences/procurement/(currently scaffold-only)
Architecture & decision history¶
Original design specs and implementation plans live at docs/superpowers/specs/
and docs/superpowers/plans/. These are engineering-history artifacts (ADRs in
everything but name); the tech audience's ADR index
curates which ones are most relevant.
How this documentation is built¶
See CONTRIBUTING.md for how to add a new doc, where diagrams live,
the frontmatter convention, and how generated artifacts are produced.
Generated artifacts (SBOM, license inventory, OpenAPI, rendered SVG diagrams) are
produced by scripts/generate-docs.sh and emitted to each audience's generated/
subfolder. Generated artifacts are excluded from git — they are CI build outputs.