feat(arch): finalize Universal Literate Note transition for all projects and skills
This commit is contained in:
@@ -1,36 +0,0 @@
|
||||
#+TITLE: PRD: Skill - Scribe Agent
|
||||
#+STATUS: FROZEN
|
||||
#+AUTHOR: Agent
|
||||
#+CREATED: [2026-03-31 Tue 13:45]
|
||||
|
||||
* 1. Purpose
|
||||
The Scribe Agent is the automated distillation and auditing engine for the PSF. Its primary goal is to prevent "context rot" by transforming daily captures into atomic notes and ensuring project compliance with PSF standards.
|
||||
|
||||
* 2. User Needs
|
||||
|
||||
** 2.1 Knowledge Distillation
|
||||
As a user (Amr), I need my ephemeral daily thoughts transformed into a structured knowledge base.
|
||||
- The Scribe MUST extract core concepts from `$MEMEX_DAILY`.
|
||||
- It MUST generate normalized atomic notes in `$MEMEX_NOTES`.
|
||||
- It MUST preserve provenance via `Source:` backlinks.
|
||||
|
||||
** 2.2 Incremental Processing
|
||||
I need the system to be efficient and avoid redundant work.
|
||||
- The Scribe MUST use Git state tracking (commit hashes) to identify only new content.
|
||||
- It MUST maintain state in a Lisp-native format (`scribe-state.lisp`) for full system introspection.
|
||||
|
||||
** 2.3 PSF Mandate Audit
|
||||
I need my foundry projects to maintain high integrity.
|
||||
- The Scribe MUST audit active projects for `PRD.org`, `PROTOCOL.org`, and Literate Programming blocks.
|
||||
- It MUST flag "Mandate Violations" in `institutional-memory.org`.
|
||||
|
||||
** 2.4 Autonomous Execution
|
||||
I need the Scribe to run reliably without manual intervention.
|
||||
- The skill must be compatible with cron-based triggers.
|
||||
- It must handle path normalization via environment variables.
|
||||
|
||||
* 3. Success Criteria
|
||||
- [ ] **Distillation Accuracy:** Scribe identifies a concept in a daily log and creates a correctly formatted atomic note.
|
||||
- [ ] **Provenance Check:** Atomic notes contain a valid `Source:` link back to the daily file.
|
||||
- [ ] **Audit Trigger:** Scribe correctly identifies a project missing a `PROTOCOL.org` and records the violation.
|
||||
- [ ] **State Persistence:** `distillation-state.json` is updated after every successful run.
|
||||
@@ -1,48 +0,0 @@
|
||||
#+TITLE: PROTOCOL: Skill - Scribe Agent
|
||||
#+STATUS: SIGNED
|
||||
#+AUTHOR: Architect-Agent
|
||||
#+CREATED: [2026-03-31 Tue 13:50]
|
||||
#+SIGNED: [2026-03-31 Tue 13:55] Agent (Architect)
|
||||
|
||||
* 1. Architectural Intent
|
||||
This protocol defines the shared Lisp interfaces for the Scribe skill. It ensures that the distillation of ephemeral thoughts and the auditing of foundry integrity are performed deterministically and with clear provenance.
|
||||
|
||||
Following the **Literate Mandate**, the Scribe skill's implementation must be tangled from its Org-mode source.
|
||||
|
||||
* 2. Semantic Interfaces
|
||||
|
||||
** 2.1 State Perception
|
||||
#+begin_src lisp
|
||||
(defun scribe-scan-for-knowledge-gaps ()
|
||||
"Uses 'git diff' against the last processed commit hash to identify new content in $MEMEX_DAILY.
|
||||
Returns a list of daily files with new content."
|
||||
)
|
||||
#+end_src
|
||||
|
||||
** 2.2 Concept Distillation
|
||||
#+begin_src lisp
|
||||
(defun scribe-distill-concept (daily-path concept-meta)
|
||||
"Transforms a raw capture into an atomic note.
|
||||
Input: (:title \"Concept Title\" :content \"Body text\" :source \"daily/2026-03-31.org\")
|
||||
Output: Path to the new note in $MEMEX_NOTES."
|
||||
)
|
||||
#+end_src
|
||||
|
||||
** 2.3 Mandate Auditing
|
||||
#+begin_src lisp
|
||||
(defun scribe-audit-foundry-mandate (project-name)
|
||||
"Checks a project for compliance with PSF Level 3 standards.
|
||||
Checks: PRD.org exists, PROTOCOL.org exists, src/ contains tangled blocks.
|
||||
Returns a list of violations or NIL if compliant."
|
||||
)
|
||||
#+end_src
|
||||
|
||||
** 2.4 Integrity Reporting
|
||||
#+begin_src lisp
|
||||
(defun scribe-record-violation (project-name violation-type)
|
||||
"Appends a Mandate Violation entry to notes/institutional-memory.org."
|
||||
)
|
||||
#+end_src
|
||||
|
||||
* 3. Integration with Cron and Git
|
||||
The Scribe runs as an asynchronous process. It MUST update `scribe-state.lisp` (containing a Lisp alist) and perform a Git commit after each successful batch.
|
||||
Reference in New Issue
Block a user