Centralised figure generation module

[Colinho22]

Motivation

Plots are generated ad hoc. The result is inconsistent sizing, colour that means different things in different figures, and small text in exactly the figures carrying the most detail — the system architecture and the generated-versus-ground-truth comparisons. Several plots also overlap heavily in what they show, adding length without adding information.

Proposal

• One theme module setting figure size, DPI, and font sizes suitable for print.
• A colourblind-safe categorical palette with colours pinned per strategy, so colour carries the same meaning in every figure.
• Vector export for any figure containing small text.
• Audit the figure set: merge or drop near-duplicates, keeping a plot only where it answers a question no other plot answers.
• Regenerate the architecture diagram at a legible size, or split it into two levels of detail.

Done when:

• All figures produced through the styling module
• Strategy colours consistent set-wide and legible in greyscale
• Figure inventory documents the question each plot answers
• Full set regenerates from one command

Scope

• In scope: theme module, palette, export formats, figure audit, architecture diagram rework.
• Out of scope: new analyses; interactive or web-based visualisation.

Open questions

• Should the palette accommodate the expanded strategy set from Introduce orchestration modes: constrained pipeline and free-flow agentic #91, or be fixed to today's four? Adding modes may exceed what a categorical palette distinguishes reliably — beyond roughly eight, encode by shape or facet instead.
• Is the architecture diagram better maintained as code-generated output or as a hand-drawn asset checked into the repo? The first stays in sync; the second usually reads better.

Related

• Consumes output from Failure-mode analysis for invalid generations #94, Model-selection decision rule and cost–quality frontier #97, Treat output format as an explicit experimental factor #99 — build after those settle so the audit covers the final figure set.