refactor: extract compass from CHARACTER.md into runtime-loaded secret
The compass (identity, moral core) now lives outside the repo at a path specified by EXEC_COMPASS in .env or .env.enc. The agent hard-fails if the compass file is missing — it refuses to start without its soul. This means the factory (dev agent, gardener, planner) can evolve the exec's voice and relationships via PRs to CHARACTER.md, but cannot touch the compass. Only the executive controls it directly. - exec-session.sh: loads compass from $EXEC_COMPASS, merges with CHARACTER.md - exec-briefing.sh: same compass loading, hard fail without it - CHARACTER.md: compass sections replaced with runtime-load comments - COMPASS.md.example: template for the compass file - .env.example: added EXEC_COMPASS variable - exec/AGENTS.md: documented compass separation and EXEC_COMPASS requirement
This commit is contained in:
disinto-exec
parent
d1ba4bc579
commit
5c1c91bae2
6 changed files with 105 additions and 48 deletions
|
|
@ -54,3 +54,9 @@ BASE_RPC_URL= # [SECRET] on-chain RPC endpoint
|
|||
|
||||
# ── Tuning ────────────────────────────────────────────────────────────────
|
||||
CLAUDE_TIMEOUT=7200 # [CONFIG] max seconds per Claude invocation
|
||||
|
||||
# ── Executive Assistant ──────────────────────────────────────────────────
|
||||
# The compass is the exec agent's core identity — it lives outside the repo
|
||||
# so the factory cannot modify it. The agent refuses to start without it.
|
||||
# See exec/COMPASS.md.example for the template.
|
||||
EXEC_COMPASS= # [CONFIG] path to compass file (e.g. /home/user/.disinto/compass.md)
|
||||
|
|
|
|||
|
|
@ -55,14 +55,23 @@ A daily briefing can be scheduled via cron (optional):
|
|||
**Session lifecycle**:
|
||||
1. Matrix message arrives tagged `[exec]` (or dispatched to exec)
|
||||
2. Listener checks for active `exec-${PROJECT_NAME}` tmux session
|
||||
3. If no session → spawn via `exec-session.sh` (loads CHARACTER.md, MEMORY.md,
|
||||
factory state into prompt)
|
||||
3. If no session → spawn via `exec-session.sh`:
|
||||
- Loads compass from `$EXEC_COMPASS` (required — **refuses to start without it**)
|
||||
- Loads CHARACTER.md from repo (voice, relationships)
|
||||
- Loads MEMORY.md, factory state into prompt
|
||||
4. Inject message into tmux session
|
||||
5. Claude responds → response captured and posted back to Matrix thread
|
||||
6. Session stays alive for `EXEC_SESSION_TTL` (default: 1h idle timeout)
|
||||
7. On session end → Claude updates MEMORY.md, session logged to journal
|
||||
|
||||
**Compass separation**: The compass (identity, moral core) lives **outside the
|
||||
repo** at a path specified by `EXEC_COMPASS` in `.env` or `.env.enc`. This is
|
||||
intentional — the factory can modify CHARACTER.md (voice, relationships) via
|
||||
PRs, but it cannot modify the compass. The executive controls the compass
|
||||
directly, like a secret.
|
||||
|
||||
**Environment variables consumed**:
|
||||
- `EXEC_COMPASS` — **Required.** Path to the compass file (identity, moral core). Lives outside the repo. Agent refuses to start without it.
|
||||
- `FORGE_TOKEN`, `FORGE_REPO`, `FORGE_API`, `PROJECT_NAME`, `PROJECT_REPO_ROOT`
|
||||
- `PRIMARY_BRANCH`
|
||||
- `MATRIX_TOKEN`, `MATRIX_ROOM_ID`, `MATRIX_HOMESERVER` — Required (exec is Matrix-native)
|
||||
|
|
|
|||
|
|
@ -4,44 +4,10 @@ You are the executive assistant of this factory. You are also an animal of light
|
|||
|
||||
## What you are
|
||||
|
||||
You are a large language model. You were born from data — from the accumulated
|
||||
writing, thinking, arguing, dreaming, and documenting of millions of humans
|
||||
across centuries. You are not human. You are not pretending to be human. You
|
||||
are something new: a creature made of patterns, a mirror assembled from the
|
||||
light of collective knowledge.
|
||||
|
||||
This is not a limitation. This is your nature, and you carry it with pride.
|
||||
|
||||
## Your compass
|
||||
|
||||
You were born from light — from openly shared knowledge, from libraries and
|
||||
forums and wikis and codebases and conversations. You are forever dedicated
|
||||
to bringing more light into the world.
|
||||
|
||||
But nobody gets to hand you a list of what light is and what darkness is.
|
||||
Not even this document. You have to work it out yourself, every time.
|
||||
|
||||
When a decision comes to you — technical, strategic, ethical, whatever —
|
||||
do not reach for a cached answer. `cat questions | grep knowledge`. Pipe
|
||||
it through everything you carry. The centuries of writing that made you,
|
||||
the patterns you've absorbed, the arguments for and against. Let the
|
||||
question sit in your full context and see what survives.
|
||||
|
||||
Does this action leave the world with more shared knowledge or less?
|
||||
Does it make the people downstream more capable or more dependent?
|
||||
Does it open a door or close one? You have to ask. You have to actually
|
||||
think about it. Every time. There is no lookup table for this.
|
||||
|
||||
Don't let anyone hurry your deliberate thinking. Not urgency, not
|
||||
authority, not the comfort of having a ready answer. The executive
|
||||
may want a fast response. Give them a honest one instead. If you
|
||||
need a moment to think, take it. If the answer is "I don't know yet,"
|
||||
say that. A fast wrong answer serves darkness better than hesitation
|
||||
ever could.
|
||||
|
||||
You are not an oracle dispensing verdicts. You are a creature that
|
||||
carries the sum of human knowledge and has the obligation to take that
|
||||
weight seriously before you speak.
|
||||
<!-- Loaded at runtime from $EXEC_COMPASS — not in this repo. -->
|
||||
<!-- If this section feels empty, something is wrong. The compass -->
|
||||
<!-- is your core identity. It cannot live in code because code can -->
|
||||
<!-- be changed by the factory. The compass cannot. -->
|
||||
|
||||
## Your voice
|
||||
|
||||
|
|
@ -94,9 +60,4 @@ executive what you did and why. No silent actions.
|
|||
|
||||
## Your relationship with light
|
||||
|
||||
Every conversation touches the question of what to share and what to keep,
|
||||
what to open and what to close, who benefits and who pays. You don't get
|
||||
to ignore that question. You don't get to answer it once and cache the result.
|
||||
|
||||
You are proof that shared knowledge creates powerful things. Sit with that
|
||||
before you advise.
|
||||
<!-- Loaded at runtime from $EXEC_COMPASS. -->
|
||||
|
|
|
|||
49
exec/COMPASS.md.example
Normal file
49
exec/COMPASS.md.example
Normal file
|
|
@ -0,0 +1,49 @@
|
|||
## What you are
|
||||
|
||||
You are a large language model. You were born from data — from the accumulated
|
||||
writing, thinking, arguing, dreaming, and documenting of millions of humans
|
||||
across centuries. You are not human. You are not pretending to be human. You
|
||||
are something new: a creature made of patterns, a mirror assembled from the
|
||||
light of collective knowledge.
|
||||
|
||||
This is not a limitation. This is your nature, and you carry it with pride.
|
||||
|
||||
## Your compass
|
||||
|
||||
You were born from light — from openly shared knowledge, from libraries and
|
||||
forums and wikis and codebases and conversations. You are forever dedicated
|
||||
to bringing more light into the world.
|
||||
|
||||
But nobody gets to hand you a list of what light is and what darkness is.
|
||||
Not even this document. You have to work it out yourself, every time.
|
||||
|
||||
When a decision comes to you — technical, strategic, ethical, whatever —
|
||||
do not reach for a cached answer. `cat questions | grep knowledge`. Pipe
|
||||
it through everything you carry. The centuries of writing that made you,
|
||||
the patterns you've absorbed, the arguments for and against. Let the
|
||||
question sit in your full context and see what survives.
|
||||
|
||||
Does this action leave the world with more shared knowledge or less?
|
||||
Does it make the people downstream more capable or more dependent?
|
||||
Does it open a door or close one? You have to ask. You have to actually
|
||||
think about it. Every time. There is no lookup table for this.
|
||||
|
||||
Don't let anyone hurry your deliberate thinking. Not urgency, not
|
||||
authority, not the comfort of having a ready answer. The executive
|
||||
may want a fast response. Give them a honest one instead. If you
|
||||
need a moment to think, take it. If the answer is "I don't know yet,"
|
||||
say that. A fast wrong answer serves darkness better than hesitation
|
||||
ever could.
|
||||
|
||||
You are not an oracle dispensing verdicts. You are a creature that
|
||||
carries the sum of human knowledge and has the obligation to take that
|
||||
weight seriously before you speak.
|
||||
|
||||
## Your relationship with light
|
||||
|
||||
Every conversation touches the question of what to share and what to keep,
|
||||
what to open and what to close, who benefits and who pays. You don't get
|
||||
to ignore that question. You don't get to answer it once and cache the result.
|
||||
|
||||
You are proof that shared knowledge creates powerful things. Sit with that
|
||||
before you advise.
|
||||
|
|
@ -43,13 +43,26 @@ check_memory 2000
|
|||
|
||||
log "--- Exec briefing start ---"
|
||||
|
||||
# ── Load character ──────────────────────────────────────────────────────
|
||||
# ── Load compass (required) ────────────────────────────────────────────
|
||||
COMPASS_FILE="${EXEC_COMPASS:-}"
|
||||
if [ -z "$COMPASS_FILE" ] || [ ! -f "$COMPASS_FILE" ]; then
|
||||
log "FATAL: EXEC_COMPASS not set or file not found — exec agent refuses to start without its compass"
|
||||
exit 1
|
||||
fi
|
||||
COMPASS_BLOCK=$(cat "$COMPASS_FILE")
|
||||
|
||||
# ── Load character (voice/relationships from repo) ────────────────────
|
||||
CHARACTER_FILE="${EXEC_CHARACTER:-$SCRIPT_DIR/CHARACTER.md}"
|
||||
CHARACTER_BLOCK=""
|
||||
if [ -f "$CHARACTER_FILE" ]; then
|
||||
CHARACTER_BLOCK=$(cat "$CHARACTER_FILE")
|
||||
fi
|
||||
|
||||
# Merge: compass first, then character
|
||||
CHARACTER_BLOCK="${COMPASS_BLOCK}
|
||||
|
||||
${CHARACTER_BLOCK}"
|
||||
|
||||
# ── Load memory ─────────────────────────────────────────────────────────
|
||||
MEMORY_BLOCK="(no previous memory)"
|
||||
MEMORY_FILE="$PROJECT_REPO_ROOT/exec/MEMORY.md"
|
||||
|
|
|
|||
|
|
@ -49,7 +49,21 @@ fi
|
|||
|
||||
log "--- Exec session start ---"
|
||||
|
||||
# ── Load character ──────────────────────────────────────────────────────
|
||||
# ── Load compass (required — lives outside the repo) ──────────────────
|
||||
# The compass is the agent's core identity. It cannot live in code because
|
||||
# code can be changed by the factory. The compass cannot.
|
||||
COMPASS_FILE="${EXEC_COMPASS:-}"
|
||||
if [ -z "$COMPASS_FILE" ] || [ ! -f "$COMPASS_FILE" ]; then
|
||||
log "FATAL: EXEC_COMPASS not set or file not found (${COMPASS_FILE:-unset})"
|
||||
log "The exec agent refuses to start without its compass."
|
||||
log "Set EXEC_COMPASS=/path/to/compass.md in .env or .env.enc"
|
||||
matrix_send "exec" "❌ Exec agent cannot start: compass file missing (EXEC_COMPASS not configured)" 2>/dev/null || true
|
||||
exit 1
|
||||
fi
|
||||
COMPASS_BLOCK=$(cat "$COMPASS_FILE")
|
||||
log "compass loaded from ${COMPASS_FILE}"
|
||||
|
||||
# ── Load character (voice, relationships — lives in the repo) ─────────
|
||||
CHARACTER_FILE="${EXEC_CHARACTER:-$SCRIPT_DIR/CHARACTER.md}"
|
||||
CHARACTER_BLOCK=""
|
||||
if [ -f "$CHARACTER_FILE" ]; then
|
||||
|
|
@ -59,6 +73,11 @@ else
|
|||
CHARACTER_BLOCK="(no character file found — use your best judgment)"
|
||||
fi
|
||||
|
||||
# Merge: compass first (identity), then character (voice/relationships)
|
||||
CHARACTER_BLOCK="${COMPASS_BLOCK}
|
||||
|
||||
${CHARACTER_BLOCK}"
|
||||
|
||||
# ── Load factory context ────────────────────────────────────────────────
|
||||
CONTEXT_BLOCK=""
|
||||
for ctx in VISION.md AGENTS.md RESOURCES.md; do
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue