rob
/
CascadingDev_simplified
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Git-native AI collaboration framework - simplified core with hooks and cascading rules
25 Commits 2 Branches 0 Tags 354 KiB
Python 92.6%
Shell 5.1%
Dockerfile 2.3%
Go to file
rob 7ae2024c83 Add Docker support 
- Dockerfile with Python 3.12, git, and optional Qt6 for GUI
- docker-compose.yml with services: cli, build, test-install, gui, shell

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 		2025-12-28 14:46:06 -04:00
assets Simplify to core git hooks and cascading rules 2025-12-28 14:21:34 -04:00
docs docs: Add CLAUDE.md and restructure DESIGN.md for clarity 2025-10-30 12:31:33 -03:00
src/cascadingdev docs: Add CLAUDE.md and restructure DESIGN.md for clarity 2025-10-30 12:31:33 -03:00
tools 1st commit 2025-10-29 01:22:40 -03:00
.gitignore 1st commit 2025-10-27 20:17:35 -03:00
CLAUDE.md Simplify to core git hooks and cascading rules 2025-12-28 14:21:34 -04:00
Dockerfile Add Docker support 2025-12-28 14:46:06 -04:00
README.md Simplify to core git hooks and cascading rules 2025-12-28 14:21:34 -04:00
VERSION 1st commit 2025-10-27 16:24:50 -03:00
docker-compose.yml Add Docker support 2025-12-28 14:46:06 -04:00
pyproject.toml 1st commit 2025-10-27 16:24:50 -03:00

README.md

CascadingDev (CDev) - Simplified

CDev — short for Cascading Development — is a Git-native AI–human collaboration framework that uses git hooks and cascading rules to enhance your development workflow.

This is the simplified version focused on core functionality:

  • Git pre-commit hooks with safety checks
  • Cascading .ai-rules.yml system
  • Ramble GUI for capturing structured feature requests

For advanced discussion orchestration features, see Orchestrated Discussions.

Key Features

  • Cascading Rules System — nearest .ai-rules.yml defines behavior at each directory level
  • Pre-commit Hook — secret scanning, discussion summary creation, git corruption prevention
  • Ramble GUI — PySide6/PyQt5 dialog for capturing structured feature requests
  • Deterministic Builds — reproducible installer bundle

Quick Start

# 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. Install into a project folder
python install/cascadingdev-*/setup_cascadingdev.py --target /path/to/myproject

Project Structure

CascadingDev/
├── assets/
│   ├── hooks/pre-commit     # Git pre-commit hook
│   ├── runtime/             # Runtime scripts (ramble.py, create_feature.py)
│   └── templates/           # Discussion and rule templates
├── src/cascadingdev/        # Python package
│   ├── setup_project.py     # Project initialization
│   ├── cli.py               # Command-line interface
│   └── ...
├── tools/                   # Build and test tools
└── docs/                    # Documentation

Pre-commit Hook Features

The pre-commit hook provides:

  1. Secret Scanning - Prevents accidental commit of API keys and secrets
  2. Summary Files - Auto-creates .sum.md companion files for discussions
  3. Concurrency Safety - Uses flock to prevent git corruption from parallel commits

Environment variables:

  • CDEV_SKIP_HOOK=1 - Skip all hook checks
  • CDEV_SKIP_SUMMARIES=1 - Skip summary file generation

Related Projects

This project is part of a three-layer stack:

  1. SmartTools - AI provider abstraction and tool execution
  2. Orchestrated Discussions - Multi-agent discussion orchestration
  3. Ramble - AI-powered structured field extraction GUI

License

MIT