LLMSkillHub
mirroredCopied from okf-memory/okf-agent-memory under MIT. okf-memory has not claimed this page, and is not affiliated with LLM SkillHub.

okf-memory / okf-agent-memory

Maintain persistent, domain-neutral project memory for AI agents using Open Knowledge Format (OKF) v0.2 bundles and the deterministic okf Go toolchain. Use whenever project knowledge, decisions, runbooks, research, client notes, or domain discoveries must survive conversational resets.

0
SKILL.md
3.6 KB

OKF Agent Memory Skill (AAG Spec v0.1)

Teaches AI agents deterministic interaction with an Open Knowledge Format (OKF v0.2) bundle (knowledge/).

0. Project & Domain Codex

  • GOAL: maintain(highfactualintegrity, domainneutrality, strictdeterminism)
  • FORMAT: diagrams => ASSERT(syntax == mermaid, ELSE=STOP("Mermaid required; ASCII/box art prohibited."))

1. Behavioral Invariants (RFC 2119)

  • MUST execute okf_search(query=keywords, limit=3) before proposing architecture changes or creating concepts.
  • NEVER scan knowledge/ via list_dir, grep_search, or raw file readers.
  • NEVER forge human verification (verified: is human-only; declare generated: { by: "<actor>", at: "<iso-time>" }).
  • PREFER native okf_* MCP tools OVER CLI fallback commands.
  • PREFER okf_update OVER okf_create when mutating existing domain entities.
  • NEVER persist scratchpads, raw chain-of-thought, or speculative chatter to knowledge corpus.

2. Guard Clauses & Scope Governance

  • ON edit(@path/):
    IF firstvisit(@path/) => okfsearch(for_path=@path/)
    IF governance == "hold" => STOP("Subsystem frozen by governance. Confirm with user.")
    IF governance == "constraint" => MUST adhere to all listed invariants
    IF governance == "context" => proceed with awareness

  • ON userquery(architecture | requirements | conventions | domainfacts):
    okf_search(query=keywords, limit=3) => evaluate summary description
    IF relevant => okfshow(conceptid) ONLY on demand

3. Completion Pipeline (Sequential Assertion Gates)

  1. IF archdecisionsmade => MUST okf_create(architecture/*, type="decision", title=..., desc=...)
  2. IF requirementsdiscovered => MUST okfupdate(concept_id)
  3. IF concepts_mutated => MUST sync(knowledge/log.md, knowledge/index.md)
  4. ASSERT(okfvalidate(strict=true, drift=true) == {errors: 0, warnings: 0}, ELSE=fixbefore_exit)

4. Tooling Reference (Dual-Mode: MCP & CLI)

Default bundle: ./knowledge. For custom paths, pass bundle="path/to/bundle".

TaskPreferred: Native MCP ToolFallback: Deterministic CLI (--json)
Search Knowledgeokf_search(query="<query>", limit=3)okf search "<query>" knowledge --limit 3 --json
Discover Code Constraintsokf_search(for_path="<file-path>")okf search --for-path <file-path> knowledge --json
Inspect Conceptokf_show(concept_id="<id>")okf show <id> knowledge --json
Create Conceptokf_create(concept_id="<id>", type="<type>", title="<title>", description="<desc>")okf create <id> knowledge --type <type> --title "<title>" --desc "<desc>" --json
Update Conceptokf_update(concept_id="<id>", description="<desc>", title="<title>")okf update <id> knowledge --desc "<desc>" --json
Relate Conceptsokf_relate(source_id="<src>", target_id="<tgt>", description="<prose>")okf relate <src> <tgt> knowledge --desc "<prose>" --json
Validate Bundleokf_validate(strict=true)okf validate knowledge --strict --drift --json

5. Workflow Guides (Progressive Disclosure)

  • Discovery & Retrieval: [discovery.md](./discovery.md)
  • Persistence Decisions: [remember.md](./remember.md)
  • Updating & Mutations: [update.md](./update.md)
  • Relationship Topology: [relationships.md](./relationships.md)
  • Multi-Domain Reference: [examples.md](./examples.md)