Evolution Toolkit

How to use: Set EVOLUTION_TOOLKIT_WORKSPACE to the target workspace, then run the script that matches the cognitive task. Load protocols/session-continuity.md or protocols/thinking-partner.md when the task is about handoffs or problem framing.

Triggers

Use this skill when the request is about any of these:

• - Session end, handoff, continuity, preserving context between runs
• "How am I reasoning?" or "compare these sessions/documents"
• Contradictions, drift, conflicting instructions, stale guidance
• Prediction logging, confidence calibration, decision audits
• Improving a prompt/playbook through repeated eval loops
• Switching into Socratic questioning instead of direct advice
• Cross-session consistency, identity drift, recurring themes

Workspace

Export a writable workspace before running any script that writes state:

CODEBLOCK0

Expected layout:

• - INLINECODE3
• INLINECODE4 for session imprints
• INLINECODE5 for coherence reports
• INLINECODE6 if you want session-imprint context
• INLINECODE7 if you want prediction logging

Scripts

INLINECODE8

• - Interactive session-end handoff.
• Use --read, --list, or --diff to inspect existing imprints.

INLINECODE12

• - Measures reasoning style across 14 dimensions.
• Useful for one file, today's log, all imprints, or historical comparisons.

INLINECODE13

• - Scans guidance files in the workspace for conflicting directives, stale references, and drift.

INLINECODE14

• - Logs predictions and audits calibration.
• Requires memory/prediction-log.md with ## Log and ## Calibration sections.

INLINECODE18

• - Runs an iterative generate -> evaluate -> improve loop for a configurable playbook.
• Requires a config file; see config.example.json.

INLINECODE20

• - Classifies a problem into thinking phase and outputs friction-injecting questions.

INLINECODE21

• - Analyzes daily logs for persistent themes, energy, and drift.
• Writes a report to memory/research/ by default.

Quick Commands

CODEBLOCK1

Protocols

Read these only when relevant:

• - protocols/session-continuity.md: how to end and resume sessions cleanly
• INLINECODE24: how to add useful friction instead of reflexive answers

Notes

• - Write-capable scripts exit early with a clear warning if the target workspace is not writable.
• INLINECODE25 is intentionally config-driven so the package stays product-neutral.
• The toolkit does not ship credentials. API keys must come from env vars or your own workspace secrets.