# chaudharyviv/agile_crew_netapp architecture

> Architecture diagram of the GitHub repository chaudharyviv/agile_crew_netapp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-05-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chaudharyviv/agile_crew_netapp
- Repository: https://github.com/chaudharyviv/agile_crew_netapp

## Overview

1. **Repository purpose**
   - This is a Streamlit-based AI planning app for NetApp storage initiatives.
   - It turns a user-entered initiative description into a structured set of planning artifacts for migration/modernization work.

2. **Primary runtime shape**
   - The app runs as a single Python/Streamlit frontend process.
   - There is no separate backend service; the UI directly invokes the orchestration layer in `src/file_storage_crew`.

3. **Top-level UI boundary**
   - `streamlit_app.py` is the entry point and owns the interactive user experience.
   - It collects initiative inputs, triggers planning, displays progress/results, and exposes export/publish actions.

4. **Orchestration boundary**
   - `src/file_storage_crew/crew.py` is the main workflow engine.
   - It coordinates the sequential multi-agent plan generation described in the README: business brief → backlog → sprint plan → technical design → architecture review → risk assessment → automation strategy → executive summary.

5. **Agent and task definition boundary**
   - `src/file_storage_crew/config.py` holds the agent/task configuration.
   - This is where the repository likely centralizes the seven agent personas, their roles, and the task prompts that shape each generated document.

6. **Integration boundary for Confluence**
   - `src/file_storage_crew/confluence.py` isolates Atlassian Confluence publishing.
   - This keeps external API interaction separate from the planning workflow, so generation can run independently of publishing.

7. **Data flow through the system**
   - User inputs enter through the Streamlit UI.
   - The UI passes the initiative context into the CrewAI workflow.
   - Each agent produces an intermediate artifact that becomes input to the next step.
   - The final outputs are collected as markdown documents and surfaced in the UI for download or publishing.

8. **Generated artifact model**
   - The system produces eight named markdown deliverables, each representing a distinct planning layer.
   - These artifacts form the primary output boundary of the application and are the main units for review, export, and Confluence page creation.

9. **Secrets and configuration boundary**
   - `.env.example`, Streamlit secrets, and `pydantic-settings`/dotenv usage indicate configuration is externalized.
   - `OPENAI_API_KEY` is mandatory; Confluence credentials are optional and only activate the publishing path.

10. **External services**
   - OpenAI is the core AI dependency behind CrewAI agent execution.
   - Atlassian Confluence is an optional downstream system used to publish the generated plan hierarchy.
   - Streamlit provides the web UI runtime rather than a traditional REST API.

11. **Packaging and local setup**
   - `requirements.txt` defines the Python dependency set.
   - `.devcontainer/` indicates the repo supports containerized development, which is useful for consistent local setup but does not change the application architecture.

12. **Deployment shape**
   - The repo is structured for local execution and Streamlit Cloud deployment.
   - `Deployment.md` and the Streamlit secrets model suggest the app is expected to run as a hosted single-page planning tool, not as a multi-service distributed system.

Main entry points: [`streamlit_app.py`](https://github.com/chaudharyviv/agile_crew_netapp/blob/master/streamlit_app.py) (Streamlit app), [`src/file_storage_crew/crew.py`](https://github.com/chaudharyviv/agile_crew_netapp/blob/master/src/file_storage_crew/crew.py) (Crew engine), [`src/file_storage_crew/confluence.py`](https://github.com/chaudharyviv/agile_crew_netapp/blob/master/src/file_storage_crew/confluence.py) (Confluence), [`.env.example`](https://github.com/chaudharyviv/agile_crew_netapp/blob/master/.env.example) (Secrets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["UI"]
  node_streamlit_app["Streamlit app<br/>entrypoint<br/>[streamlit_app.py]"]
  node_secrets_config["Secrets<br/>runtime config<br/>[.env.example]"]
end

subgraph group_engine["Planning Engine"]
  node_crew_engine{{"Crew engine<br/>workflow orchestrator<br/>[crew.py]"}}
  node_agent_config["Agent config<br/>agent/task definitions<br/>[config.py]"]
  node_input_context["Initiative input<br/>planning context"]
end

subgraph group_integrations["Integrations"]
  node_confluence_publisher[("Confluence<br/>publisher<br/>[confluence.py]")]
  node_openai_service(("OpenAI<br/>ai service"))
  node_streamlit_cloud["Streamlit Cloud<br/>deployment target<br/>[config.toml]"]
  node_devcontainer["Dev container<br/>local dev<br/>[devcontainer.json]"]
end

subgraph group_delivery["Deliverables"]
  node_business_brief["Business brief<br/>generated artifact"]
  node_backlog["Backlog<br/>generated artifact"]
  node_sprint_plan["Sprint plan<br/>generated artifact"]
  node_technical_design["Technical design<br/>generated artifact"]
  node_architecture_review["Architecture review<br/>generated artifact"]
  node_risk_assessment["Risk assessment<br/>generated artifact"]
  node_automation_strategy["Automation strategy<br/>generated artifact"]
  node_executive_summary["Exec summary<br/>generated artifact"]
  node_deliverable_bundle["Plan bundle<br/>output set"]
end

node_streamlit_app -->|"collects"| node_input_context
node_streamlit_app -->|"starts"| node_crew_engine
node_input_context -->|"feeds"| node_crew_engine
node_crew_engine -->|"uses"| node_agent_config
node_crew_engine -->|"calls"| node_openai_service
node_crew_engine -->|"produces"| node_business_brief
node_business_brief -->|"refines into"| node_backlog
node_backlog -->|"sequences into"| node_sprint_plan
node_sprint_plan -->|"informs"| node_technical_design
node_technical_design -->|"reviewed by"| node_architecture_review
node_architecture_review -->|"surfaces"| node_risk_assessment
node_risk_assessment -->|"guides"| node_automation_strategy
node_automation_strategy -->|"summarized in"| node_executive_summary
node_executive_summary -->|"bundles"| node_deliverable_bundle
node_business_brief -->|"included in"| node_deliverable_bundle
node_backlog -->|"included in"| node_deliverable_bundle
node_sprint_plan -->|"included in"| node_deliverable_bundle
node_technical_design -->|"included in"| node_deliverable_bundle
node_architecture_review -->|"included in"| node_deliverable_bundle
node_risk_assessment -->|"included in"| node_deliverable_bundle
node_automation_strategy -->|"included in"| node_deliverable_bundle
node_executive_summary -->|"included in"| node_deliverable_bundle
node_streamlit_app -->|"displays"| node_deliverable_bundle
node_streamlit_app -->|"publishes via"| node_confluence_publisher
node_confluence_publisher -->|"uploads"| node_deliverable_bundle
node_secrets_config -->|"configures"| node_openai_service
node_secrets_config -.->|"enables"| node_confluence_publisher
node_devcontainer -.->|"supports"| node_streamlit_app
node_streamlit_cloud -.->|"hosts"| node_streamlit_app

click node_streamlit_app "https://github.com/chaudharyviv/agile_crew_netapp/blob/master/streamlit_app.py"
click node_secrets_config "https://github.com/chaudharyviv/agile_crew_netapp/blob/master/.env.example"
click node_crew_engine "https://github.com/chaudharyviv/agile_crew_netapp/blob/master/src/file_storage_crew/crew.py"
click node_agent_config "https://github.com/chaudharyviv/agile_crew_netapp/blob/master/src/file_storage_crew/config.py"
click node_confluence_publisher "https://github.com/chaudharyviv/agile_crew_netapp/blob/master/src/file_storage_crew/confluence.py"
click node_streamlit_cloud "https://github.com/chaudharyviv/agile_crew_netapp/blob/master/.streamlit/config.toml"
click node_devcontainer "https://github.com/chaudharyviv/agile_crew_netapp/blob/master/.devcontainer/devcontainer.json"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_streamlit_app,node_secrets_config toneBlue
class node_crew_engine,node_agent_config,node_input_context toneAmber
class node_confluence_publisher,node_openai_service,node_streamlit_cloud,node_devcontainer toneMint
class node_business_brief,node_backlog,node_sprint_plan,node_technical_design,node_architecture_review,node_risk_assessment,node_automation_strategy,node_executive_summary,node_deliverable_bundle toneRose
```

## Components

### UI

Interactive Streamlit entrypoint and user-facing workflow

- [Streamlit app](https://github.com/chaudharyviv/agile_crew_netapp/blob/master/streamlit_app.py): entrypoint · Collects initiative inputs, runs planning, and presents results · `streamlit_app.py`
- [Secrets](https://github.com/chaudharyviv/agile_crew_netapp/blob/master/.env.example): runtime config · Environment and Streamlit secret settings for local and hosted execution · `.env.example`

### Planning Engine

CrewAI orchestration and agent/task definitions

- [Crew engine](https://github.com/chaudharyviv/agile_crew_netapp/blob/master/src/file_storage_crew/crew.py): workflow orchestrator · Coordinates the sequential multi-agent planning pipeline · `src/file_storage_crew/crew.py`
- [Agent config](https://github.com/chaudharyviv/agile_crew_netapp/blob/master/src/file_storage_crew/config.py): agent/task definitions · Holds personas, task prompts, and workflow configuration · `src/file_storage_crew/config.py`
- **Initiative input**: planning context · User-provided scope and constraints passed from the UI into the workflow

### Integrations

External services and publishing boundary

- [Confluence](https://github.com/chaudharyviv/agile_crew_netapp/blob/master/src/file_storage_crew/confluence.py): publisher · Optional publishing path for generated artifacts · `src/file_storage_crew/confluence.py`
- **OpenAI**: ai service · Model provider used by CrewAI agents to generate content
- [Streamlit Cloud](https://github.com/chaudharyviv/agile_crew_netapp/blob/master/.streamlit/config.toml): deployment target · Hosted runtime for the single-page planning app · `.streamlit/config.toml`
- [Dev container](https://github.com/chaudharyviv/agile_crew_netapp/blob/master/.devcontainer/devcontainer.json): local dev · Containerized local development environment · `.devcontainer/devcontainer.json`

### Deliverables

Generated planning artifacts and outputs

- **Business brief**: generated artifact · First planning layer establishing business intent and context
- **Backlog**: generated artifact · Structured work items derived from the initiative brief
- **Sprint plan**: generated artifact · Sequenced implementation plan for delivery execution
- **Technical design**: generated artifact · Solution design and implementation details
- **Architecture review**: generated artifact · Checks design fit, boundaries, and target architecture
- **Risk assessment**: generated artifact · Identifies delivery, migration, and operational risks
- **Automation strategy**: generated artifact · Defines automation approach for migration and modernization work
- **Exec summary**: generated artifact · Concise leadership-facing recap of the plan
- **Plan bundle**: output set · The complete markdown deliverables returned by the workflow

## Connections

- Streamlit app → Initiative input: collects · Captures initiative description and planning inputs
- Streamlit app → Crew engine: starts · Launches the planning workflow from the UI
- Initiative input → Crew engine: feeds · Provides scoped initiative context to orchestration
- Crew engine → Agent config: uses · Loads personas, prompts, and task definitions
- Crew engine → OpenAI: calls · Executes agent reasoning and content generation
- Crew engine → Business brief: produces · Generates the first planning artifact
- Business brief → Backlog: refines into · Converts brief into structured work items
- Backlog → Sprint plan: sequences into · Turns backlog into execution planning
- Sprint plan → Technical design: informs · Shapes the solution design and implementation detail
- Technical design → Architecture review: reviewed by · Validates the design against architecture expectations
- Architecture review → Risk assessment: surfaces · Feeds review findings into risk analysis
- Risk assessment → Automation strategy: guides · Influences automation approach and priorities
- Automation strategy → Exec summary: summarized in · Rolls the plan into an executive-facing summary
- Exec summary → Plan bundle: bundles · Completes the final set of markdown outputs
- Business brief → Plan bundle: included in · Adds generated document to the final output set
- Backlog → Plan bundle: included in · Adds generated document to the final output set
- Sprint plan → Plan bundle: included in · Adds generated document to the final output set
- Technical design → Plan bundle: included in · Adds generated document to the final output set
- Architecture review → Plan bundle: included in · Adds generated document to the final output set
- Risk assessment → Plan bundle: included in · Adds generated document to the final output set
- Automation strategy → Plan bundle: included in · Adds generated document to the final output set
- Exec summary → Plan bundle: included in · Adds generated document to the final output set
- Streamlit app → Plan bundle: displays · Shows results and supports download/export
- Streamlit app → Confluence: publishes via · Optionally sends the generated hierarchy to Confluence
- Confluence → Plan bundle: uploads · Creates pages from the final markdown artifacts
- Secrets → OpenAI: configures · Provides API keys and runtime settings
- Secrets → Confluence: enables · Supplies optional Confluence credentials
- Dev container → Streamlit app: supports · Provides a reproducible local development environment
- Streamlit Cloud → Streamlit app: hosts · Deployment target for the single-process app
