Continual harness
Prime-agent-style persistent layer for lazar. One store, compact overview
always injected by hooks/session-start.d/00-harness-overview.sh.
Paths
- Global state:
$LAZAR_HOME/memory/harness/state.json - History:
$LAZAR_HOME/memory/harness/history.jsonl - Local (session):
$LAZAR_HOME/memory/sessions/<id>/harness.json - CLI:
python3 $LAZAR_HOME/skills/_meta/harness/harness.py
Kinds
| Kind | Use for |
|---|---|
memory |
Durable facts, prefs, pitfalls |
skill |
Pointers to procedures / when-to-use a skill |
prompt |
Narrow behavioral addenda (not full SOUL rewrites) |
subagent |
Delegation recipes for lazar-spawn |
Scope
global(default) — cross-sessionlocal— thisLAZAR_SESSION_IDonly
Commands
# Compact overview (what session-start injects)
python3 $LAZAR_HOME/skills/_meta/harness/harness.py overview
# Record a lesson after success/failure
python3 $LAZAR_HOME/skills/_meta/harness/harness.py add \
--kind memory \
--title "short-slug" \
--content "Specific actionable lesson" \
--evidence "what happened"
# Load full entry; optional upvote
python3 $LAZAR_HOME/skills/_meta/harness/harness.py load M-never-cat-stream-log --helpful
python3 $LAZAR_HOME/skills/_meta/harness/harness.py helpful <id>
python3 $LAZAR_HOME/skills/_meta/harness/harness.py unhelpful <id>
python3 $LAZAR_HOME/skills/_meta/harness/harness.py delete <id>
# First-time / refresh seed (+ import playbook + learnings)
python3 $LAZAR_HOME/skills/_meta/harness/harness.py seed
python3 $LAZAR_HOME/skills/_meta/harness/harness.py stats
Rules
- Smallest edit. One concrete lesson beats a paragraph dump.
- Evidence. Prefer
--evidencewhen refining from a real failure/success. - Global only if stable. Session-only progress →
--scope local(needs session id). - Do not duplicate.
addskips near-duplicate content unless--force. - Score usage. When an injected bullet actually helped,
helpful <id>. - Still write long provenance to
memory/distilled/if needed — harness holds the ranked actionable slice.
When to write
- User corrects you
- Same failure twice
- Stable preference discovered
- Spawn pattern that should be reused
- End of non-trivial task (1–2 bullets max)