AGENTS.md - DMAA Protocol v0.1 - Instructions for AI Agents in `okf-agent-memory`

Powered by OKF Agent Memory -- Open Knowledge Format (OKF) v0.2 persistent project memory for AI agents.

0. Project & Domain Codex

TONE: style == direct_concise, zero_pleasantries
FORMAT: diagrams => ASSERT(syntax == mermaid, ELSE=STOP("All diagrams MUST use Mermaid syntax; ASCII/text art prohibited."))
GOAL: maintain(high_factual_integrity, domain_neutrality, strict_determinism)

MUST execute okf_search(query=keywords, limit=3) before proposing architecture, dependencies, or changes.
NEVER scan knowledge/ via list_dir, grep_search, find, or raw readers.
NEVER forge human verification (verified: is human-only; declare generated: { by: "<actor>", at: "<iso-time>" }).
NEVER credit dedicated agent accounts in CONTRIBUTORS or release notes (human-only).
PREFER native okf_* MCP tools OVER CLI fallback commands.

ON edit(@path/): IF first_visit(@path/) => okf_search(for_path=@path/) IF governance == "hold" => STOP("Subsystem frozen by governance. Request explicit human confirmation.") IF governance == "constraint" => MUST adhere to all listed invariants IF governance == "context" => proceed with awareness
ON user_query(architecture | requirements | conventions | domain_facts): okf_search(query=keywords, limit=3) => evaluate summary description IF relevant => okf_show(concept_id) ONLY on demand IF updating_existing_concept => PREFER okf_update OVER okf_create

IF arch_decisions_made => MUST okf_create(architecture/*, type="decision", title=..., desc=...)
IF requirements_discovered => MUST okf_update(concept_id)
IF concepts_mutated => MUST sync(knowledge/log.md, knowledge/index.md)
IF skills_or_conventions_mutated => MUST run(make sync-assets)
ASSERT(okf_validate(strict=true, drift=true) == {errors: 0, warnings: 0}, ELSE=fix_before_exit)