ores.doc.knowledge
Table of Contents
This page is the node for the ores.doc.knowledge 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
Prose doc scaffolds: knowledge, recipe, manual, skill, memory, capture,
runbook — plus component, investigation, product identity, and
release notes. No profile involvement; doc_generate.py's
TYPE_TO_TEMPLATE maps type → template directly.
2. The ores.doc.knowledge facet
Self-hosting mustache sources rendering to org-mode documents, driven
by doc_generate's variables dict (id, title, description,
filetags, date, plus type-specific extras — recipe section bodies
via --question=/–answer=/=–script=/=–tested-by=, memory subtype
fields, component name/brief). Recipe, runbook and skill compose other
prose docs by reference rather than by structure.
3. Mustache incantations
doc_generate renders with pystache.Renderer(escape=identity) — see
the group doc's shared conventions. List sections
({{#acceptance}}, {{#see_also}}) render repeatable bullets with
{{#has_acceptance}}-style empty-state guards.
4. Archetypes
| Archetype | Description |
|---|---|
| ores.doc.knowledge.capture | Product-backlog capture: What/Why skeleton plus the bucket-aware blurb ({{bucket}} names inbox/next/deferred). |
| ores.doc.knowledge.component | Component component_overview.org: #+component_name / #+brief keywords read back by codegen, plus the standard overview sections. |
| ores.doc.knowledge.investigation | Investigation doc, scoped to the story that commissioned it: Investigation: title prefix, findings skeleton, and a snapshot framing. |
| ores.doc.knowledge.knowledge | Generic knowledge page: Summary / Detail / See also. |
| ores.doc.knowledge.manual | User-manual chapter under doc/manual/user_guide/. |
| ores.doc.knowledge.memory | Project memory: #+memory_subtype plus statement / why / how-to-apply one-shot body fields. |
| ores.doc.knowledge.product_identity | Product-identity page skeleton. |
| ores.doc.knowledge.recipe | Recipe with Question / Answer / Script / Tested-by sections, each renderable verbatim from flags (--question, --answer, …). |
| ores.doc.knowledge.release_notes | Sprint release-notes page generated at sprint close. |
| ores.doc.knowledge.runbook | Runbook: Goal / Preconditions / Steps / Postconditions composition of recipes and skills. |
| ores.doc.knowledge.skill | Claude Code skill SKILL.org (tangled by the skills build into .claude/skills/). |
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.