graph LR
    A[GitHub Event<br/>'Issue opened'] --> B[Strands Agent]
    B --> C[Context Injection<br/>GraphQL]
    C --> D[Knowledge Base<br/>RAG Retrieval]
    D --> E[Agent Reasoning<br/>Claude]
    E --> F[Tool Execution<br/>GitHub/Projects]
    F --> G[Knowledge Storage<br/>Learning]
    G --> H[Self-Evolution<br/>Prompt Updates]

    classDef input fill:#2ea44f,stroke:#1b7735,color:#fff
    classDef agent fill:#0969da,stroke:#044289,color:#fff
    classDef knowledge fill:#8250df,stroke:#5a32a3,color:#fff
    classDef action fill:#bf8700,stroke:#875e00,color:#fff

    class A input
    class B,E agent
    class C,D,G knowledge
    class F,H action

flowchart TB
    subgraph Triggers["⚡ Event Triggers"]
        GH[GitHub Events]
        SC[Schedule: */4 hours]
        CL[Control Loop: Hourly]
        WD[Workflow Dispatch]
    end

    subgraph Agent["🤖 Strands Agent"]
        direction TB
        AR[Agent Runner]
        CTX[Context Builder]
        SP[System Prompt]
    end

    subgraph Tools["🔧 Tool Registry"]
        direction TB
        UG[use_github]
        PR[projects]
        SCH[scheduler]
        SUB[create_subagent]
        KB[store_in_kb]
        SYS[system_prompt]
    end

    subgraph External["☁️ External Services"]
        direction TB
        GQL[GitHub GraphQL]
        BKB[Bedrock KB]
        LF[Langfuse]
        S3[S3 Sessions]
    end

    GH --> AR
    SC --> AR
    CL --> WD
    WD --> AR
    AR --> CTX
    CTX --> SP
    AR --> Tools
    UG --> GQL
    PR --> GQL
    KB --> BKB
    AR --> LF
    AR --> S3

    classDef triggerStyle fill:#2ea44f,stroke:#1b7735,color:#fff
    classDef agentStyle fill:#0969da,stroke:#044289,color:#fff
    classDef toolStyle fill:#8250df,stroke:#5a32a3,color:#fff
    classDef externalStyle fill:#bf8700,stroke:#875e00,color:#fff

    class GH,SC,CL,WD triggerStyle
    class AR,CTX,SP agentStyle
    class UG,PR,SCH,SUB,KB,SYS toolStyle
    class GQL,BKB,LF,S3 externalStyle

sequenceDiagram
    participant User
    participant GitHub as GitHub Event
    participant Agent as Strands Agent
    participant KB as Knowledge Base
    participant Tools as Tool Registry

    User->>GitHub: Opens Issue #42
    GitHub->>Agent: Trigger workflow
    
    Agent->>Agent: fetch_github_event_context()
    Note over Agent: GraphQL: Full thread + comments
    
    Agent->>KB: retrieve(issue_content)
    KB-->>Agent: Similar issues & solutions
    
    Agent->>Agent: Reasoning with context
    
    Agent->>Tools: use_github(add_comment)
    Agent->>Tools: projects(update_status)
    
    Agent->>KB: store_in_kb(conversation)
    Note over KB: Learning for future
    
    Agent-->>GitHub: Comment posted
    GitHub-->>User: Notification

flowchart LR
    subgraph Event["📥 GitHub Event"]
        E1[Issue Created]
        E2[Comment Added]
        E3[PR Reviewed]
    end

    subgraph Context["📋 Context Builder"]
        direction TB
        C1[Raw GITHUB_CONTEXT]
        C2[GraphQL Enrichment]
        C3[Comments Thread]
        C4[Linked Items]
        C5[Project Status]
    end

    subgraph Prompt["🧠 System Prompt"]
        P1[Base Instructions]
        P2[Event Context]
        P3[Project Context]
        P4[Self-Awareness]
    end

    Event --> Context
    Context --> Prompt
    Prompt --> Agent[Agent]

    classDef eventStyle fill:#2ea44f,stroke:#1b7735,color:#fff
    classDef contextStyle fill:#8250df,stroke:#5a32a3,color:#fff
    classDef promptStyle fill:#0969da,stroke:#044289,color:#fff

    class E1,E2,E3 eventStyle
    class C1,C2,C3,C4,C5 contextStyle
    class P1,P2,P3,P4 promptStyle

flowchart TB
    subgraph agent["agent.yml (Main Agent)"]
        A1[GitHub Events] --> A2[Event Handler]
        A3[Schedule: */4 hours] --> A2
        A4[Workflow Dispatch] --> A2
        A2 --> A5[Agent Runner]
        A5 --> A6[Tool Execution]
    end

    subgraph control["control.yml (Scheduler)"]
        C1[Schedule: Hourly] --> C2[Parse AGENT_SCHEDULES]
        C2 --> C3{Jobs Due?}
        C3 -->|Yes| C4[Dispatch agent.yml]
        C3 -->|No| C5[Skip]
    end

    C4 --> A4

    classDef mainStyle fill:#0969da,stroke:#044289,color:#fff
    classDef controlStyle fill:#8250df,stroke:#5a32a3,color:#fff

    class A1,A2,A3,A4,A5,A6 mainStyle
    class C1,C2,C3,C4,C5 controlStyle

flowchart LR
    subgraph Agent["🤖 Agent Execution"]
        A1[Start] --> A2[Reasoning]
        A2 --> A3[Tool Calls]
        A3 --> A4[Complete]
    end

    subgraph Telemetry["📊 Telemetry"]
        T1[OTEL Exporter]
        T2[Trace Attributes]
        T3[Issue Linking]
    end

    subgraph Langfuse["🔭 Langfuse"]
        L1[Traces]
        L2[Generations]
        L3[Tool Calls]
        L4[Costs]
    end

    Agent --> Telemetry
    Telemetry --> Langfuse

    classDef agentStyle fill:#2ea44f,stroke:#1b7735,color:#fff
    classDef telStyle fill:#bf8700,stroke:#875e00,color:#fff
    classDef lfStyle fill:#4B32C3,stroke:#3a2799,color:#fff

    class A1,A2,A3,A4 agentStyle
    class T1,T2,T3 telStyle
    class L1,L2,L3,L4 lfStyle