# atkeya/learn_qa_agentic_workspace architecture

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

- Interactive diagram: https://gitdiagram.com/atkeya/learn_qa_agentic_workspace
- Repository: https://github.com/atkeya/learn_qa_agentic_workspace

## Overview

This is a mixed repository of fintech workflow scripts, QA utilities, a webhook receiver, and a Slack IT-support agent; the README provides no product-level overview. The clearest runtime workflow is Slack messages or mentions routed through listeners to Casey, which can consult helpdesk tools and return a threaded response. The graph also preserves the visible fintech and QA capability areas, but their internal relationships are omitted where the sampled evidence does not show calls or data flow.

Main entry points: [`qa-helper-slackbot/agent/tools/index.js`](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/tools/index.js) (Agent tool registry), [`qa-helper-slackbot/listeners/events/message.js`](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/listeners/events/message.js) (Message and mention handlers), [`qa-helper-slackbot/agent/casey.js`](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/casey.js) (Casey agent), [`qa-helper-slackbot/listeners/events/app-mentioned.js`](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/listeners/events/app-mentioned.js) (Mention handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_slack["Slack Support Agent"]
  node_slack_app["Slack app runtime<br/>[app.js]"]
  node_oauth_app["OAuth app runtime<br/>[app-oauth.js]"]
  node_listener_registry["Listener registration<br/>[index.js]"]
  node_event_listeners["Message and mention handlers<br/>[message.js]"]
  node_mention_handler["Mention handler<br/>[app-mentioned.js]"]
  node_casey_agent["Casey agent<br/>[casey.js]"]
  node_tool_registry["Agent tool registry<br/>[index.js]"]
  node_knowledge_base["Knowledge base search<br/>[knowledge-base.js]"]
  node_system_status["System status checks<br/>[system-status.js]"]
  node_support_ticket["Support ticket creation<br/>[ticket.js]"]
  node_user_permissions["User permissions lookup"]
  node_session_store[("Thread session store<br/>[store.js]")]
  node_feedback_view["Feedback response blocks"]
  node_home_view["App Home view"]
end

subgraph group_fintech["Fintech Workflows"]
  node_beneficiary_workflows["Beneficiary workflows<br/>[bene_biz.py]"]
  node_beneficiary_validation["Beneficiary validation<br/>[bene_validation.py]"]
  node_business_onboarding["Business onboarding<br/>[onb_biz2.py]"]
  node_individual_onboarding["Individual onboarding<br/>[onb_indiv.py]"]
  node_onboarding_library["Onboarding helpers<br/>[onb_lib.py]"]
  node_business_runner["Business workflow runner<br/>[run_biz.py]"]
  node_business_matrix["Business workflow matrix<br/>[biz_matrix.py]"]
  node_transactions["Transaction API workflows<br/>[tx_api.py]"]
  node_transaction_matrix["Transaction scenarios<br/>[tx_matrix.py]"]
  node_virtual_accounts["Virtual account workflows<br/>[va_matrix.py]"]
  node_onramp["Onramp simulation<br/>[onramp_sim.py]"]
  node_offramp["Offramp polling<br/>[offramp_poll.py]"]
  node_wallet["Wallet send workflow<br/>[send.py]"]
end

subgraph group_qa["QA Utilities"]
  node_qa_capture["Browser session tagging<br/>[session_tagger.py]"]
  node_har_converter["HAR to Postman conversion<br/>[har2postman.py]"]
  node_payload_generator["Customer payload generation"]
end

subgraph group_webhooks["Webhook Receiver"]
  node_linear_webhook["Linear webhook receiver<br/>[receiver.py]"]
end

node_slack_user(("Slack user"))
node_slack_mcp{{"Slack MCP service"}}

node_slack_app -->|"registers listeners"| node_listener_registry
node_oauth_app -->|"registers listeners"| node_listener_registry
node_listener_registry -->|"registers events"| node_event_listeners
node_slack_user -->|"sends messages"| node_event_listeners
node_event_listeners -->|"runs agent"| node_casey_agent
node_event_listeners -->|"reads and stores sessions"| node_session_store
node_event_listeners -->|"builds feedback blocks"| node_feedback_view
node_mention_handler -->|"runs agent"| node_casey_agent
node_mention_handler -->|"reads and stores sessions"| node_session_store
node_mention_handler -->|"builds feedback blocks"| node_feedback_view
node_casey_agent -->|"imports tools"| node_tool_registry
node_tool_registry -->|"exports tool"| node_knowledge_base
node_tool_registry -->|"exports tool"| node_system_status
node_tool_registry -->|"exports tool"| node_support_ticket
node_tool_registry -->|"exports tool"| node_user_permissions
node_casey_agent -.->|"connects when available"| node_slack_mcp

click node_slack_app "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/app.js"
click node_oauth_app "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/app-oauth.js"
click node_listener_registry "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/listeners/index.js"
click node_event_listeners "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/listeners/events/message.js"
click node_mention_handler "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/listeners/events/app-mentioned.js"
click node_casey_agent "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/casey.js"
click node_tool_registry "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/tools/index.js"
click node_knowledge_base "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/tools/knowledge-base.js"
click node_system_status "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/tools/system-status.js"
click node_support_ticket "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/tools/ticket.js"
click node_user_permissions "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/tools/user-permissions.js"
click node_session_store "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/thread-context/store.js"
click node_feedback_view "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/listeners/views/feedback-builder.js"
click node_home_view "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/listeners/views/app-home-builder.js"
click node_beneficiary_workflows "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/bene_biz.py"
click node_beneficiary_validation "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/bene_validation.py"
click node_business_onboarding "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/onb_biz2.py"
click node_individual_onboarding "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/onb_indiv.py"
click node_onboarding_library "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/onb_lib.py"
click node_business_runner "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/run_biz.py"
click node_business_matrix "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/biz_matrix.py"
click node_transactions "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/tx_api.py"
click node_transaction_matrix "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/tx_matrix.py"
click node_virtual_accounts "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/va_matrix.py"
click node_onramp "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/onramp_sim.py"
click node_offramp "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/offramp_poll.py"
click node_wallet "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-wallet/send.py"
click node_qa_capture "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-capture/addons/session_tagger.py"
click node_har_converter "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-capture/bin/har2postman.py"
click node_payload_generator "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/stage-test-payloads/customer-creation/generate_customer_payloads.py"
click node_linear_webhook "https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/linear-webhook-receiver/receiver.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_slack_app,node_oauth_app,node_listener_registry,node_event_listeners,node_mention_handler,node_casey_agent,node_tool_registry,node_knowledge_base,node_system_status,node_support_ticket,node_user_permissions,node_session_store,node_feedback_view,node_home_view,node_slack_user toneBlue
class node_beneficiary_workflows,node_beneficiary_validation,node_business_onboarding,node_individual_onboarding,node_onboarding_library,node_business_runner,node_business_matrix,node_transactions,node_transaction_matrix,node_virtual_accounts,node_onramp,node_offramp,node_wallet toneAmber
class node_qa_capture,node_har_converter,node_payload_generator toneMint
class node_linear_webhook toneRose
class node_slack_mcp toneIndigo
```

## Components

### Slack Support Agent

- [Slack app runtime](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/app.js): `qa-helper-slackbot/app.js`
- [OAuth app runtime](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/app-oauth.js): `qa-helper-slackbot/app-oauth.js`
- [Listener registration](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/listeners/index.js): `qa-helper-slackbot/listeners/index.js`
- [Message and mention handlers](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/listeners/events/message.js): `qa-helper-slackbot/listeners/events/message.js`
- [Mention handler](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/listeners/events/app-mentioned.js): `qa-helper-slackbot/listeners/events/app-mentioned.js`
- [Casey agent](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/casey.js): `qa-helper-slackbot/agent/casey.js`
- [Agent tool registry](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/tools/index.js): `qa-helper-slackbot/agent/tools/index.js`
- [Knowledge base search](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/tools/knowledge-base.js): `qa-helper-slackbot/agent/tools/knowledge-base.js`
- [System status checks](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/tools/system-status.js): `qa-helper-slackbot/agent/tools/system-status.js`
- [Support ticket creation](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/tools/ticket.js): `qa-helper-slackbot/agent/tools/ticket.js`
- [User permissions lookup](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/agent/tools/user-permissions.js): `qa-helper-slackbot/agent/tools/user-permissions.js`
- [Thread session store](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/thread-context/store.js): `qa-helper-slackbot/thread-context/store.js`
- [Feedback response blocks](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/listeners/views/feedback-builder.js): `qa-helper-slackbot/listeners/views/feedback-builder.js`
- [App Home view](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-helper-slackbot/listeners/views/app-home-builder.js): `qa-helper-slackbot/listeners/views/app-home-builder.js`

### Fintech Workflows

- [Beneficiary workflows](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/bene_biz.py): `bene_biz.py`
- [Beneficiary validation](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/bene_validation.py): `bene_validation.py`
- [Business onboarding](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/onb_biz2.py): `onb_biz2.py`
- [Individual onboarding](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/onb_indiv.py): `onb_indiv.py`
- [Onboarding helpers](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/onb_lib.py): `onb_lib.py`
- [Business workflow runner](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/run_biz.py): `run_biz.py`
- [Business workflow matrix](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/biz_matrix.py): `biz_matrix.py`
- [Transaction API workflows](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/tx_api.py): `tx_api.py`
- [Transaction scenarios](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/tx_matrix.py): `tx_matrix.py`
- [Virtual account workflows](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/va_matrix.py): `va_matrix.py`
- [Onramp simulation](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/onramp_sim.py): `onramp_sim.py`
- [Offramp polling](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/offramp_poll.py): `offramp_poll.py`
- [Wallet send workflow](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-wallet/send.py): `qa-wallet/send.py`

### QA Utilities

- [Browser session tagging](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-capture/addons/session_tagger.py): `qa-capture/addons/session_tagger.py`
- [HAR to Postman conversion](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/qa-capture/bin/har2postman.py): `qa-capture/bin/har2postman.py`
- [Customer payload generation](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/stage-test-payloads/customer-creation/generate_customer_payloads.py): `stage-test-payloads/customer-creation/generate_customer_payloads.py`

### Webhook Receiver

- [Linear webhook receiver](https://github.com/atkeya/learn_qa_agentic_workspace/blob/main/linear-webhook-receiver/receiver.py): `linear-webhook-receiver/receiver.py`

### Other components

- **Slack user**
- **Slack MCP service**

## Connections

- Slack app runtime → Listener registration: registers listeners (evidence: `qa-helper-slackbot/app.js`)
- OAuth app runtime → Listener registration: registers listeners (evidence: `qa-helper-slackbot/app-oauth.js`)
- Listener registration → Message and mention handlers: registers events (evidence: `qa-helper-slackbot/listeners/index.js`)
- Slack user → Message and mention handlers: sends messages (evidence: `qa-helper-slackbot/listeners/events/message.js`)
- Message and mention handlers → Casey agent: runs agent (evidence: `qa-helper-slackbot/listeners/events/message.js`)
- Message and mention handlers → Thread session store: reads and stores sessions (evidence: `qa-helper-slackbot/listeners/events/message.js`)
- Message and mention handlers → Feedback response blocks: builds feedback blocks (evidence: `qa-helper-slackbot/listeners/events/message.js`)
- Mention handler → Casey agent: runs agent (evidence: `qa-helper-slackbot/listeners/events/app-mentioned.js`)
- Mention handler → Thread session store: reads and stores sessions (evidence: `qa-helper-slackbot/listeners/events/app-mentioned.js`)
- Mention handler → Feedback response blocks: builds feedback blocks (evidence: `qa-helper-slackbot/listeners/events/app-mentioned.js`)
- Casey agent → Agent tool registry: imports tools (evidence: `qa-helper-slackbot/agent/casey.js`)
- Agent tool registry → Knowledge base search: exports tool (evidence: `qa-helper-slackbot/agent/tools/index.js`)
- Agent tool registry → System status checks: exports tool (evidence: `qa-helper-slackbot/agent/tools/index.js`)
- Agent tool registry → Support ticket creation: exports tool (evidence: `qa-helper-slackbot/agent/tools/index.js`)
- Agent tool registry → User permissions lookup: exports tool (evidence: `qa-helper-slackbot/agent/tools/index.js`)
- Casey agent → Slack MCP service: connects when available (evidence: `qa-helper-slackbot/agent/casey.js`)
