spec-driven-journals

Write the checklist modality (checklist.md) of a spec-driven journal post — the operational working checklist behind the record, rendered as the Checklist tab on the post page. Use when asked to add, write, update, or extract a checklist, working checklist, or checklist tab for a post in _journals/*/posts/*/.

Add restrained bold emphasis to a post's prose (index.md or a modality file) so skim readers catch the main argument, preserving the author's wording, voice, and structure. Use when asked to highlight key phrases, make a post more skimmable, add bold emphasis, or apply a "bold highlighter" pass in _journals/*/posts/*/.

Write or revise the detailed main article (index.md) of a spec-driven journal post from its spec.md contract, following the house record style (status highlight, MADR-inspired sections, cross-links). Use when asked to write, draft, expand, or revise a post's main article, index.md, or "the article modality" in _journals/*/posts/*/.

Add inline illustrations to a post's main article (index.md) — propose 2–5 figure placeholders where a visual aids comprehension, generate Gemini/Nano-Banana images for them, and replace each placeholder with a markdown image + numbered caption. Complementary to the explainer-comics modality (this illustrates the article body; comics is its own tab). Use when asked to illustrate, add figures/diagrams/images to, or stage illustration placeholders for a post's article in _journals/*/posts/*/index.md.

Write the comics modality (comics.md) of a spec-driven journal post — an explainer comic of generated panel images derived from spec.md and index.md, rendered as the Comic tab on the post page. Use when asked to add, write, generate, or update an explainer comic, comic strip, comic panels, or comic tab for a post in _journals/*/posts/*/.

Write the dialog modality (dialog.md) of a spec-driven journal post — a two-host, podcast-style conversation derived from spec.md and index.md, rendered as the Conversation tab on the post page. Use when asked to add, write, or update a dialog, podcast script, conversation, or two-host discussion for a post in _journals/*/posts/*/.

Review a spec-driven journal post end to end — the spec, each modality (index/summary/dialog/comics), spec↔modality alignment, and cross-modality consistency — judging structure, argument quality, readability, repetition, language simplicity, grammar, and overall quality. Writes findings to REVIEW.md in the post folder. Use when asked to review, critique, audit, proofread, or quality-check a post, a spec, a modality, or the alignment between them in _journals/*/posts/*/.

Create or refine a post's spec.md — the contract that drives a spec-driven journal post — from source material (an INPUT.md, raw notes, or a described intent), using _wiring/spec-template.md. Use when asked to create, draft, write, improve, or polish a spec, spec.md, or "the contract" for a post in _journals/*/posts/*/, before the article (index.md) is written.

Write the management-summary modality (summary.md) of a spec-driven journal post from its spec.md and index.md, rendered as the Summary tab on the post page. Use when asked to add, write, or update a management summary, executive summary, TL;DR, or summary tab for a post in _journals/*/posts/*/.

Add concise bold emphasis to articles, blog posts, markdown notes, documentation pages, and long-form prose so skim readers can catch the main argument. Use when asked to highlight key phrases, make an article more skimmable, add bold emphasis, improve skim reading, or apply a "bold highlighter" pass to prose while preserving the author's wording and structure.

Analyze spec-driven-journals markdown posts, insert machine-readable illustration placeholders, generate Gemini/Nano Banana images for those placeholders, and replace generated placeholders with markdown image links and captions. Use when Codex is asked to suggest, add, stage, generate, or prepare article illustrations, figure placeholders, Gemini image-generation prompts, or generated article figures in _journals/*/posts/*/index.md files.