rob
/
CascadingDev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Cascading Development Framework
41 Commits 2 Branches 0 Tags 576 KiB
Python 96.7%
Shell 3%
Dockerfile 0.3%
Go to file
rob 188f6b3b16 fix: Handle empty AI diffs gracefully instead of raising errors 
Changed approach from disabling outputs to properly handling AI's decision
not to generate changes (e.g., gated outputs, conditional rules).

Changes:

1. patcher.py - Allow empty diffs
   - sanitize_unified_patch() returns empty string instead of raising error
   - generate_output() returns early for empty patches (silent skip)
   - Common case: implementation_gate_writer when status != READY_FOR_IMPLEMENTATION
   - AI can now return explanatory text without a diff (no error)

2. features.ai-rules.yml - Override README rule
   - Add README.md → "readme_skip" association
   - Creates empty rule to disable README updates in Docs/features/
   - Prevents unnecessary AI calls during feature discussions
   - README automation still works in root directory

3. root.ai-rules.yml - Restore default README rule
   - Removed "enabled: false" flag (back to default enabled)
   - Features directory overrides this with empty rule

Benefits:
- implementation_gate now calls AI but AI returns empty diff (as designed)
- No more "[runner] error generating ...implementation.discussion.md"
- No more "[runner] error generating README.md"
- Clean separation: AI decides vs. config disables
- Instructions to AI are still executed, AI just chooses no changes

Testing:
Setup completes cleanly with no [runner] errors. The automation
runs and AI correctly returns no diff for implementation file
when status is OPEN.

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

Co-Authored-By: Claude <noreply@anthropic.com>
 		2025-11-01 02:33:31 -03:00
assets fix: Handle empty AI diffs gracefully instead of raising errors 2025-11-01 02:33:31 -03:00
automation fix: Handle empty AI diffs gracefully instead of raising errors 2025-11-01 02:33:31 -03:00
docs updated uml diagrams 2025-10-31 23:19:35 -03:00
src fix: Eliminate race condition by letting automation generate discussion files 2025-11-01 01:22:12 -03:00
tests fix: Add YAML syntax fix and mock AI script for testing 2025-10-31 09:18:59 -03:00
tools fix: Add YAML syntax fix and mock AI script for testing 2025-10-31 09:18:59 -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: 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 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 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.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