Cascading Development Framework
Go to file
rob 4e7ad11b4c feat: Implement vote parsing orchestrator and testing infrastructure
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>
2025-10-30 14:25:53 -03:00
assets build: Bundle automation/ and update pre-commit hook comment 2025-10-30 14:24:32 -03:00
automation feat: Implement vote parsing orchestrator and testing infrastructure 2025-10-30 14:25:53 -03:00
docs feat: Implement vote parsing orchestrator and testing infrastructure 2025-10-30 14:25:53 -03:00
src feat: Implement vote parsing orchestrator and testing infrastructure 2025-10-30 14:25:53 -03:00
tests feat: Implement vote parsing orchestrator and testing infrastructure 2025-10-30 14:25:53 -03:00
tools build: Bundle automation/ and update pre-commit hook comment 2025-10-30 14:24:32 -03:00
.gitignore 1st commit 2025-10-27 20:17:35 -03:00
AGENTS.md feat: Implement vote parsing orchestrator and testing infrastructure 2025-10-30 14:25:53 -03:00
CLAUDE.md docs: Add CLAUDE.md and restructure DESIGN.md for clarity 2025-10-30 12:31:33 -03:00
GEMINI.md uptodate agents 2025-10-30 13:17:58 -03:00
README.md 1st commit 2025-10-27 16:24:50 -03:00
VERSION 1st commit 2025-10-27 16:24:50 -03:00
pyproject.toml feat: Implement vote parsing orchestrator and testing infrastructure 2025-10-30 14:25:53 -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.
  • 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