@specdev/dsh-archify-manage

Usage reference

Where do diagrams and explanations live?

All reading data lives in your business repository:

docs/archify/
  project.json                           # project name and introduction
  /business.json             # business introduction and document links
  //chart.json     # diagram name and summary
  //workflow.json  # Archify workflow source
  //details.md     # explanations grouped by node
  //evidence.json  # source references pinned to commits

Business IDs and diagram IDs match their directory names. Diagram IDs must be unique across the entire project. You can read diagrams without node explanations or source evidence; missing or invalid material is reported explicitly.

See the file contract for fields and examples.

How are explanations paired with source code?

In details.md, use a level-two heading for the node ID and explicitly name the evidence reference in the body: