Major implementation milestone - core automation is now functional: 1. Add automation/workflow.py (Phase 1 - Vote Parsing) - Parse VOTE: lines from discussion files - Track latest vote per participant - Print human-readable vote summaries - Non-blocking (always exits 0) - Proper error handling for missing files/git failures - 158 lines of production-quality code 2. Add testing infrastructure - Create tests/ directory with pytest configuration - Add test_utils.py with actual version reading test - Add test_template_meta.py (stubs for META system tests) - Add test_build.py (stub for build verification) - Configure pytest in pyproject.toml (pythonpath) - All 4 tests passing 3. Add AGENTS.md - Developer guidelines - Project structure and module organization - Build, test, and development commands - Coding style and naming conventions - Testing guidelines - Commit and PR guidelines 4. Update docs/DESIGN.md - Document workflow.py implementation - Update automation status from "planned" to "implemented" - Clarify Phase 1 vs future phases 5. Code cleanup - Remove empty stub modules - Delete src/cascadingdev/feature_seed.py - Delete src/cascadingdev/fs_scaffold.py - Delete src/cascadingdev/ramble_integration.py - Delete src/cascadingdev/rules_seed.py Impact: - Users can now see vote counts in their commits - Testing foundation enables safe refactoring - Code is cleaner with only working modules - Week 1 implementation goals complete 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> |
||
|---|---|---|
| assets | ||
| automation | ||
| 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.
- 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