The Trilogy
Governance, decisions, and execution — enforced by tools.
ShippedThree tools that turn agent improvisation into auditable, evidence-based execution — research earns decisions, visionlog records contracts, and ike executes within them.
The contract
Agents don't get to skip governance, guess at decisions, or lose track of execution. The trilogy enforces that contract with three tools, each handling one concern:
- visionlog records what the project has committed to — vision, goals, guardrails, ADRs. If a task would violate a guardrail, the answer is already no.
- research.md earns decisions with evidence. Candidates are scored against locked criteria. The research is the receipt.
- ike.md executes tasks within those contracts. Every task links to the goal it serves. Definition of Done is explicit, not assumed.
The flow
The three tools aren't a pipeline — they're a dance. Research can trigger new guardrails. Execution can surface findings that reopen research. Governance evolves from what execution discovers. Each tool can be used alone, but new capabilities emerge when they work together.
A decision earned in research.md becomes a contract in visionlog. A guardrail in visionlog constrains what ike.md can execute. A task completed in ike.md can surface evidence that feeds back into research.md. The loop is continuous, not linear.
Install
pip install visionlog-md research-md ike-mdThree packages. One contract. Each is an MCP server — agents read and write governance through tool calls.