![[Collective knowledge problems#^agent-readiness]]
## Resolution
> The property of a knowledge artefact being structured so that agents (human or machine) can consume it without reformatting.
^definition
Human-readable prose is not automatically agent-readable - agents need explicit structure, typed fields, and a contract about what to look for. Agent-readiness depends on the artefact's format (structured JSON or Markdown over arbitrary HTML), the schema's stability, and whether the artefact separates content from presentation. [[Tacit knowledge]] is the hardest part: it resists capture by design, yet agents fail without it.
## In practice
```markdown
---
status: active
owner: alice
related: [[Onboarding]], [[Compliance]]
---
# Customer Records Policy
...
```
Frontmatter carries the structured fields; the body carries prose. An agent reads the YAML for predicates and the body for context - no parsing of formatting needed.