Facts.

Facts

Facts is a powerful CLI tool that transforms how development teams manage project specifications. It replaces scattered documentation with a single, machine-verifiable source of truth where every claim about your codebase can be tracked, validated, and evolved through an automated lifecycle from draft to implementation.

Product Highlights

• AI-Native Workflow: Four built-in agent skills (discover, refine, implement, check) enable autonomous spec management without micromanagement
• Lifecycle Tagging: Built-in @draft, @spec, and @implemented tags create clear visibility into what's planned, ready to build, and already done
• Command Verification: Shell commands attached to facts enable automated validation—154 of 224 facts in the dogfooding repo verify themselves
• Flat, Readable Format: .facts files use plain Markdown with YAML sections, readable in 30 seconds yet structured enough for machine processing
• Universal Compatibility: Single Rust binary runs on Linux, macOS, and Windows with minimal dependencies

Use Cases

• Spec-Driven Development: Replace PRDs and wikis with living documents that evolve as your code does
• AI-Assisted Coding: Give Claude, Copilot, or other agents structured context about your project for more accurate code generation
• Continuous Verification: Integrate facts check into CI/CD to catch spec drift before it reaches production
• Knowledge Transfer: Onboard developers with a complete, always-current picture of system behavior and constraints

Target Audience

Facts is designed for software teams practicing AI-assisted or spec-driven development, particularly those using Claude Code, GitHub Copilot, or similar agents who need structured project context to deliver reliable results.