Agent Context & Exploration

This section is the working surface for Phase R research. It’s modeled on crosswalker’s agent-context/ pattern: freeform notes, decision logs, open problems, and exploration writing that doesn’t yet belong in the polished Concepts / Design / Reference layers.

What goes here

01

Decision logs

Timestamped entries in zz-log/. One file per decision or session. Captures the “why” at the moment of choosing, before the reasoning fades.

02

Open challenges

Hard problems currently being chewed on, in zz-challenges/. Not questions to ask later — problems that need exploration now.

03

Session context

Notes that help the next session (or the next agent) pick up where this one left off. Less formal than FOCUS.md in the .claude/ folder.

04

Exploration writing

First-draft thinking on topics that might become Concepts or Design pages later. Lower bar than the polished sections.

Naming conventions

• zz-log/ — the zz- prefix sorts these folders to the bottom of autogenerated sidebars. Files inside use the pattern YYYY-MM-DD-slug.mdx so they sort chronologically.
• zz-challenges/ — same zz- prefix for sort order. Files are named by challenge slug, not date.
• Top-level agent-context/*.mdx — general exploration pages that don’t fit the log or challenge categories. Use SCREAMING_SNAKE_CASE per the project style guide.

Relationship to .claude/ files

The .claude/ folder is agent-context too, but it’s the meta layer: PROJECT_CONTEXT, FOCUS, KNOWLEDGE_BASE_PHILOSOPHY, the numbered first-principles files. Those are read at session start to load context.

This section (docs/src/content/docs/agent-context/) is the rendered version: viewable in the wiki, searchable, crosslinkable from other pages. Content that’s useful to readers goes here; content that’s only useful to agents between sessions stays in .claude/.

Promotion path

zz-log/ entry  →  zz-challenges/ entry  →  Concepts page
       ↓                  ↓                      ↓
  "I did X on Tue"  "X is a hard problem"  "The problem is X"

When a zz-log entry produces a finding that generalizes, promote it to zz-challenges/. When a challenge is resolved or fully scoped, promote the resolution to Concepts/ or Design/. The zz- folders accumulate; the polished sections stay deliberately thin.