Skip to content

forkzero/lattice

Repository files navigation

Lattice

CI Release Latest Release License

A knowledge coordination protocol for the human-agent era.

Built by Forkzero.

Your AI agents write code. But do they know why? Lattice connects research, strategy, requirements, and implementation into a traversable knowledge graph — so agents (and humans) can trace any decision back to its source.

Sources (research, papers, data)
    ↓ supports
Theses (strategic claims)
    ↓ derives
Requirements (testable specifications)
    ↓ satisfied by
Implementations (code)

The Problem

Traditional tools fragment knowledge:

  • Research lives in docs, wikis, or someone's head
  • Strategy is implicit or buried in meetings
  • Requirements are in Jira/Notion without traceability
  • Code exists without knowing why it was built

AI agents make this worse. They implement requirements without understanding the reasoning. When requirements change, nobody knows what code is affected.

How Lattice Helps

Capability What it means
Traceability Every requirement links to strategic theses. Every thesis links to research.
Drift detection When requirements change, implementations bound to old versions are flagged.
Bidirectional feedback Implementations can challenge or validate theses. Gaps flow upstream.
Agent-native MCP server, structured queries, JSON output. Agents can reason about the graph.
Git-native YAML files in .lattice/. No database. Branch, merge, version control.

Quick Look

# What should I work on?
$ lattice plan REQ-AUTH-001 REQ-AUTH-002
Ready to implement:
  REQ-AUTH-001  JWT Authentication  (P0, all deps verified)

Blocked:
  REQ-AUTH-002  OAuth Integration   (depends on REQ-AUTH-001)

# Why does this requirement exist?
$ lattice get REQ-AUTH-001
REQ-AUTH-001: JWT Authentication
Derives from: THX-SECURITY-FIRST (v1.0.0)
Body: Implement JWT-based authentication with refresh tokens...

# Has anything drifted?
$ lattice drift
DRIFT DETECTED:
  REQ-AUTH-001 changed: 1.0.0 → 1.1.0
    ↳ IMP-AUTH-JWT bound to 1.0.0 — NEEDS RE-VERIFICATION

Comparison

Jira/Linear Notion/Confluence Beads Spec Kit Lattice
Tracks requirements
Links to research/strategy ~
Version-bound edges
Drift detection
Bidirectional feedback
Git-native
MCP server

Core Concepts

Nodes — Four artifact types:

  • Source: Research (papers, data, citations)
  • Thesis: Strategic claims derived from research
  • Requirement: Testable specifications derived from theses
  • Implementation: Code that satisfies requirements

Edges — Typed, version-bound relationships:

  • supports, derives, satisfies, depends_on
  • reveals_gap_in, challenges, validates (feedback flows upstream)

Resolution — Requirements track status:

  • verified (implemented + tested)
  • blocked (waiting on dependency)
  • deferred (postponed)
  • wontfix (rejected)

Installation

macOS / Linux:

curl -fsSL https://forkzero.ai/lattice/install.sh | sh

Windows (PowerShell):

irm https://forkzero.ai/lattice/install.ps1 | iex

Or download from GitHub Releases.

Platform-specific binaries
Platform Binary
macOS Apple Silicon lattice-VERSION-aarch64-apple-darwin.tar.gz
macOS Intel lattice-VERSION-x86_64-apple-darwin.tar.gz
Linux x86_64 lattice-VERSION-x86_64-unknown-linux-gnu.tar.gz
Linux ARM64 lattice-VERSION-aarch64-unknown-linux-gnu.tar.gz
Windows x86_64 lattice-VERSION-x86_64-pc-windows-msvc.tar.gz

Getting Started

# Initialize in your project
lattice init

# Or initialize with Claude Code skill + agent support
lattice init --skill

# Add a requirement
lattice add requirement \
  --id REQ-AUTH-001 \
  --title "JWT Authentication" \
  --body "Implement JWT-based auth with refresh tokens" \
  --priority P0 \
  --category AUTH

# Query the lattice
lattice summary              # Overview
lattice list requirements    # All requirements
lattice get REQ-AUTH-001     # Full details

# Search with filters
lattice search -q "auth"                        # Keyword search (ranked by relevance)
lattice search -q "auth" --priority P0           # Filter by priority
lattice search -q "token" --min-score 2.0        # Only title+body matches
lattice search --tag mvp --resolution unresolved # Unresolved MVP items
lattice search --semantic -q "authentication"    # Hybrid keyword+semantic search

# Export
lattice export --format json > lattice-data.json
lattice export --format pages --output _site
lattice export --format html --output docs/
lattice export --audience investor

Publishing Documentation

Lattice can publish an interactive dashboard to GitHub Pages with a single command. Add this to your CI:

# .github/workflows/pages.yml
- run: curl -fsSL https://forkzero.ai/lattice/install.sh | sh
- run: lattice export --format pages --output _site

The pages format exports lattice-data.json and a redirect index.html that points to the hosted reader on forkzero.ai. The GitHub Pages URL is derived automatically from your git remote.

The reader displays stats, coverage, resolution status, priority breakdown, traceability tree, and filterable requirements — all from the JSON export.

You can also use lattice export --format html for a self-contained HTML dashboard.

For AI Agents

Claude Code (recommended)

# Install the /lattice skill and product-owner agent
lattice init --skill

This creates .claude/skills/lattice/SKILL.md (a /lattice skill with commands, workflow, and node/edge reference) and .claude/agents/product-owner.md (a product owner agent for backlog triage and planning).

MCP Server

Lattice includes an MCP server for broader AI integration:

# Run as MCP server
lattice mcp

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "lattice": {
      "command": "lattice",
      "args": ["mcp"]
    }
  }
}

MCP Tools: lattice_summary, lattice_search, lattice_get, lattice_list, lattice_resolve, lattice_add_requirement, lattice_drift

Manual CLAUDE.md snippet

# Generate CLAUDE.md integration snippet
lattice prompt >> CLAUDE.md
lattice prompt --mcp >> CLAUDE.md

Self-Describing

Lattice is built with Lattice. The .lattice/ directory contains sources, theses, and requirements for Lattice itself.

View Live Documentation

lattice list requirements
lattice export --audience overview

Status

v0.1.1 — Pages export format, JSON metadata wrapper, duplicate ID guard, git remote config.

See docs/STRATEGIC_VISION.md for the full vision.

License

Copyright (c) 2026 Forkzero. All rights reserved. See LICENSE for details.

About

A knowledge coordination protocol for human-agent collaboration. Connects research → strategy → requirements → implementation into a traversable, version-aware graph.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors