visionlog

What it does

visionlog is the static St. Peter of your project. It records what the project has committed to — the vision, the goals, the guardrails — and enforces those contracts across every agent session. If a task would violate a guardrail, St. Peter has already said no.

Key features

• Vision documents — set the north star once, reference it everywhere
• Goals with DAG — goals depend on and unlock other goals
• Guardrails — constraints the system must never violate, with rule/why/violation examples
• ADRs — architectural decision records that persist across sessions
• SOPs — standard operating procedures agents follow consistently
• MCP server — agents read and write governance through tool calls

Install

pip install visionlog-md

Quick start

# As MCP tool calls from an agent:
project_set  path: "/path/to/project"    # returns project_id
visionlog_boot  project_id: "..."        # active guardrails + goal state
visionlog_guide  project_id: "..."       # vision + decisions + goal map

# Create governance artifacts:
vision_set       title: "..." body: "..."
guardrail_create title: "No hard deletes"
goal_create      title: "Launch MVP" status: "available"

Vision remains sticky across sessions — it doesn't drift. Guardrails are active or deprecated, never deleted. ADRs are immutable once accepted — new ADRs supersede rather than overwrite.

The trilogy

visionlog is the first pillar of the Eidos trilogy. The flow is one-way: research.md earns decisions with evidence, visionlog records those decisions as contracts, and ike.md executes tasks within those contracts.