Cascading Development Framework
Go to file
rob 5bfe3d3d9b test: add end-to-end stage promotion tests (specification tests)
Created comprehensive test suite for multi-stage discussion promotion:

**Tests Added (4 total):**
1. test_feature_to_design_promotion - Full promotion workflow
2. test_design_document_creation - Design doc generation
3. test_vote_threshold_not_met - Negative case validation
4. test_ai_votes_excluded_when_configured - Vote filtering

**Current Status:**
-  2 tests passing (negative cases: threshold not met, AI exclusion)
- ⏸️  1 test skipped (design doc creation - not fully implemented)
-  1 test failing (promotion logic needs pre-commit hook or direct automation call)

**Purpose:**
These tests serve as living specification for the expected behavior.
They document the complete promotion workflow and will pass once the
status update logic is fully integrated into the automation chain.

**Test Coverage:**
- Vote counting with human/AI filtering
- Promotion threshold validation
- Status transitions (OPEN → READY_FOR_DESIGN)
- Design discussion file generation
- Metadata header updates

Addresses PROGRESS.md Stage 3: "Add end-to-end design stage test"

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-02 20:15:43 -04:00
assets feat: comprehensive ADR-structured design document template 2025-11-02 20:14:00 -04:00
automation refactor: simplify workflow.py to use AI normalization with minimal fallback 2025-11-02 18:48:12 -04:00
config feat: add multi-provider AI system with model hint optimization 2025-11-01 21:43:13 -03:00
docs docs: update progress tracking for AI normalization implementation 2025-11-02 20:09:08 -04:00
src fix: sync installer ramble provider options 2025-11-02 01:13:27 -03:00
tests test: add end-to-end stage promotion tests (specification tests) 2025-11-02 20:15:43 -04: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