@startuml architecture-overview
!theme plain
title CascadingDev Architecture Overview

package "User Project" {
  folder "Docs/features/" {
    file "request.md" as request
    folder "discussions/" {
      file "feature.discussion.md" as discussion
      file "feature.discussion.sum.md" as summary
    }
  }

  folder ".git/hooks/" {
    file "pre-commit" as hook
  }

  folder "automation/" {
    file "runner.py" as runner
    file "config.py" as config
    file "patcher.py" as patcher
    file "workflow.py" as workflow
    file "agents.py" as agents
    file "summary.py" as summarymod
  }

  folder "Docs/features/.ai-rules.yml" as rules
}

cloud "AI Provider" {
  component "Claude API" as claude
  component "Claude CLI" as cli
}

actor Developer

Developer --> request: 1. Creates/edits
Developer --> hook: 2. git commit
hook --> runner: 3. Invokes
runner --> config: 4. Loads rules
config --> rules: 5. Reads
runner --> patcher: 6. Generate outputs
patcher --> claude: 7. AI request
claude --> patcher: 8. Returns patch
patcher --> discussion: 9. Applies patch
hook --> workflow: 10. Process votes
workflow --> agents: 11. Extract data
workflow --> summarymod: 12. Update summary
hook --> Developer: 13. Commit succeeds

note right of runner
  Orchestrates the AI
  automation pipeline
end note

note right of patcher
  Generates and applies
  AI-created patches
end note

note right of workflow
  Tracks votes and
  updates summaries
end note

@enduml