Architectural Upgrade 2026-03-30: Modular Emacs, org-gtd v4.0, and PSF Phase 1

system/skills/org-skill-scribe.org

@@ -0,0 +1,57 @@
+#+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