ores.doc.agile
Table of Contents
This page is the node for the ores.doc.agile facet of the codegen
template library, part of the ores.doc technical space. Each archetype
below is documented, and holds its mustache source, in its own
linked page — this page is the facet-level summary and the routing
table to them.
1. Summary
The agile composition tree: version, sprint, story, task. Each
scaffold carries a #+todo: vocabulary and a * Status table at its
default state, plus parent links for the glossary-linked blurb. No
profile involvement — doc_generate.py's TYPE_TO_TEMPLATE maps type
→ template directly.
2. The ores.doc.agile facet
These templates are self-hosting: mustache sources that render to
org-mode documents, themselves owned by an org-mode document (this
one). The model element is doc_generate's variables dict — id,
title, description, filetags, date, state, plus parent links
for the agile composition tree (story → task, sprint → story, version
→ sprint). The rendered artefacts follow the project document
contract: :PROPERTIES:/:ID: drawer, #+keyword frontmatter,
glossary-linked blurb, skeleton sections (task adds * PRs=/=* Review
tables and #+branch:=/=#+pr: keywords that drive compass pr
matching; story adds a * Tasks table compass wires rows into).
3. Mustache incantations
doc_generate renders with pystache.Renderer(escape=identity), so
double-stache is effectively triple-stache here — titles and bodies
land verbatim, HTML-escaping never applies. List sections
({{#acceptance}}, {{#see_also}}) render repeatable bullets, with
{{#has_acceptance}}-style guards selecting placeholder text when
empty.
4. Archetypes
| Archetype | Description |
|---|---|
| ores.doc.agile.sprint | Sprint page: Mission, Status table (state STARTED), themed * Stories tables. |
| ores.doc.agile.story | Story page: Goal, Status table, Acceptance, * Tasks table compass wires rows into, Decisions, Out of scope. |
| ores.doc.agile.task | Task page: Goal, Status, Acceptance, transient Plan, Notes, * Test Scenarios, * PRs and * Review tables, Result. #+branch: / #+pr: drive compass pr matching. |
| ores.doc.agile.test_scenario | Test scenario page: Scenario Info, Steps checklist, Results, Notes. |
| ores.doc.agile.version | Version page topping the agile composition tree. |
5. See also
- ores.doc — the parent technical space's generated facet/archetype catalogue and shared Mustache conventions.
- Other Technical Spaces § "Doc Technical Space" — the domain-concept overview of this technical space.
- Codegen template library — the groups overview.