# anshsharma100/lil-task-x architecture

> Architecture diagram of the GitHub repository anshsharma100/lil-task-x, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anshsharma100/lil-task-x
- Repository: https://github.com/anshsharma100/lil-task-x

## Overview

Lil-Task-X combines a product-management web app with a LangChain analysis pipeline. Users sign in, create and review products, and can submit product and staffing information for analysis. The backend runs product-strategy research and PRD generation, then feasibility and delivery planning, producing structured outputs and a budget PDF. The README documents competitor search, staffing and budget checks, delivery options, Jira-ready drafts, email drafts, and repository watchlists. Some links rely on README or source-index references; unsampled implementation details are not inferred.

Main entry points: [`src/pipeline/phase2_llm.py`](https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/phase2_llm.py) (Feasibility and Planning), [`frontend/src/App.tsx`](https://github.com/AnshSharma100/Lil-Task-X/blob/main/frontend/src/App.tsx) (Web App), [`frontend/src/pages/ProductDetails.tsx`](https://github.com/AnshSharma100/Lil-Task-X/blob/main/frontend/src/pages/ProductDetails.tsx) (Product Details), [`backend_api.py`](https://github.com/AnshSharma100/Lil-Task-X/blob/main/backend_api.py) (Analysis API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Product Workspace"]
  node_frontend["Web App<br/>[App.tsx]"]
  node_home["Product Workspace<br/>[Home.tsx]"]
  node_product["Product Details<br/>[ProductDetails.tsx]"]
  node_productdata["Product Data Helpers<br/>[ProductDetails.tsx]"]
  node_supabaseclient["Supabase Client<br/>[supabaseClient.ts]"]
end

subgraph group_api["Analysis API"]
  node_api["Analysis API<br/>[backend_api.py]"]
  node_orchestrator["Pipeline Orchestrator<br/>[main.py]"]
end

subgraph group_strategy["Product Strategy"]
  node_phase1["Strategy and PRD<br/>[phase1.py]"]
end

subgraph group_delivery["Delivery Planning"]
  node_phase2["Feasibility and Planning<br/>[phase2_llm.py]"]
  node_pdf["Budget PDF Renderer<br/>[pdf_generator.py]"]
end

subgraph group_support["Agent Tools"]
  node_config["Pipeline Configuration<br/>[config.py]"]
  node_inputs["Product and Team Inputs<br/>[data_loaders.py]"]
  node_agent["ReAct Agent Tools<br/>[pm_agent.py]"]
  node_search["Competitor Search<br/>[pm_agent.py]"]
end

node_user(("Product Manager"))
node_supabase[("Supabase")]
node_auth["Auth0"]
node_gemini["Gemini"]
node_searchsvc["SerpAPI or Exa"]

node_user -->|"uses"| node_frontend
node_frontend -->|"routes to"| node_home
node_frontend -->|"routes to"| node_product
node_frontend -->|"checks authentication"| node_auth
node_home -->|"reads and creates"| node_supabaseclient
node_product -->|"reads and updates"| node_supabaseclient
node_product -->|"loads messages"| node_productdata
node_productdata -->|"uses"| node_supabaseclient
node_supabaseclient -->|"connects to"| node_supabase
node_product -->|"posts analysis"| node_api
node_api -->|"uses configuration"| node_config
node_api -->|"invokes"| node_phase1
node_api -->|"invokes"| node_phase2
node_user -->|"runs pipeline"| node_orchestrator
node_orchestrator -->|"loads configuration"| node_config
node_orchestrator -->|"runs strategy"| node_phase1
node_orchestrator -->|"passes PRD"| node_phase2
node_phase1 -->|"loads product brief"| node_inputs
node_phase2 -->|"loads staffing and budget"| node_inputs
node_phase1 -->|"invokes agent"| node_agent
node_phase2 -->|"invokes agent"| node_agent
node_agent -->|"calls model"| node_gemini
node_agent -->|"registers tool"| node_search
node_search -.->|"searches competitors"| node_searchsvc
node_phase2 -->|"generates report"| node_pdf
node_pdf -->|"requests summary"| node_gemini

click node_frontend "https://github.com/AnshSharma100/Lil-Task-X/blob/main/frontend/src/App.tsx"
click node_home "https://github.com/AnshSharma100/Lil-Task-X/blob/main/frontend/src/pages/Home.tsx"
click node_product "https://github.com/AnshSharma100/Lil-Task-X/blob/main/frontend/src/pages/ProductDetails.tsx"
click node_productdata "https://github.com/AnshSharma100/Lil-Task-X/blob/main/frontend/src/lib/ProductDetails.tsx"
click node_supabaseclient "https://github.com/AnshSharma100/Lil-Task-X/blob/main/frontend/src/lib/supabaseClient.ts"
click node_api "https://github.com/AnshSharma100/Lil-Task-X/blob/main/backend_api.py"
click node_config "https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/config.py"
click node_orchestrator "https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/main.py"
click node_inputs "https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/data_loaders.py"
click node_phase1 "https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/phase1.py"
click node_agent "https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/agents/pm_agent.py"
click node_search "https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/agents/pm_agent.py"
click node_phase2 "https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/phase2_llm.py"
click node_pdf "https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/pdf_generator.py"

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_frontend,node_home,node_product,node_productdata,node_supabaseclient toneBlue
class node_api,node_orchestrator,node_supabase toneAmber
class node_phase1,node_searchsvc toneMint
class node_phase2,node_pdf toneRose
class node_config,node_inputs,node_agent,node_search,node_user,node_auth,node_gemini toneIndigo
```

## Components

### Product Workspace

- [Web App](https://github.com/AnshSharma100/Lil-Task-X/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Product Workspace](https://github.com/AnshSharma100/Lil-Task-X/blob/main/frontend/src/pages/Home.tsx): `frontend/src/pages/Home.tsx`
- [Product Details](https://github.com/AnshSharma100/Lil-Task-X/blob/main/frontend/src/pages/ProductDetails.tsx): `frontend/src/pages/ProductDetails.tsx`
- [Product Data Helpers](https://github.com/AnshSharma100/Lil-Task-X/blob/main/frontend/src/lib/ProductDetails.tsx): `frontend/src/lib/ProductDetails.tsx`
- [Supabase Client](https://github.com/AnshSharma100/Lil-Task-X/blob/main/frontend/src/lib/supabaseClient.ts): `frontend/src/lib/supabaseClient.ts`

### Analysis API

- [Analysis API](https://github.com/AnshSharma100/Lil-Task-X/blob/main/backend_api.py): `backend_api.py`
- [Pipeline Orchestrator](https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/main.py): `src/pipeline/main.py`

### Product Strategy

- [Strategy and PRD](https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/phase1.py): `src/pipeline/phase1.py`

### Delivery Planning

- [Feasibility and Planning](https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/phase2_llm.py): `src/pipeline/phase2_llm.py`
- [Budget PDF Renderer](https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/pdf_generator.py): `src/pipeline/pdf_generator.py`

### Agent Tools

- [Pipeline Configuration](https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/config.py): `src/pipeline/config.py`
- [Product and Team Inputs](https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/pipeline/data_loaders.py): `src/pipeline/data_loaders.py`
- [ReAct Agent Tools](https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/agents/pm_agent.py): `src/agents/pm_agent.py`
- [Competitor Search](https://github.com/AnshSharma100/Lil-Task-X/blob/main/src/agents/pm_agent.py): `src/agents/pm_agent.py`

### Other components

- **Product Manager**
- **Supabase**
- **Auth0**
- **Gemini**
- **SerpAPI or Exa**

## Connections

- Product Manager → Web App: uses (evidence: `frontend/src/App.tsx`)
- Web App → Product Workspace: routes to (evidence: `frontend/src/App.tsx`)
- Web App → Product Details: routes to (evidence: `frontend/src/App.tsx`)
- Web App → Auth0: checks authentication (evidence: `frontend/src/App.tsx`)
- Product Workspace → Supabase Client: reads and creates (evidence: `frontend/src/pages/Home.tsx`)
- Product Details → Supabase Client: reads and updates (evidence: `frontend/src/pages/ProductDetails.tsx`)
- Product Details → Product Data Helpers: loads messages (evidence: `frontend/src/pages/ProductDetails.tsx`)
- Product Data Helpers → Supabase Client: uses (evidence: `frontend/src/lib/ProductDetails.tsx`)
- Supabase Client → Supabase: connects to (evidence: `frontend/src/lib/supabaseClient.ts`)
- Product Details → Analysis API: posts analysis (evidence: `frontend/src/pages/ProductDetails.tsx`)
- Analysis API → Pipeline Configuration: uses configuration (evidence: `backend_api.py`)
- Analysis API → Strategy and PRD: invokes (evidence: `backend_api.py`)
- Analysis API → Feasibility and Planning: invokes (evidence: `backend_api.py`)
- Product Manager → Pipeline Orchestrator: runs pipeline (evidence: `README.md`)
- Pipeline Orchestrator → Pipeline Configuration: loads configuration (evidence: `src/pipeline/main.py`)
- Pipeline Orchestrator → Strategy and PRD: runs strategy (evidence: `src/pipeline/main.py`)
- Pipeline Orchestrator → Feasibility and Planning: passes PRD (evidence: `src/pipeline/main.py`)
- Strategy and PRD → Product and Team Inputs: loads product brief (evidence: `src/pipeline/phase1.py`)
- Feasibility and Planning → Product and Team Inputs: loads staffing and budget (evidence: `src/pipeline/phase2_llm.py`)
- Strategy and PRD → ReAct Agent Tools: invokes agent (evidence: `src/pipeline/phase1.py`)
- Feasibility and Planning → ReAct Agent Tools: invokes agent (evidence: `src/pipeline/phase2_llm.py`)
- ReAct Agent Tools → Gemini: calls model (evidence: `README.md`)
- ReAct Agent Tools → Competitor Search: registers tool (evidence: `README.md`)
- Competitor Search → SerpAPI or Exa: searches competitors (evidence: `README.md`)
- Feasibility and Planning → Budget PDF Renderer: generates report (evidence: `src/pipeline/phase2_llm.py`)
- Budget PDF Renderer → Gemini: requests summary (evidence: `src/pipeline/pdf_generator.py`)
