okf-authoringlisted

# OKF authoring Build durable, source-backed knowledge as Markdown concepts with YAML frontmatter. Treat conformance as the floor and evidence-backed completeness as the finish line. Do not use this skill for ordinary Markdown writing, generic code review, or source changes when no OKF bundle is involved. ## Choose a mode | Mode | Use it to | Required result | |---|---|---| | `produce` | Create knowledge from source evidence | New concepts, links, indexes, log entry | | `maintain` | Reconcile knowledge after a source change | Preserved structure, updated facts, neighborhood, log | | `consume` | Answer from an existing bundle | Read root `index.md`, follow only relevant concepts; switch to `maintain` for durable discoveries | ## Route the work Read only the resources needed for the task: - Read [references/spec-v0.1.md](references/spec-v0.1.md) before validating, converting, or resolving frontmatter/reserved-file questions. - Read [references/concept-patterns.md](references/concept-patterns.md) before writing a service, endpoint, flow, datastore, runbook, ADR, metric, or reference. - Read [references/linking-indexes-logs.md](references/linking-indexes-logs.md) when adding, moving, renaming, deprecating, or converting concepts. - Read [references/quality-gates.md](references/quality-gates.md) before declaring produce or maintain work complete. - Read [examples/complete-api-endpoint.md](examples/complete-api-endpoint.md) for an endpoint contract, [examples/complete-data-a