#+TITLE: SKILL: Scribe Agent (Distillation Sub-Agent)
#+ID: skill-scribe-agent
#+STARTUP: content
#+FILETAGS: :scribe:distillation:psf:audit:

* Overview
The **Scribe Agent** is an automated distillation sub-agent designed to ensure that the Memex never suffers from "context rot." It is the primary custodian of the **Institutional Memory**, responsible for Phase F (Memory) of the [[file:../notes/personal-software-foundry.org][Personal Software Foundry (PSF)]] Consensus Loop.

It operates as a bridge between the high-frequency, chaotic stream of **Daily Captures** and the high-integrity, structured environment of **Atomic Notes**.

* Operational Context
The Scribe runs as an isolated OpenClaw cron job, triggered nightly. It requires absolute path stability, pulling its environment variables directly from the system `.env` file to locate:
- `$MEMEX_DAILY`: The raw capture stream.
- `$MEMEX_NOTES`: The permanent Zettelkasten.
- `$MEMEX_SYSTEM`: The state and configuration root.

* The Distillation Pipeline
The Scribe does not simply copy text; it performs a cognitive filter to identify concepts that deserve permanence.

** 1. State Perception
The agent begins by identifying the "Knowledge Gap"—the delta between what has been distilled and what is new. It uses a state file to track the last processed Git commit hash.

** 2. Delta Analysis
By running a `git diff` against the daily folder, the Scribe identifies only the new thoughts, preventing redundant processing and saving token context.

** 3. Conceptual Extraction
For each new capture, the Scribe:
- **Analyzes:** Determines the single, core concept of the note.
- **Normalizes:** Generates a `kebab-case` filename (without dates).
- **Format:** Ensures the note is a valid Org-mode node with a unique `#+ID`.
- **Provenance:** Includes a `Source:` backlink to the specific daily file, preserving the chain of thought.

* The PSF Mandate Audit
A critical secondary function of the Scribe is to act as the "Quality Guard" for the Foundry. It proactively audits all active projects to ensure they adhere to the **Level 3 Standard**.

** Audit Checks:
- **Blueprint Integrity:** Does every project have a `PRD.org` and a `PROTOCOL.org`?
- **The Org Mandate:** Are there any forbidden `.md` files in the project root?
- **Knuth-Sovereign Principle:** Do implementation files in `src/` use Literate Programming blocks?

** Failure Handling:
If a project fails the audit, the Scribe records a **Mandate Violation** in [[file:../notes/institutional-memory.org][institutional-memory.org]]. This prevents the agent from assuming a project is "Stable" when it is architecturally incomplete.

* Symbolic Directive
When the agent's cognitive engine is invoked, it follows this strict execution sequence:

#+begin_src markdown
1. Read $MEMEX_SYSTEM/distillation-state.json
2. Run git diff <last_commit_hash> HEAD -- $MEMEX_DAILY/
3. For every new capture:
   a. Extract concept.
   b. Generate kebab-case filename.
   c. Write to $MEMEX_NOTES/ with ID and Provenance.
4. Run PSF Mandate Audit.
5. Record violations in institutional-memory.org.
6. Update distillation-state.json.
#+end_src