okf

Create a directory of markdown files where each concept has YAML frontmatter with a required type field, then add index.md files for progressive disclosure and an optional log.md for change history. Cross-link concepts with standard markdown links and declare okf_version in the root index.md.

Use the okflint CLI linter, installable via pip or uv, which checks 18 rules across core, profile, and hygiene tiers. Run okflint validate with an okf-base.yaml manifest, or fall back to the built-in bash script that checks the three core conformance rules.

An Attested Computation is a concept type carrying a sanctioned, verifiable way to compute a value, with required runtime, typed parameters, an executor producing a receipt, and a deterministic attester. Agents may only fill parameter values and must never edit the computation itself.

Yes, conversion guides cover both sources. Convert Obsidian wikilinks to standard markdown links and ensure a type field exists; for Notion, map properties to frontmatter, remove UUID filename suffixes, and convert links to clean relative paths.

Only three rules are mandatory: every non-reserved markdown file needs parseable frontmatter, every frontmatter needs a non-empty type field, and reserved files must follow their structure. Consumers must not reject bundles for missing optional fields, unknown types, or broken links.