m0n0x41d/haft
Engineering decisions engine that know when they're stale. Frame, compare, decide — with evidence decay and parity enforcement. For Claude Code, Cursor, Gemini CLI, Codex and more.
What it solves
Haft provides a local governance layer for AI coding agents, preventing the loss of critical project context. It ensures that the "memory" of a project—such as the problem being solved, compared options, human decisions, and supporting evidence—is durable and structured rather than being lost in transient chat histories.
How it works
Haft acts as an intermediary between the human, the AI agent, and the repository. It implements the First Principles Framework (FPF), a rigorous system for engineering thinking, and provides this framework as a versioned source for the agent to query.
It operates through three primary surfaces:
- MCP Server: A Model Context Protocol server (
haft serve) that provides programmatic access and enforces "kernel gates" (server-side validation of required fields and authority boundaries). - Skills: Specialized procedures integrated into agents (e.g.,
/h-framefor clarifying problems,/h-decidefor binding decisions) that guide the agent's workflow. - CLI: Direct manual access to the project's artifact graph and memory via commands like
haft artifactandhaft spec.
Project data is stored locally in a SQLite database and markdown carriers in a .haft/ directory.
Who it’s for
Software engineers using AI coding agents (such as Claude Code, Codex, Grok, or Cursor) who need a formal, durable way to track engineering decisions, specifications, and project governance within their codebase.
Highlights
- Reliance-bearing memory: Distinguishes between casual chat reasoning and formal project records that future work must rely on.
- Kernel gates: Enforces structural and authority boundaries server-side rather than relying on prompt-based discipline.
- Evidence decay: Tracks when evidence for a decision has gone stale and surfaces it for review.
- Source-native FPF delivery: Allows agents to retrieve versioned FPF source material with provenance.
- Human-in-the-loop: Ensures binding decisions and commissions remain the explicit authority of the human principal.
Related
- Project
- Project
- Project
- Project
- Project