Cascading Development Framework
Go to file
rob 22944a2a49 docs: add comprehensive implementation progress tracker
Add docs/PROGRESS.md - a living document that tracks implementation
status across all milestones with detailed checklists.

**Structure:**
- Quick status overview table (Milestone completion %)
- Milestone-by-milestone breakdown (M0-M4)
- Checkbox lists for every deliverable
- Stage-by-stage breakdown for M2
- File/line references for verification
- Next steps sections for each component
- Update instructions for maintainers

**Key Features:**
- Visual progress tracking (  🚧)
- Completion percentages per section
- Specific missing items highlighted
- Clear next steps for each stage
- Easy to update (just check boxes)
- 431 lines covering all aspects

**Current Status Snapshot:**
- M0: Process Foundation - 100% 
- M1: Orchestrator MVP - 100% 
- M2: Stage Automation - 40% 🚧 (3/7 stages)
- M3: Gitea Integration - 0% 
- M4: Python Migration - 100% 
- Overall: ~55% complete

**Benefits:**
- No need to reassess entire project each time
- Quick reference for what's done vs. what's left
- Clear roadmap for contributors
- Tracks implementation vs. design intent
- Shows where to focus effort next

This replaces ad-hoc status assessments with a maintained living document.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-01 22:13:56 -03:00
assets feat: add multi-provider AI system with model hint optimization 2025-11-01 21:43:13 -03:00
automation fix: default missing status field to OPEN in question formatting 2025-11-01 21:58:32 -03:00
config feat: add multi-provider AI system with model hint optimization 2025-11-01 21:43:13 -03:00
docs docs: add comprehensive implementation progress tracker 2025-11-01 22:13:56 -03:00
src build: bundle shared ai config into installer 2025-11-01 14:44:25 -03:00
tests feat: parse codex exec json output for fallbacks 2025-11-01 17:28:57 -03:00
tools feat: add multi-provider AI system with model hint optimization 2025-11-01 21:43:13 -03:00
.gitignore 1st commit 2025-10-27 20:17:35 -03:00
AGENTS.md fix: Add YAML syntax fix and mock AI script for testing 2025-10-31 09:18:59 -03:00
CLAUDE.md docs: comprehensive AI configuration documentation update 2025-11-01 21:48:25 -03:00
GEMINI.md uptodate agents 2025-10-30 13:17:58 -03:00
README.md docs: comprehensive AI configuration documentation update 2025-11-01 21:48:25 -03:00
VERSION 1st commit 2025-10-27 16:24:50 -03:00
pyproject.toml fix: Add YAML syntax fix and mock AI script for testing 2025-10-31 09:18:59 -03:00

README.md

CascadingDev (CDev)

CDev — short for Cascading Development — is a Git-native AIhuman collaboration framework that automates documentation, discussion summaries, and code review directly within your repository.
It lets you build self-documenting projects where AI assists in generating and maintaining feature discussions, design docs, and implementation plans — all version-controlled alongside your code.


Key Features

  • Git-Integrated Workflow — every discussion, decision, and artifact lives in Git.
  • Multi-Provider AI System — automatic fallback chains (Claude → Codex → Gemini) with intelligent model selection (fast/quality).
  • Cascading Rules System — nearest .ai-rules.yml defines how automation behaves.
  • Stage-Per-Discussion Model — separate files for feature, design, implementation, testing, and review.
  • Pre-commit Hook — automatically maintains summaries, diagrams, and vote tallies.
  • Ramble GUI — friendly PySide6/PyQt5 dialog for capturing structured feature requests.
  • Deterministic Builds — a reproducible installer bundle you can unzip and run anywhere.

🚀 Quick Start (Developers)

# 1. Create and activate a virtual environment
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip wheel PySide6

# 2. Build the installer bundle
python tools/build_installer.py

# 3. Test-install into a temporary folder
python install/cascadingdev-*/setup_cascadingdev.py --target /tmp/myproject --no-ramble