Getting Started with SpecFact CLI
SpecFact starts as AI-bloat defense for Python-first AI-assisted code: run deterministic review, inspect the cleanup forecast, hand remediation packets to your AI IDE, and re-run for proof. The same local CLI also supports contract/spec evidence, brownfield analysis, and team gates when you need more depth.
ai_bloat findings are cleanup candidates, not AI-authorship detection. For exact simplify flags
and report fields, use the AI bloat quickstart
on the modules docs site.
Start Here
- Where to Start - New-user overview: what SpecFact is for, what core owns, and what to do next
Installation
- Installation Guide - All installation options (uvx, pip, Docker, GitHub Actions)
- Enhanced Analysis Dependencies - Optional dependencies for graph-based analysis
Quick Start
# Zero-install AI-bloat defense pass
uvx specfact-cli init --profile solo-developer
uvx specfact-cli code review run --path . --scope full
See the 5-Minute Quickstart for a complete walkthrough.
Core Commands
| Command | Purpose |
|---|---|
specfact init |
Bootstrap and IDE setup (reference) |
specfact module |
Module lifecycle management (reference) |
specfact upgrade |
CLI updates (reference) |
After Setup
- Bootstrap Checklist - Verify modules are installed
- Command Reference - Full command surface
- Brownfield Engineer Guide - Modernizing legacy code
Module Tutorials
Module-specific tutorials are hosted on the modules site:
- Backlog Quickstart Demo - End-to-end backlog workflow
- Backlog Refine with AI IDE - Story quality and refinement
- Daily Standup and Sprint Review - Standup automation