# appitstudio/awesome-jev architecture

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

- Interactive diagram: https://gitdiagram.com/appitstudio/awesome-jev
- Repository: https://github.com/appitstudio/awesome-jev

## Overview

Awesome Jev is an independent directory and learning resource for Jev-powered apps, developer tools, and practical decision workflows—not a Jev SDK. A user can describe a workflow to the guide, find a relevant pattern or community project, then run an offline example or adapt a runnable reference project. The README also documents SDKs, computer/browser use, and evaluation resources; those branches are represented at their supported directory level. Sampled source confirms the guide’s example runner and the support-router flow; unsampled example internals are not expanded.

Main entry points: [`projects/support-router/run.py`](https://github.com/appitstudio/awesome-jev/blob/main/projects/support-router/run.py) (Support router runner), [`skills/awesome-jev-guide`](https://github.com/appitstudio/awesome-jev/tree/main/skills/awesome-jev-guide) (Jev Guide skill), [`skills/awesome-jev-guide/scripts/try_example.py`](https://github.com/appitstudio/awesome-jev/blob/main/skills/awesome-jev-guide/scripts/try_example.py) (Example runner), [`evaluations/run.py`](https://github.com/appitstudio/awesome-jev/blob/main/evaluations/run.py) (Routing evaluation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery"]
  node_guide["Jev Guide skill"]
  node_usecases["Use-case explorer"]
  node_apps["Jev apps catalog"]
  node_tools["Tools catalog"]
end

subgraph group_learning["Learning"]
  node_patterns["Decision patterns"]
  node_computeruse["Computer and browser use<br/>[computer-use.md]"]
  node_gettingstarted["Getting started<br/>[getting-started.md]"]
  node_sdk_tools["Official SDKs and tools<br/>[README.md]"]
end

subgraph group_runtime["Runnable examples"]
  node_example_runner["Example runner<br/>[try_example.py]"]
  node_recipes["Decision recipes"]
  node_client["Jev client"]
end

subgraph group_reference["Reference projects"]
  node_support_cli["Support router runner<br/>[run.py]"]
  node_router["Routing policy<br/>[support_router.py]"]
  node_evaluation["Routing evaluation<br/>[run.py]"]
end

node_user(("Developer"))
node_jev_api{{"TypeSafe Jev API"}}
node_ticket_input["Ticket input"]
node_route_output["Route and review queue"]
node_evaluation_data["Evaluation records"]

node_user -->|"describes workflow"| node_guide
node_guide -->|"finds examples"| node_usecases
node_guide -->|"surfaces projects"| node_apps
node_guide -->|"surfaces tools"| node_tools
node_user -->|"chooses pattern"| node_patterns
node_user -->|"explores capability"| node_computeruse
node_user -->|"runs workflow"| node_gettingstarted
node_gettingstarted -->|"documents use"| node_recipes
node_example_runner -->|"builds and decides"| node_recipes
node_example_runner -->|"validates answers"| node_client
node_example_runner -.->|"optionally requests"| node_jev_api
node_client -.->|"sends request"| node_jev_api
node_user -->|"provides tickets"| node_support_cli
node_ticket_input -->|"supplies JSONL"| node_support_cli
node_support_cli -->|"builds and decides"| node_router
node_support_cli -->|"evaluates request"| node_client
node_support_cli -.->|"optionally requests"| node_jev_api
node_support_cli -->|"writes decisions"| node_route_output
node_evaluation -->|"builds decisions"| node_router
node_evaluation -.->|"optionally evaluates"| node_jev_api
node_evaluation -->|"writes records"| node_evaluation_data
node_user -->|"consults resources"| node_sdk_tools

click node_guide "https://github.com/appitstudio/awesome-jev/tree/main/skills/awesome-jev-guide"
click node_usecases "https://github.com/appitstudio/awesome-jev/blob/main/docs/explore-use-cases.md"
click node_apps "https://github.com/appitstudio/awesome-jev/tree/main/community/projects/apps"
click node_tools "https://github.com/appitstudio/awesome-jev/tree/main/community/projects/tools"
click node_patterns "https://github.com/appitstudio/awesome-jev/blob/main/docs/decision-patterns.md"
click node_computeruse "https://github.com/appitstudio/awesome-jev/blob/main/docs/computer-use.md"
click node_gettingstarted "https://github.com/appitstudio/awesome-jev/blob/main/docs/getting-started.md"
click node_example_runner "https://github.com/appitstudio/awesome-jev/blob/main/skills/awesome-jev-guide/scripts/try_example.py"
click node_recipes "https://github.com/appitstudio/awesome-jev/tree/main/examples"
click node_client "https://github.com/appitstudio/awesome-jev/tree/main/examples"
click node_support_cli "https://github.com/appitstudio/awesome-jev/blob/main/projects/support-router/run.py"
click node_router "https://github.com/appitstudio/awesome-jev/blob/main/projects/support-router/support_router.py"
click node_evaluation "https://github.com/appitstudio/awesome-jev/blob/main/evaluations/run.py"
click node_sdk_tools "https://github.com/appitstudio/awesome-jev/blob/main/README.md"

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_guide,node_usecases,node_apps,node_tools toneBlue
class node_patterns,node_computeruse,node_gettingstarted,node_sdk_tools toneAmber
class node_example_runner,node_recipes,node_client,node_jev_api toneMint
class node_support_cli,node_router,node_evaluation,node_route_output toneRose
class node_user,node_ticket_input,node_evaluation_data toneIndigo
```

## Components

### Discovery

- [Jev Guide skill](https://github.com/appitstudio/awesome-jev/tree/main/skills/awesome-jev-guide): `skills/awesome-jev-guide`
- [Use-case explorer](https://github.com/appitstudio/awesome-jev/blob/main/docs/explore-use-cases.md): `docs/explore-use-cases.md`
- [Jev apps catalog](https://github.com/appitstudio/awesome-jev/tree/main/community/projects/apps): `community/projects/apps`
- [Tools catalog](https://github.com/appitstudio/awesome-jev/tree/main/community/projects/tools): `community/projects/tools`

### Learning

- [Decision patterns](https://github.com/appitstudio/awesome-jev/blob/main/docs/decision-patterns.md): `docs/decision-patterns.md`
- [Computer and browser use](https://github.com/appitstudio/awesome-jev/blob/main/docs/computer-use.md): `docs/computer-use.md`
- [Getting started](https://github.com/appitstudio/awesome-jev/blob/main/docs/getting-started.md): `docs/getting-started.md`
- [Official SDKs and tools](https://github.com/appitstudio/awesome-jev/blob/main/README.md): `README.md`

### Runnable examples

- [Example runner](https://github.com/appitstudio/awesome-jev/blob/main/skills/awesome-jev-guide/scripts/try_example.py): `skills/awesome-jev-guide/scripts/try_example.py`
- [Decision recipes](https://github.com/appitstudio/awesome-jev/tree/main/examples): `examples`
- [Jev client](https://github.com/appitstudio/awesome-jev/tree/main/examples): `examples`

### Reference projects

- [Support router runner](https://github.com/appitstudio/awesome-jev/blob/main/projects/support-router/run.py): `projects/support-router/run.py`
- [Routing policy](https://github.com/appitstudio/awesome-jev/blob/main/projects/support-router/support_router.py): `projects/support-router/support_router.py`
- [Routing evaluation](https://github.com/appitstudio/awesome-jev/blob/main/evaluations/run.py): `evaluations/run.py`

### Other components

- **Developer**
- **TypeSafe Jev API**
- **Ticket input**
- **Route and review queue**
- **Evaluation records**

## Connections

- Developer → Jev Guide skill: describes workflow
- Jev Guide skill → Use-case explorer: finds examples
- Jev Guide skill → Jev apps catalog: surfaces projects
- Jev Guide skill → Tools catalog: surfaces tools
- Developer → Decision patterns: chooses pattern
- Developer → Computer and browser use: explores capability
- Developer → Getting started: runs workflow
- Getting started → Decision recipes: documents use
- Example runner → Decision recipes: builds and decides
- Example runner → Jev client: validates answers
- Example runner → TypeSafe Jev API: optionally requests
- Jev client → TypeSafe Jev API: sends request
- Developer → Support router runner: provides tickets
- Ticket input → Support router runner: supplies JSONL
- Support router runner → Routing policy: builds and decides
- Support router runner → Jev client: evaluates request
- Support router runner → TypeSafe Jev API: optionally requests
- Support router runner → Route and review queue: writes decisions
- Routing evaluation → Routing policy: builds decisions
- Routing evaluation → TypeSafe Jev API: optionally evaluates
- Routing evaluation → Evaluation records: writes records
- Developer → Official SDKs and tools: consults resources