1 line
9.9 KiB
JavaScript
1 line
9.9 KiB
JavaScript
"use strict";(globalThis.webpackChunkproject_public_docs=globalThis.webpackChunkproject_public_docs||[]).push([[413],{6785(e,n,s){s.r(n),s.d(n,{assets:()=>o,contentTitle:()=>d,default:()=>h,frontMatter:()=>c,metadata:()=>i,toc:()=>a});const i=JSON.parse('{"id":"overview","title":"CascadingDev Overview","description":"A Git-native AI-human collaboration framework that automates documentation, discussion summaries, and code review directly within repositories.","source":"@site/docs/overview.md","sourceDirName":".","slug":"/","permalink":"/rob/CascadingDev/","draft":false,"unlisted":false,"tags":[],"version":"current","sidebarPosition":1,"frontMatter":{"slug":"/","sidebar_position":1},"sidebar":"docs","next":{"title":"CascadingDev Architecture","permalink":"/rob/CascadingDev/architecture"}}');var r=s(4848),t=s(8453);const c={slug:"/",sidebar_position:1},d="CascadingDev Overview",o={},a=[{value:"Project Links",id:"project-links",level:2},{value:"Core Concept",id:"core-concept",level:2},{value:"Components",id:"components",level:2},{value:"AI Agent Team",id:"ai-agent-team",level:2},{value:"Key Features",id:"key-features",level:2},{value:"Dependencies",id:"dependencies",level:2},{value:"Quick Start",id:"quick-start",level:2}];function l(e){const n={a:"a",code:"code",h1:"h1",h2:"h2",header:"header",li:"li",p:"p",pre:"pre",strong:"strong",table:"table",tbody:"tbody",td:"td",th:"th",thead:"thead",tr:"tr",ul:"ul",...(0,t.R)(),...e.components};return(0,r.jsxs)(r.Fragment,{children:[(0,r.jsx)(n.header,{children:(0,r.jsx)(n.h1,{id:"cascadingdev-overview",children:"CascadingDev Overview"})}),"\n",(0,r.jsx)(n.p,{children:"A Git-native AI-human collaboration framework that automates documentation, discussion summaries, and code review directly within repositories."}),"\n",(0,r.jsx)(n.h2,{id:"project-links",children:"Project Links"}),"\n",(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"Resource"}),(0,r.jsx)(n.th,{children:"URL"})]})}),(0,r.jsxs)(n.tbody,{children:[(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.strong,{children:"Git Repository"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.a,{href:"https://gitea.brrd.tech/rob/CascadingDev",children:"https://gitea.brrd.tech/rob/CascadingDev"})})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.strong,{children:"Local Path"})}),(0,r.jsx)(n.td,{children:(0,r.jsx)(n.code,{children:"~/PycharmProjects/CascadingDev"})})]})]})]}),"\n",(0,r.jsx)(n.h2,{id:"core-concept",children:"Core Concept"}),"\n",(0,r.jsx)(n.p,{children:"CascadingDev uses Git pre-commit hooks to trigger multi-agent AI orchestration. When you commit, AI agents automatically:"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsx)(n.li,{children:"Generate documentation"}),"\n",(0,r.jsx)(n.li,{children:"Summarize discussions"}),"\n",(0,r.jsx)(n.li,{children:"Review code changes"}),"\n",(0,r.jsx)(n.li,{children:"Update status based on voting consensus"}),"\n"]}),"\n",(0,r.jsx)(n.h2,{id:"components",children:"Components"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{children:"\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 CascadingDev \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 Pre-commit \u2502 AI Agents \u2502 Ramble GUI \u2502 Rules Engine \u2502\n\u2502 Hooks \u2502 (7 types) \u2502 (PySide6) \u2502 (.ai-rules) \u2502\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524\n\u2502 Trigger on \u2502 Moderator \u2502 Structured \u2502 Cascading YAML \u2502\n\u2502 git commit \u2502 Architect \u2502 feature \u2502 inheritance \u2502\n\u2502 Safety checks \u2502 Security \u2502 requests \u2502 Per-folder \u2502\n\u2502 Auto-docs \u2502 Pragmatist \u2502 \u2502 overrides \u2502\n\u2502 \u2502 Perfectionist \u2502 \u2502 \u2502\n\u2502 \u2502 Researcher \u2502 \u2502 \u2502\n\u2502 \u2502 Visualizer \u2502 \u2502 \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n"})}),"\n",(0,r.jsx)(n.h2,{id:"ai-agent-team",children:"AI Agent Team"}),"\n",(0,r.jsxs)(n.table,{children:[(0,r.jsx)(n.thead,{children:(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.th,{children:"Agent"}),(0,r.jsx)(n.th,{children:"Role"}),(0,r.jsx)(n.th,{children:"Perspective"})]})}),(0,r.jsxs)(n.tbody,{children:[(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.strong,{children:"Moderator"})}),(0,r.jsx)(n.td,{children:"Facilitates discussion, ensures progress"}),(0,r.jsx)(n.td,{children:"Neutral, process-focused"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.strong,{children:"Designer"})}),(0,r.jsx)(n.td,{children:"UX/UI considerations"}),(0,r.jsx)(n.td,{children:"User experience"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.strong,{children:"Architect"})}),(0,r.jsx)(n.td,{children:"System design decisions"}),(0,r.jsx)(n.td,{children:"Big picture, scalability"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.strong,{children:"Security"})}),(0,r.jsx)(n.td,{children:"Identifies vulnerabilities"}),(0,r.jsx)(n.td,{children:"Risk assessment"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.strong,{children:"Pragmatist"})}),(0,r.jsx)(n.td,{children:"Practical implementation"}),(0,r.jsx)(n.td,{children:"What works now"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.strong,{children:"Perfectionist"})}),(0,r.jsx)(n.td,{children:"Code quality standards"}),(0,r.jsx)(n.td,{children:"Best practices"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.strong,{children:"Researcher"})}),(0,r.jsx)(n.td,{children:"Background information"}),(0,r.jsx)(n.td,{children:"Documentation, prior art"})]}),(0,r.jsxs)(n.tr,{children:[(0,r.jsx)(n.td,{children:(0,r.jsx)(n.strong,{children:"Visualizer"})}),(0,r.jsx)(n.td,{children:"Diagrams and visual aids"}),(0,r.jsx)(n.td,{children:"PlantUML, Mermaid"})]})]})]}),"\n",(0,r.jsx)(n.h2,{id:"key-features",children:"Key Features"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Cascading Rules"}),": ",(0,r.jsx)(n.code,{children:".ai-rules.yml"})," files inherit and override from parent directories"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Multi-Provider AI"}),": Fallback chains across Claude, Codex, Gemini"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Status Promotion"}),": Automatic status changes based on voting consensus"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Stage Workflow"}),": feature \u2192 design \u2192 implementation \u2192 testing \u2192 review"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Discussion Summaries"}),": Auto-generated from structured discussion files"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Secret Scanning"}),": Pre-commit validation for sensitive data"]}),"\n"]}),"\n",(0,r.jsx)(n.h2,{id:"dependencies",children:"Dependencies"}),"\n",(0,r.jsx)(n.p,{children:"CascadingDev is the top-level orchestration layer that depends on:"}),"\n",(0,r.jsxs)(n.ul,{children:["\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"CmdForge"}),": Tool execution engine"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Orchestrated Discussions"}),": Discussion file format and parsing"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Artifact Editor"}),": Diagram generation"]}),"\n",(0,r.jsxs)(n.li,{children:[(0,r.jsx)(n.strong,{children:"Ramble"}),": Feature request GUI"]}),"\n"]}),"\n",(0,r.jsx)(n.h2,{id:"quick-start",children:"Quick Start"}),"\n",(0,r.jsx)(n.pre,{children:(0,r.jsx)(n.code,{className:"language-bash",children:"# Install\ncd ~/PycharmProjects/CascadingDev\npip install -e .\n\n# Initialize in a repo\ncd /path/to/your/repo\ncascading init\n\n# This creates:\n# - .ai-rules.yml (config)\n# - .git/hooks/pre-commit (hook)\n"})})]})}function h(e={}){const{wrapper:n}={...(0,t.R)(),...e.components};return n?(0,r.jsx)(n,{...e,children:(0,r.jsx)(l,{...e})}):l(e)}},8453(e,n,s){s.d(n,{R:()=>c,x:()=>d});var i=s(6540);const r={},t=i.createContext(r);function c(e){const n=i.useContext(t);return i.useMemo(function(){return"function"==typeof e?e(n):{...n,...e}},[n,e])}function d(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(r):e.components||r:c(e.components),i.createElement(t.Provider,{value:n},e.children)}}}]); |