{"repo":"av/facts","free":true,"listed":false,"github":"https://github.com/av/facts","clone":"git clone https://github.com/av/facts.git","description":"Antidote for fluffy specs, a toolkit for fact-driven development with AI agents","language":"Rust","stars":198,"topics":["agents","claude-code","codex","copilot","gemini","llm","skills","spec-driven-development","specification","vibe-coding"],"license":null,"category":"ai-agents","readme_excerpt":"https://github.com/user-attachments/assets/80981efb-8bab-47ee-a567-3eb6071321ad Read your entire project spec in 30 seconds. Verify it in one command. Your project has 48 facts, 31 of them implemented: code-backed, verified by command. 12 are specs your agent is working through. 5 are rough drafts you'll refine later. You know all of this because you ran facts check . That's a .facts file, where each line is one atomic claim about your project. Tags track where each fact is in its lifecycle: @draft (rough idea), @spec (precise, ready to build), @implemented (true, code-backed). Your agent manages the transitions. The format is a flat list of claims: short enough to read in full, structured enough to manage, and when a fact has a shell command, the machine verifies it so the agent doesn't have to. Install Give your agent the facts skill: Then ask it to Init facts . It detects your stack, creates a .facts file with initial project truths, and sets up the full workflow. Manual install It's a single Rust binary with two dependencies, running on Linux, macOS, and Windows. Then scaffold your project: Agent skills Four skills ship with every install. Your agent uses them to manage the full lifecycle without you directing every step. Skill What it does ------- ------------- facts Core operations: read the spec, check it, add and edit facts facts-discover Scan the codebase, classify every fact by lifecycle stage, add missing truths facts-refine Pick up @draft facts, sharpen them into ","default_branch":null,"files":null,"tree":[],"storefront":"/r/av","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/av/facts/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}