btb-workflow
CommunityShip via docs, progress, and feedback
Software Engineering#test-driven development#progress tracking#documentation workflow#phased implementation#human-ai collaboration#git commit validation#design to MVP
Authorships
Version1.0.0
Installs0
System Documentation
What problem does it solve?
BTB workflow prevents humans and AI from drifting out of sync by making documentation the single source of truth and requiring PROGRESS.md updates before any commit.
Core Features & Use Cases
- Documentation-driven development: Start from SPECS/README.md and follow the intended reading order so every participant knows what to do next.
- Mandatory progress tracking: Update SPECS/PROGRESS.md before committing, with checks for report date, branch, and (on claude/ branches) session ID.
- Design → MVP → phased implementation loop: Keep DESIGN and MVP long-lived while implementation proceeds in phases with a feedback loop that can adjust scope or request human input.
Use this when you collaborate in a repository that has (or will add) a SPECS/ directory with README.md and PROGRESS.md and supports iterative development across multiple phases.
Quick Start
Run the BTB pre-commit validator to ensure PROGRESS.md is updated before you commit in the current repository state.
Dependency Matrix
Required Modules
None requiredComponents
scriptsassets
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: btb-workflow Download link: https://github.com/ships/eden/archive/main.zip#btb-workflow Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.