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> |
||
|---|---|---|
| assets | ||
| automation | ||
| config | ||
| docs | ||
| src | ||
| tests | ||
| tools | ||
| .gitignore | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| GEMINI.md | ||
| README.md | ||
| VERSION | ||
| pyproject.toml | ||
README.md
CascadingDev (CDev)
CDev — short for Cascading Development — is a Git-native AI–human 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.ymldefines 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