# alramanathan/garrytan-gstack architecture

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

- Interactive diagram: https://gitdiagram.com/alramanathan/garrytan-gstack
- Repository: https://github.com/alramanathan/garrytan-gstack

## Overview

gstack is an AI-assisted software workflow toolkit: users invoke specialist skills to plan, implement, review, test, and ship work, with browser and document tools supporting those workflows. The repository also includes design-prototyping, persistent memory, optional code-intelligence providers, and integrations for multiple coding-agent hosts. The map combines README-documented capabilities with sampled runtime modules; several skill implementations and service connections are not present in the supplied excerpts, so those links are documented or left unverified rather than inferred.

Main entry points: [`browse/src/server.ts`](https://github.com/alramanathan/garrytan-gstack/blob/main/browse/src/server.ts) (Browse service), [`bin/gstack-memory-ingest.ts`](https://github.com/alramanathan/garrytan-gstack/blob/main/bin/gstack-memory-ingest.ts) (Memory ingest), [`scripts/resolvers`](https://github.com/alramanathan/garrytan-gstack/tree/main/scripts/resolvers) (Specialist skills), [`design/src/cli.ts`](https://github.com/alramanathan/garrytan-gstack/blob/main/design/src/cli.ts) (Design tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflows["Agent workflows"]
  node_skills["Specialist skills"]
  node_prompt_resolvers["Prompt resolvers<br/>[index.ts]"]
end

subgraph group_browser["Browser and QA"]
  node_browse_service["Browse service<br/>[server.ts]"]
  node_browser_manager["Browser manager<br/>[browser-manager.ts]"]
  node_cookie_picker["Cookie import"]
end

subgraph group_design_docs["Design and documents"]
  node_design_cli["Design tools<br/>[cli.ts]"]
  node_design_daemon["Design daemon client<br/>[daemon-client.ts]"]
  node_pdf_cli["PDF workflow<br/>[orchestrator.ts]"]
  node_pdf_render["PDF browser render<br/>[asideClient.ts]"]
  node_aside_renderer["Aside renderer<br/>[aside-render.ts]"]
end

subgraph group_memory["Memory and code context"]
  node_memory_ingest["Memory ingest"]
  node_memory_helpers["Memory helpers"]
  node_code_intel["Code intelligence"]
end

subgraph group_integrations["Host and trust integrations"]
  node_host_registry["Host registry<br/>[index.ts]"]
  node_host_configs["Host adapters"]
  node_repo_policy["Repository policy"]
  node_egress_ledger[("Egress ledger<br/>[egress-receipt.ts]")]
end

node_user(("Builder"))

node_user -->|"invokes"| node_skills
node_skills -.->|"resolves prompts"| node_prompt_resolvers
node_user -.->|"requests browser QA"| node_browse_service
node_browse_service -->|"dispatches browser work"| node_browser_manager
node_browse_service -->|"routes cookie import"| node_cookie_picker
node_user -.->|"uses design tools"| node_design_cli
node_design_cli -.->|"uses daemon client"| node_design_daemon
node_user -.->|"requests document output"| node_pdf_cli
node_pdf_cli -->|"renders PDF"| node_pdf_render
node_pdf_render -->|"calls renderer"| node_aside_renderer
node_user -.->|"ingests memory"| node_memory_ingest
node_memory_ingest -->|"uses memory helpers"| node_memory_helpers
node_user -.->|"uses code context"| node_code_intel
node_host_registry -->|"registers adapters"| node_host_configs
node_memory_ingest -->|"records egress"| node_egress_ledger
node_repo_policy -.->|"gates repository use"| node_host_configs

click node_skills "https://github.com/alramanathan/garrytan-gstack/tree/main/scripts/resolvers"
click node_prompt_resolvers "https://github.com/alramanathan/garrytan-gstack/blob/main/scripts/resolvers/index.ts"
click node_host_registry "https://github.com/alramanathan/garrytan-gstack/blob/main/hosts/index.ts"
click node_host_configs "https://github.com/alramanathan/garrytan-gstack/tree/main/hosts"
click node_browse_service "https://github.com/alramanathan/garrytan-gstack/blob/main/browse/src/server.ts"
click node_browser_manager "https://github.com/alramanathan/garrytan-gstack/blob/main/browse/src/browser-manager.ts"
click node_cookie_picker "https://github.com/alramanathan/garrytan-gstack/blob/main/browse/src/cookie-picker-routes.ts"
click node_design_cli "https://github.com/alramanathan/garrytan-gstack/blob/main/design/src/cli.ts"
click node_design_daemon "https://github.com/alramanathan/garrytan-gstack/blob/main/design/src/daemon-client.ts"
click node_pdf_cli "https://github.com/alramanathan/garrytan-gstack/blob/main/make-pdf/src/orchestrator.ts"
click node_pdf_render "https://github.com/alramanathan/garrytan-gstack/blob/main/make-pdf/src/asideClient.ts"
click node_aside_renderer "https://github.com/alramanathan/garrytan-gstack/blob/main/lib/aside-render.ts"
click node_memory_ingest "https://github.com/alramanathan/garrytan-gstack/blob/main/bin/gstack-memory-ingest.ts"
click node_memory_helpers "https://github.com/alramanathan/garrytan-gstack/blob/main/lib/gstack-memory-helpers.ts"
click node_code_intel "https://github.com/alramanathan/garrytan-gstack/tree/main/lib/code-intelligence"
click node_repo_policy "https://github.com/alramanathan/garrytan-gstack/blob/main/lib/gbrain-repo-policy-client.ts"
click node_egress_ledger "https://github.com/alramanathan/garrytan-gstack/blob/main/lib/egress-receipt.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_skills,node_prompt_resolvers toneBlue
class node_browse_service,node_browser_manager,node_cookie_picker toneAmber
class node_design_cli,node_design_daemon,node_pdf_cli,node_pdf_render,node_aside_renderer toneMint
class node_memory_ingest,node_memory_helpers,node_code_intel toneRose
class node_host_registry,node_host_configs,node_repo_policy,node_egress_ledger,node_user toneIndigo
```

## Components

### Agent workflows

- [Specialist skills](https://github.com/alramanathan/garrytan-gstack/tree/main/scripts/resolvers): `scripts/resolvers`
- [Prompt resolvers](https://github.com/alramanathan/garrytan-gstack/blob/main/scripts/resolvers/index.ts): `scripts/resolvers/index.ts`

### Browser and QA

- [Browse service](https://github.com/alramanathan/garrytan-gstack/blob/main/browse/src/server.ts): `browse/src/server.ts`
- [Browser manager](https://github.com/alramanathan/garrytan-gstack/blob/main/browse/src/browser-manager.ts): `browse/src/browser-manager.ts`
- [Cookie import](https://github.com/alramanathan/garrytan-gstack/blob/main/browse/src/cookie-picker-routes.ts): `browse/src/cookie-picker-routes.ts`

### Design and documents

- [Design tools](https://github.com/alramanathan/garrytan-gstack/blob/main/design/src/cli.ts): `design/src/cli.ts`
- [Design daemon client](https://github.com/alramanathan/garrytan-gstack/blob/main/design/src/daemon-client.ts): `design/src/daemon-client.ts`
- [PDF workflow](https://github.com/alramanathan/garrytan-gstack/blob/main/make-pdf/src/orchestrator.ts): `make-pdf/src/orchestrator.ts`
- [PDF browser render](https://github.com/alramanathan/garrytan-gstack/blob/main/make-pdf/src/asideClient.ts): `make-pdf/src/asideClient.ts`
- [Aside renderer](https://github.com/alramanathan/garrytan-gstack/blob/main/lib/aside-render.ts): `lib/aside-render.ts`

### Memory and code context

- [Memory ingest](https://github.com/alramanathan/garrytan-gstack/blob/main/bin/gstack-memory-ingest.ts): `bin/gstack-memory-ingest.ts`
- [Memory helpers](https://github.com/alramanathan/garrytan-gstack/blob/main/lib/gstack-memory-helpers.ts): `lib/gstack-memory-helpers.ts`
- [Code intelligence](https://github.com/alramanathan/garrytan-gstack/tree/main/lib/code-intelligence): `lib/code-intelligence`

### Host and trust integrations

- [Host registry](https://github.com/alramanathan/garrytan-gstack/blob/main/hosts/index.ts): `hosts/index.ts`
- [Host adapters](https://github.com/alramanathan/garrytan-gstack/tree/main/hosts): `hosts`
- [Repository policy](https://github.com/alramanathan/garrytan-gstack/blob/main/lib/gbrain-repo-policy-client.ts): `lib/gbrain-repo-policy-client.ts`
- [Egress ledger](https://github.com/alramanathan/garrytan-gstack/blob/main/lib/egress-receipt.ts): `lib/egress-receipt.ts`

### Other components

- **Builder**

## Connections

- Builder → Specialist skills: invokes (evidence: `README.md`)
- Specialist skills → Prompt resolvers: resolves prompts
- Builder → Browse service: requests browser QA
- Browse service → Browser manager: dispatches browser work (evidence: `browse/src/server.ts`)
- Browse service → Cookie import: routes cookie import (evidence: `browse/src/server.ts`)
- Builder → Design tools: uses design tools
- Design tools → Design daemon client: uses daemon client
- Builder → PDF workflow: requests document output
- PDF workflow → PDF browser render: renders PDF (evidence: `make-pdf/src/orchestrator.ts`)
- PDF browser render → Aside renderer: calls renderer (evidence: `make-pdf/src/asideClient.ts`)
- Builder → Memory ingest: ingests memory
- Memory ingest → Memory helpers: uses memory helpers (evidence: `bin/gstack-memory-ingest.ts`)
- Builder → Code intelligence: uses code context
- Host registry → Host adapters: registers adapters (evidence: `hosts/index.ts`)
- Memory ingest → Egress ledger: records egress (evidence: `bin/gstack-memory-ingest.ts`)
- Repository policy → Host adapters: gates repository use (evidence: `hosts/claude/hooks/memorable-user-prompt-hook.ts`)
