passepartout: v0.4.1 Design Cleanup

- Remove system-prompt-augment mechanism, introduce *standing-mandates*
- Fix false token-overhead claims in DESIGN_DECISIONS + ROADMAP
- Update security vector count 9-10 across all docs and dispatcher docstring
- Rewrite README with agent section, soften aspirational claims
- Register 10 cognitive tools in programming-tools.org with test suite
- Enforce NO-HARDCODED-CONSTANTS in .env.example
- ROADMAP: mark v0.3.x patches DONE, add LOGBOOKs, mark releases
- AGENTS.md: rewrite compact (180 to 50 lines), move refs to CONTRIBUTING
- Normalize org tangle directives to file-level PROPERTY inheritance

org/core-skills.org

@@ -72,10 +72,10 @@ Simple mask function and the vault memory hash table. Used by the Security Dispa
 
 ** Skill data structures
 
-The ~skill~ struct holds all metadata about a loaded skill: its name, priority, dependencies, trigger function, probabilistic prompt generator, deterministic gate, and system prompt augmentor. The ~skill-entry~ struct tracks the loading state of each discovered skill file.
+The ~skill~ struct holds all metadata about a loaded skill: its name, priority, dependencies, trigger function, probabilistic prompt generator, and deterministic gate. The ~skill-entry~ struct tracks the loading state of each discovered skill file.
 
 #+begin_src lisp
-(defstruct skill name priority dependencies trigger-fn probabilistic-prompt deterministic-fn system-prompt-augment)
+(defstruct skill name priority dependencies trigger-fn probabilistic-prompt deterministic-fn)
 #+end_src
 
 #+begin_src lisp
@@ -87,6 +87,13 @@ The ~skill~ struct holds all metadata about a loaded skill: its name, priority,
   "Tracks all discovered skill files and their loading state.")
 #+end_src
 
+#+begin_src lisp
+(defvar *standing-mandates* nil
+  "List of functions (context) → string-or-nil. Each is called on every think() cycle.
+When non-nil, the returned string is injected into the IDENTITY section of the system prompt.
+Unlike skills (which activate on triggers), standing mandates are always consulted.")
+#+end_src
+
 #+begin_src lisp
 (defstruct skill-entry filename (status :discovered) error-log (load-time 0))
 #+end_src
@@ -114,14 +121,22 @@ This is how the system determines which skill "owns" the current user input. For
     (first (sort triggered #'> :key #'skill-priority))))
 #+end_src
 
+** Standing Mandates
+
+Standing mandates are cross-cutting instructions injected into every LLM system prompt. They live in ~*standing-mandates*~, a list of functions ~(context) → string-or-nil~. Each is called on every reasoning cycle; nil results are skipped.
+
+This is the mechanism for always-on behavioral instructions. Skills call their registered trigger function to determine if they should activate for a given context; standing mandates always run and decide themselves whether to contribute text. Use ~push~ to register:
+
+#+begin_example
+(push #'my-mandate *standing-mandates*)
+#+end_example
+
 ** Skill registration macro (defskill)
 
 The primary API for skills. Each skill file calls this once to register itself. The macro creates a ~skill~ struct and stores it in ~*skill-registry*~ keyed by the skill's name.
 
-The ~:system-prompt-augment~ slot is optional. If provided, it's a function that receives the context and returns a string to append to the LLM's system prompt. This allows skills to inject domain-specific instructions into every reasoning cycle.
-
 #+begin_src lisp
-(defmacro defskill (name &key priority dependencies trigger probabilistic deterministic system-prompt-augment)
+(defmacro defskill (name &key priority dependencies trigger probabilistic deterministic)
   "Registers a new skill. NAME is a keyword. TRIGGER is a function (context) → bool."
   `(setf (gethash (string-downcase (string ,name)) *skill-registry*)
          (make-skill :name (string-downcase (string ,name)) 
@@ -129,8 +144,7 @@ The ~:system-prompt-augment~ slot is optional. If provided, it's a function that
                     :dependencies ',dependencies
                     :trigger-fn ,trigger 
                     :probabilistic-prompt ,probabilistic 
-                    :deterministic-fn ,deterministic
-                    :system-prompt-augment ,system-prompt-augment)))
+                    :deterministic-fn ,deterministic)))
 #+end_src
 
 ** Dependency resolution (skill-dependencies-resolve)