CascadingDev Overview

A Git-native AI-human collaboration framework that automates documentation, discussion summaries, and code review directly within repositories.

Project Links

Resource	URL
Git Repository	https://gitea.brrd.tech/rob/CascadingDev
Local Path	~/PycharmProjects/CascadingDev

Core Concept

CascadingDev uses Git pre-commit hooks to trigger multi-agent AI orchestration. When you commit, AI agents automatically:

• Generate documentation
• Summarize discussions
• Review code changes
• Update status based on voting consensus

Components

┌─────────────────────────────────────────────────────────────────┐
│                       CascadingDev                              │
├───────────────┬───────────────┬───────────────┬─────────────────┤
│  Pre-commit   │   AI Agents   │   Ramble GUI  │   Rules Engine  │
│  Hooks        │   (7 types)   │   (PySide6)   │   (.ai-rules)   │
├───────────────┼───────────────┼───────────────┼─────────────────┤
│ Trigger on    │ Moderator     │ Structured    │ Cascading YAML  │
│ git commit    │ Architect     │ feature       │ inheritance     │
│ Safety checks │ Security      │ requests      │ Per-folder      │
│ Auto-docs     │ Pragmatist    │               │ overrides       │
│               │ Perfectionist │               │                 │
│               │ Researcher    │               │                 │
│               │ Visualizer    │               │                 │
└───────────────┴───────────────┴───────────────┴─────────────────┘

AI Agent Team

Agent	Role	Perspective
Moderator	Facilitates discussion, ensures progress	Neutral, process-focused
Designer	UX/UI considerations	User experience
Architect	System design decisions	Big picture, scalability
Security	Identifies vulnerabilities	Risk assessment
Pragmatist	Practical implementation	What works now
Perfectionist	Code quality standards	Best practices
Researcher	Background information	Documentation, prior art
Visualizer	Diagrams and visual aids	PlantUML, Mermaid

Key Features

• Cascading Rules: .ai-rules.yml files inherit and override from parent directories
• Multi-Provider AI: Fallback chains across Claude, Codex, Gemini
• Status Promotion: Automatic status changes based on voting consensus
• Stage Workflow: feature → design → implementation → testing → review
• Discussion Summaries: Auto-generated from structured discussion files
• Secret Scanning: Pre-commit validation for sensitive data

Dependencies

CascadingDev is the top-level orchestration layer that depends on:

• CmdForge: Tool execution engine
• Orchestrated Discussions: Discussion file format and parsing
• Artifact Editor: Diagram generation
• Ramble: Feature request GUI

Quick Start

# Install
cd ~/PycharmProjects/CascadingDev
pip install -e .

# Initialize in a repo
cd /path/to/your/repo
cascading init

# This creates:
# - .ai-rules.yml (config)
# - .git/hooks/pre-commit (hook)