# timothyvang/grill-me architecture

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

- Interactive diagram: https://gitdiagram.com/timothyvang/grill-me
- Repository: https://github.com/timothyvang/grill-me

## Overview

This repository is primarily a collection of independent, composable agent skills for engineering and everyday work—not a single application pipeline. Engineers choose a skill for a task such as clarifying requirements, implementing with TDD, diagnosing a bug, or improving architecture. A separate trading toolkit records market candles and paper-backtests a fixed strategy. Skill relationships are intentionally not chained: the README describes them as independently usable, and their prompt files were not sampled. The toolkit wiring shown is supported by the sampled server source.

Main entry points: [`trading-toolkit/server/recorder.ts`](https://github.com/timothyvang/grill-me/blob/main/trading-toolkit/server/recorder.ts) (Scheduled recorder), [`trading-toolkit/server/dashboard.ts`](https://github.com/timothyvang/grill-me/blob/main/trading-toolkit/server/dashboard.ts) (Paper-trading dashboard), [`trading-toolkit/server/engine.ts`](https://github.com/timothyvang/grill-me/blob/main/trading-toolkit/server/engine.ts) (Candle and backtest engine), [`skills/engineering/grill-with-docs`](https://github.com/timothyvang/grill-me/tree/main/skills/engineering/grill-with-docs) (Grill with docs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_engineering["Engineering skills"]
  node_grilldocs["Grill with docs"]
  node_prd["Create PRD"]
  node_issues["Break into issues"]
  node_tdd["TDD loop"]
  node_diagnose["Diagnose bugs"]
  node_architecture["Improve architecture"]
  node_zoomout["Zoom out"]
  node_triage["GitHub triage"]
end

subgraph group_productivity["Productivity skills"]
  node_grill["Grill me"]
  node_write["Write a skill"]
end

subgraph group_other["Other skills"]
  node_misc["Project utilities"]
  node_personal["Personal workflows"]
end

subgraph group_trading["Trading toolkit"]
  node_recorder["Scheduled recorder<br/>[recorder.ts]"]
  node_engine["Candle and backtest engine<br/>[engine.ts]"]
  node_dashboard["Paper-trading dashboard<br/>[dashboard.ts]"]
end

node_engineer(("Engineer"))
node_toolkituser(("Toolkit user"))
node_coinbase[("Coinbase candles")]
node_sqlite[("Val Town SQLite")]

node_engineer -->|"uses to clarify"| node_grilldocs
node_engineer -->|"uses to plan"| node_prd
node_engineer -->|"uses to break down"| node_issues
node_engineer -->|"uses to develop"| node_tdd
node_engineer -->|"uses to debug"| node_diagnose
node_engineer -->|"uses to redesign"| node_architecture
node_engineer -->|"uses to understand"| node_zoomout
node_engineer -->|"uses to triage"| node_triage
node_engineer -->|"uses to clarify"| node_grill
node_engineer -->|"uses to author"| node_write
node_engineer -->|"uses utilities"| node_misc
node_engineer -->|"uses workflows"| node_personal
node_toolkituser -->|"views"| node_dashboard
node_recorder -->|"calls backtest"| node_engine
node_recorder -->|"fetches candles"| node_coinbase
node_recorder -->|"writes candles and runs"| node_sqlite
node_dashboard -->|"reads candles and runs"| node_sqlite
node_dashboard -->|"reads strategy name"| node_engine

click node_grilldocs "https://github.com/timothyvang/grill-me/tree/main/skills/engineering/grill-with-docs"
click node_prd "https://github.com/timothyvang/grill-me/tree/main/skills/engineering/to-prd"
click node_issues "https://github.com/timothyvang/grill-me/tree/main/skills/engineering/to-issues"
click node_tdd "https://github.com/timothyvang/grill-me/tree/main/skills/engineering/tdd"
click node_diagnose "https://github.com/timothyvang/grill-me/tree/main/skills/engineering/diagnose"
click node_architecture "https://github.com/timothyvang/grill-me/tree/main/skills/engineering/improve-codebase-architecture"
click node_zoomout "https://github.com/timothyvang/grill-me/tree/main/skills/engineering/zoom-out"
click node_triage "https://github.com/timothyvang/grill-me/tree/main/skills/engineering/github-triage"
click node_grill "https://github.com/timothyvang/grill-me/tree/main/skills/productivity/grill-me"
click node_write "https://github.com/timothyvang/grill-me/tree/main/skills/productivity/write-a-skill"
click node_misc "https://github.com/timothyvang/grill-me/tree/main/skills/misc"
click node_personal "https://github.com/timothyvang/grill-me/tree/main/skills/personal"
click node_recorder "https://github.com/timothyvang/grill-me/blob/main/trading-toolkit/server/recorder.ts"
click node_engine "https://github.com/timothyvang/grill-me/blob/main/trading-toolkit/server/engine.ts"
click node_dashboard "https://github.com/timothyvang/grill-me/blob/main/trading-toolkit/server/dashboard.ts"

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_grilldocs,node_prd,node_issues,node_tdd,node_diagnose,node_architecture,node_zoomout,node_triage,node_toolkituser toneBlue
class node_grill,node_write,node_coinbase,node_sqlite toneAmber
class node_misc,node_personal toneMint
class node_recorder,node_engine,node_dashboard toneRose
class node_engineer toneIndigo
```

## Components

### Engineering skills

- [Grill with docs](https://github.com/timothyvang/grill-me/tree/main/skills/engineering/grill-with-docs): `skills/engineering/grill-with-docs`
- [Create PRD](https://github.com/timothyvang/grill-me/tree/main/skills/engineering/to-prd): `skills/engineering/to-prd`
- [Break into issues](https://github.com/timothyvang/grill-me/tree/main/skills/engineering/to-issues): `skills/engineering/to-issues`
- [TDD loop](https://github.com/timothyvang/grill-me/tree/main/skills/engineering/tdd): `skills/engineering/tdd`
- [Diagnose bugs](https://github.com/timothyvang/grill-me/tree/main/skills/engineering/diagnose): `skills/engineering/diagnose`
- [Improve architecture](https://github.com/timothyvang/grill-me/tree/main/skills/engineering/improve-codebase-architecture): `skills/engineering/improve-codebase-architecture`
- [Zoom out](https://github.com/timothyvang/grill-me/tree/main/skills/engineering/zoom-out): `skills/engineering/zoom-out`
- [GitHub triage](https://github.com/timothyvang/grill-me/tree/main/skills/engineering/github-triage): `skills/engineering/github-triage`

### Productivity skills

- [Grill me](https://github.com/timothyvang/grill-me/tree/main/skills/productivity/grill-me): `skills/productivity/grill-me`
- [Write a skill](https://github.com/timothyvang/grill-me/tree/main/skills/productivity/write-a-skill): `skills/productivity/write-a-skill`

### Other skills

- [Project utilities](https://github.com/timothyvang/grill-me/tree/main/skills/misc): `skills/misc`
- [Personal workflows](https://github.com/timothyvang/grill-me/tree/main/skills/personal): `skills/personal`

### Trading toolkit

- [Scheduled recorder](https://github.com/timothyvang/grill-me/blob/main/trading-toolkit/server/recorder.ts): `trading-toolkit/server/recorder.ts`
- [Candle and backtest engine](https://github.com/timothyvang/grill-me/blob/main/trading-toolkit/server/engine.ts): `trading-toolkit/server/engine.ts`
- [Paper-trading dashboard](https://github.com/timothyvang/grill-me/blob/main/trading-toolkit/server/dashboard.ts): `trading-toolkit/server/dashboard.ts`

### Other components

- **Engineer**
- **Toolkit user**
- **Coinbase candles**
- **Val Town SQLite**

## Connections

- Engineer → Grill with docs: uses to clarify
- Engineer → Create PRD: uses to plan
- Engineer → Break into issues: uses to break down
- Engineer → TDD loop: uses to develop
- Engineer → Diagnose bugs: uses to debug
- Engineer → Improve architecture: uses to redesign
- Engineer → Zoom out: uses to understand
- Engineer → GitHub triage: uses to triage
- Engineer → Grill me: uses to clarify
- Engineer → Write a skill: uses to author
- Engineer → Project utilities: uses utilities
- Engineer → Personal workflows: uses workflows
- Toolkit user → Paper-trading dashboard: views
- Scheduled recorder → Candle and backtest engine: calls backtest
- Scheduled recorder → Coinbase candles: fetches candles
- Scheduled recorder → Val Town SQLite: writes candles and runs
- Paper-trading dashboard → Val Town SQLite: reads candles and runs
- Paper-trading dashboard → Candle and backtest engine: reads strategy name