Stay organized and consistent using LLM workflow guides with project-specific overrides
Install project-guides in any repository with pip install project-guides, run project-guides init, then tell your LLM to "Read docs/guides/project-guide.md and start." The guide walks the LLM through planning documents, breaking work into stories, and implementing each story step-by-step. You just say "proceed" after each step. The developer stays in charge—guiding features, flow, and taste—while the LLM handles the typing.
This is "HITLoop" (human-in-the-loop) development: the developer directs, the LLM executes. The pace is "flaming agile"—an entire production-ready backend can be completed in 6-12 hours. When you customize a guide for your project, mark it as overridden so future package updates skip it. When you want the latest workflow improvements, run project-guides update to sync all non-overridden guides.
Install via pip or pipx for system-wide CLI access
pip install project-guides
Navigate to your project directory and initialize
project-guides init
Tell your LLM to read the guide and begin
Read `docs/guides/project-guide.md` and start.
Say "proceed" after each step as the LLM works
proceed
Mark guides as overridden when you customize them
project-guides override <guide-name>
Pull latest workflow improvements
project-guides update
See which guides are current, outdated, or overridden
project-guides status
Crafted guides walk your LLM from project concept through production release—planning docs, stories breakdown, step-by-step implementation.
Maintain LLM workflow guides in one package and distribute them across all your projects with a single command.
Track which guide versions are installed in each project and update to the latest versions automatically.
Lock customized guides to prevent accidental overwrites while still syncing other guides to latest versions.
Pull the newest workflow refinements into all non-overridden guides across projects with one command.
Works out of the box with sensible defaults—guides go in docs/guides, no config file needed for basic usage.
See at a glance which guides are current, outdated, overridden, or missing with color-coded status output.
When updating overridden guides with --force, automatic .bak files preserve your customizations.
Idempotent commands and explicit consent requirements ensure you never lose project-specific customizations.
Minimal dependencies (click, pyyaml, packaging) mean fast installation and no bloat.
Runs on macOS, Linux, and Windows with Python 3.11+ for consistent workflows everywhere.
82% test coverage with 53 comprehensive tests ensuring reliability and stability.
You direct features, flow, and taste. The LLM handles the typing. Human-in-the-loop collaboration at its best.
Complete an entire production-ready backend in 6-12 hours with structured, methodical LLM collaboration.
Guides enforce a proven methodology: planning documents, story breakdown, step-by-step implementation, approval gates.