amr/memex
1
0
Fork 0
Code Issues 12 Pull Requests Actions Packages Projects 1 Releases Wiki Activity

feat(arch): implement 'Code as Thought' architecture and formalize PSF Consensus Loop

Browse Source
This commit is contained in:
Amr Gharbeia
2026-03-31 13:03:26 -04:00
parent 5a9129132e
commit 1712b1e4a9
114 changed files with 3652 additions and 2581 deletions
Download Patch File Download Diff File Expand all files Collapse all files

57
system/skills/org-skill-scribe.org
View File

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

1
system/skills/org-skill-scribe.org Symbolic link
View File

@@ -0,0 +1 @@
/home/user/memex/notes/org-skill-scribe.org