| name | author-okf |
| description | Author or extract atomic, OKF-compliant concept documents that conform to Dossier's knowledge model. Use whenever turning raw/clean source content (or a topic) into knowledge-base concepts — processes, workflows, roles, decisions, systems, policies, artifacts, terms. Produces one well-formed markdown+YAML file per concept, with full provenance and typed relationships. |
Author OKF Concepts
Turn content into atomic, single-source-of-truth OKF concepts that conform to knowledge/model/index.md. Read the model first — it is the contract.
Procedure
- Load the contract. Read
knowledge/model/index.md for the concept types, base frontmatter schema, and the relationship vocabulary.
- Identify the atoms. Break the source into the smallest concepts that can change independently. One concept = one file. If two facts can change separately, they are two files.
- Type each atom. Assign a
type (role · process · workflow · decision · system · policy · artifact · term, or concept fallback). Add a new type only with the knowledge-architect's blessing.
- Write each file at
knowledge/<area>/<slug>.md (or the client's KB root) with:
- Frontmatter:
type (required), id (stable slug), title, description, plus resource, owner, status, confidence, source, tags, timestamp as available.
- Body: clear headings; the human-readable truth.
- Wire relationships. Add typed edges in frontmatter (
owner, uses, governed_by, steps, produces, relates_to, …) AND mirror the important ones as [[id]] links in the body. Same edge, two surfaces.
- Stamp provenance. Every atom gets
source (where it came from) and confidence (verified = grounded in a source · asserted = human judgment · inferred = LLM-derived). Never mark inferred content as verified.
- Validate. Run
verify-kb (or its checks) before declaring done.
Rules
- Atomic. Single-source-of-truth. Link, don't copy.
- Never fabricate. If a fact or rationale isn't in the source, omit it or write "not captured" — do not invent.
- Stable ids. Slugs are permanent addresses; never recycle. Evolve via
status/supersedes, not renaming.
- Capture judgment. When the source reveals why something is done, write a
decision concept — that's the IP.
Output
A set of OKF files, each independently readable (cat-able) and graph-parseable, plus a one-line summary of concepts created and any gaps you couldn't fill.