Knowledge base

The agent's knowledge is a directory of plain files living in git. Every act of "learning" is a reviewable diff.

knowledge/
  persona.yaml        # identity: role, tone, priorities
  rules.yaml          # rules with provenance and confidence
  facts.yaml          # domain facts
  skills/*.skill.md   # structured skills
  episodes.jsonl      # lessons distilled from runs

Rules and provenance

rules:
  - id: verify-before-done
    text: After making a change, verify it works before finishing.
    origin: manual              # or the id of the trace that produced the rule
    confidence: 1

origin distinguishes rules written by a human from ones learned by the evolve loop — every learned rule can be traced back to a specific run.

Skills

A skill is a *.skill.md file: machine-readable YAML frontmatter + a prose body.

---
name: task-completion
description: How to reliably complete a scoped task
triggers: [any task given as a single prompt]
invariants: [no leftover temporary files]
steps:
  - Restate the requirements.
  - Do the work.
  - Verify each requirement.
tools: [shell]
---

Prose details and examples.

Compilation into native formats

Canonical knowledge is compiled by the adapter into the specific executor's format: for Claude Code — CLAUDE.md + .claude/skills/<name>/SKILL.md, for Aider — a single CONVENTIONS.md, for Codex/OpenCode — AGENTS.md, for Goose — .goosehints, and so on. Edit in one place — it works everywhere.