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.
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.
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.
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.
Archetypes
| Archetype | Description |
|---|---|
| ores.doc.knowledge.product_identity | Product-identity page skeleton. |
| ores.doc.knowledge.manual | User-manual chapter under doc/manual/user_guide/. |
| ores.doc.knowledge.investigation | Investigation doc with the Investigation: title prefix and findings skeleton. |
| ores.doc.knowledge.capture | Product-backlog capture: What/Why skeleton plus the bucket-aware blurb ({{bucket}} names inbox/next/deferred). |
| ores.doc.knowledge.knowledge | Generic knowledge page: Summary / Detail / See also. |
| ores.doc.knowledge.memory | Project memory: #+memory_subtype plus statement / why / how-to-apply one-shot body fields. |
| ores.doc.knowledge.recipe | Recipe with Question / Answer / Script / Tested-by sections, each renderable verbatim from flags (--question, --answer, …). |
| ores.doc.knowledge.skill | Claude Code skill SKILL.org (tangled by the skills build into .claude/skills/). |
| ores.doc.knowledge.component | Component component_overview.org: #+component_name / #+brief keywords read back by codegen, plus the standard overview sections. |
| ores.doc.knowledge.runbook | Runbook: Goal / Preconditions / Steps / Postconditions composition of recipes and skills. |
| ores.doc.knowledge.release_notes | Sprint release-notes page generated at sprint close. |
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.