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
23 Commits 2 Branches 0 Tags 354 KiB
Python 92.6%
Shell 5.1%
Dockerfile 2.3%
Go to file
rob 536d885b6b docs: Add CLAUDE.md and restructure DESIGN.md for clarity 
Major documentation improvements:

1. Add CLAUDE.md
   - Comprehensive guide for AI assistants working in this repo
   - Repository architecture and directory structure
   - Common development commands and workflows
   - Build system explanation
   - Key concepts and design philosophy

2. Restructure DESIGN.md
   - Clarify three directory contexts: CascadingDev Repo, Install Bundle, User Project
   - Add clear section headers and visual separation
   - Mark future/unimplemented features with 🚧 emoji
   - Document undocumented wins: META system and Ramble providers
   - Add comprehensive Ramble documentation (mock and claude providers)
   - Document template META system with code examples

3. Fix setup_project.py
   - Correct error message path (was scripts/hooks/pre-commit, now assets/hooks/pre-commit)

These changes address confusion between tooling source, distribution bundle, and
generated user projects while highlighting sophisticated features like the
self-describing template system and multi-provider Ramble GUI.

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

Co-Authored-By: Claude <noreply@anthropic.com>
 		2025-10-30 12:31:33 -03:00
assets 1st commit 2025-10-29 01:22:40 -03: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 docs: Add CLAUDE.md and restructure DESIGN.md for clarity 2025-10-30 12:31:33 -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 1st commit 2025-10-27 16:24:50 -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