Report and Markdown tools

The report is an artifact a human reads and a tool re-parses. These tools keep its frontmatter machine-valid and its diagrams renderable, and they catch broken links and typos before the report ships.

Evidence dimension: report (quality of the artifact, not the architecture).

When to use

Use during the write-the-report step and before declaring a report or plan done. First decide the audience:

• Human-facing reports: consider a small Mermaid diagram for the system map, dependency clusters, or boundary drift when it improves comprehension.
• AI/agent-targeted reports: prefer plain text adjacency lists, cited bullets, and compact structure. Do not spend tokens on fancy diagrams, broad tables, or formatting polish; models do not read diagrams as evidence.