Markdown Output Prompt — Lock the Document Structure
The contract that stops AI documents from restructuring themselves: a pinned section skeleton, forced tables, and strict consistency rules.
Purpose, Highlights, Details, Recommendations, Next Steps — recurring business reports with conclusions first and numbers in context.
Recurring reports earn their audience by being identically shaped: readers learn where the headline lives and stop reading linearly. This setup generates business reports in five pinned sections with report-specific rules — lead each section with its conclusion, then support it; every number needs its comparison point, because a figure without context is noise. Optional tables handle the metric grids; Next Steps closes with owners and timing so the report ends in motion, not in prose.
Same prompt every cycle
The structure is the product: readers learn it once and navigate every future report by instinct.
Audit the comparison points
"Up 12%" against what? The number-context rule makes every figure carry its baseline.
Check Next Steps for owners
Concrete actions with owners and timing — the section that turns reporting into management.
Because the DOCUMENT block orders it: "lead each section with its conclusion, then support it." It pairs with "every number needs its comparison point — a figure without context is noise," so a figure like "up 12%" carries its baseline. The five sections run Purpose, Highlights, Details, Recommendations, Next Steps. The markdown-output-builder emits this shaped prompt; you run it in your assistant to draft each cycle's report.
Not as top-level sections. The CONSISTENCY RULES say "do not add new top-level sections — put extra material inside the closest existing section," and require all five (Purpose, Highlights, Details, Recommendations, Next Steps) in that exact order. That fixed shape is the point. Extra material goes inside Details or Recommendations rather than becoming a sixth heading; CODE RULES also bar code blocks entirely.
The contract that stops AI documents from restructuring themselves: a pinned section skeleton, forced tables, and strict consistency rules.
Overview, Installation, Usage, Examples, Configuration — the README skeleton with required, runnable code examples.
Overview, Authentication, Endpoints, Error Handling, Rate Limits — endpoint docs in an identical structure, with parameter tables and runnable examples forced.
Summary, Why It Matters, What Happens Next — the executive summary contract for readers who will never open the source.
Stop getting 'Sure, here is the JSON…' — the output-contract pattern that forces models to return only parseable JSON: schema, example, and a strict rule block.
The JSON won't parse and you can't see why. Deterministic cause-sniffing — trailing commas, single quotes, unclosed brackets — and the repair prompt that fixes it.
Build prompts that produce documents in a fixed structure — headings, sections, and tables.
Decide what to publish and why before you write a word — set the business goals and audience, map needs to topics, brief the priority pieces, then turn it into a content plan you publish against.