# dicklesworthstone/agentic_coding_flywheel_setup architecture

> Architecture diagram of the GitHub repository dicklesworthstone/agentic_coding_flywheel_setup, 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/dicklesworthstone/agentic_coding_flywheel_setup
- Repository: https://github.com/dicklesworthstone/agentic_coding_flywheel_setup
- Video tour (about a minute): https://gitdiagram.com/dicklesworthstone/agentic_coding_flywheel_setup/video

## Overview

ACFS combines an interactive web guide with a VPS bootstrap workflow, plus a manifest package for module metadata and plugin handling. The README documents the user journey and manifest role; sampled web source confirms the install redirect, local wizard state, and tracking endpoint. The repository tree does not show the installer or manifest data file, so those are represented only where documentation supports them.

Main entry points: [`apps/web/app/wizard`](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/tree/main/apps/web/app/wizard) (Setup wizard), [`apps/web/lib/commandBuilder.ts`](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/commandBuilder.ts) (Install command), [`apps/web/lib/hooks/useInstallationHealth.ts`](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/hooks/useInstallationHealth.ts) (Installation health), [`packages/manifest/src/index.ts`](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/index.ts) (Manifest package)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guidance["Web guidance"]
  node_wizard["Setup wizard"]
  node_wizard_steps["Setup stages<br/>[wizardSteps.ts]"]
  node_wizard_state["Wizard state"]
  node_preferences["User preferences<br/>[userPreferences.ts]"]
  node_selection["Module selection<br/>[moduleSelection.ts]"]
  node_command["Install command<br/>[commandBuilder.ts]"]
  node_tracking["Event tracking<br/>[route.ts]"]
end

subgraph group_setup["VPS setup"]
  node_install_route["Install redirect<br/>[route.ts]"]
  node_vps(("Target VPS"))
  node_environment["Configured environment"]
  node_services["Service catalog<br/>[services.ts]"]
  node_health["Installation health"]
end

subgraph group_manifest["Manifest and plugins"]
  node_manifest_package["Manifest package<br/>[index.ts]"]
  node_manifest_schema["Manifest schema<br/>[schema.ts]"]
  node_manifest_parser["Manifest parser<br/>[parser.ts]"]
  node_manifest_generator["Metadata generator<br/>[generate.ts]"]
  node_plugin_archive["Plugin archives<br/>[plugin-archive.ts]"]
  node_plugin_review["Plugin review<br/>[plugin-review.ts]"]
  node_plugin_runtime["Plugin runtime<br/>[plugin-runtime.ts]"]
end

subgraph group_learning["Learning resources"]
  node_learn["Lessons and guides"]
  node_tool_catalog["Tool catalog<br/>[tldr-content.ts]"]
  node_workflow_guides["Workflow guides<br/>[page.tsx]"]
end

node_user(("Beginner"))
node_analytics(("Analytics service"))

node_user -->|"opens"| node_wizard
node_wizard -->|"presents"| node_wizard_steps
node_wizard -->|"tracks progress"| node_wizard_state
node_wizard -->|"collects settings"| node_preferences
node_wizard -->|"selects modules"| node_selection
node_wizard -->|"builds command"| node_command
node_user -->|"runs command"| node_command
node_user -->|"requests install"| node_install_route
node_install_route -->|"redirects to installer"| node_vps
node_vps -->|"installs tools"| node_environment
node_wizard -->|"shows services"| node_services
node_health -->|"resolves selection"| node_selection
node_health -->|"builds reinstall command"| node_command
node_manifest_package -->|"exposes parser"| node_manifest_parser
node_manifest_package -->|"exposes generator"| node_manifest_generator
node_manifest_parser -->|"validates against"| node_manifest_schema
node_plugin_review -->|"reads verified archive"| node_plugin_archive
node_learn -->|"teaches setup"| node_user
node_tool_catalog -->|"describes tools"| node_user
node_workflow_guides -->|"explains workflow"| node_user
node_wizard -->|"sends events"| node_tracking
node_tracking -.->|"forwards events"| node_analytics

click node_wizard "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/tree/main/apps/web/app/wizard"
click node_wizard_steps "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/wizardSteps.ts"
click node_wizard_state "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/wizardInstallation.ts"
click node_preferences "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/userPreferences.ts"
click node_selection "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/moduleSelection.ts"
click node_command "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/commandBuilder.ts"
click node_install_route "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/app/install/route.ts"
click node_services "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/services.ts"
click node_health "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/hooks/useInstallationHealth.ts"
click node_manifest_package "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/index.ts"
click node_manifest_schema "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/schema.ts"
click node_manifest_parser "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/parser.ts"
click node_manifest_generator "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/generate.ts"
click node_plugin_archive "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/plugin-archive.ts"
click node_plugin_review "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/plugin-review.ts"
click node_plugin_runtime "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/plugin-runtime.ts"
click node_learn "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/tree/main/apps/web/app/learn"
click node_tool_catalog "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/tldr-content.ts"
click node_workflow_guides "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/app/workflow/page.tsx"
click node_tracking "https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/app/api/track/route.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_wizard,node_wizard_steps,node_wizard_state,node_preferences,node_selection,node_command,node_tracking toneBlue
class node_install_route,node_vps,node_environment,node_services,node_health toneAmber
class node_manifest_package,node_manifest_schema,node_manifest_parser,node_manifest_generator,node_plugin_archive,node_plugin_review,node_plugin_runtime toneMint
class node_learn,node_tool_catalog,node_workflow_guides toneRose
class node_user,node_analytics toneIndigo
```

## Components

### Web guidance

- [Setup wizard](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/tree/main/apps/web/app/wizard): `apps/web/app/wizard`
- [Setup stages](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/wizardSteps.ts): `apps/web/lib/wizardSteps.ts`
- [Wizard state](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/wizardInstallation.ts): `apps/web/lib/wizardInstallation.ts`
- [User preferences](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/userPreferences.ts): `apps/web/lib/userPreferences.ts`
- [Module selection](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/moduleSelection.ts): `apps/web/lib/moduleSelection.ts`
- [Install command](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/commandBuilder.ts): `apps/web/lib/commandBuilder.ts`
- [Event tracking](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/app/api/track/route.ts): `apps/web/app/api/track/route.ts`

### VPS setup

- [Install redirect](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/app/install/route.ts): `apps/web/app/install/route.ts`
- **Target VPS**
- **Configured environment**
- [Service catalog](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/services.ts): `apps/web/lib/services.ts`
- [Installation health](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/hooks/useInstallationHealth.ts): `apps/web/lib/hooks/useInstallationHealth.ts`

### Manifest and plugins

- [Manifest package](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/index.ts): `packages/manifest/src/index.ts`
- [Manifest schema](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/schema.ts): `packages/manifest/src/schema.ts`
- [Manifest parser](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/parser.ts): `packages/manifest/src/parser.ts`
- [Metadata generator](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/generate.ts): `packages/manifest/src/generate.ts`
- [Plugin archives](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/plugin-archive.ts): `packages/manifest/src/plugin-archive.ts`
- [Plugin review](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/plugin-review.ts): `packages/manifest/src/plugin-review.ts`
- [Plugin runtime](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/packages/manifest/src/plugin-runtime.ts): `packages/manifest/src/plugin-runtime.ts`

### Learning resources

- [Lessons and guides](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/tree/main/apps/web/app/learn): `apps/web/app/learn`
- [Tool catalog](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/lib/tldr-content.ts): `apps/web/lib/tldr-content.ts`
- [Workflow guides](https://github.com/dicklesworthstone/agentic_coding_flywheel_setup/blob/main/apps/web/app/workflow/page.tsx): `apps/web/app/workflow/page.tsx`

### Other components

- **Beginner**
- **Analytics service**

## Connections

- Beginner → Setup wizard: opens
- Setup wizard → Setup stages: presents
- Setup wizard → Wizard state: tracks progress
- Setup wizard → User preferences: collects settings
- Setup wizard → Module selection: selects modules
- Setup wizard → Install command: builds command
- Beginner → Install command: runs command
- Beginner → Install redirect: requests install
- Install redirect → Target VPS: redirects to installer
- Target VPS → Configured environment: installs tools
- Setup wizard → Service catalog: shows services
- Installation health → Module selection: resolves selection
- Installation health → Install command: builds reinstall command
- Manifest package → Manifest parser: exposes parser
- Manifest package → Metadata generator: exposes generator
- Manifest parser → Manifest schema: validates against
- Plugin review → Plugin archives: reads verified archive
- Lessons and guides → Beginner: teaches setup
- Tool catalog → Beginner: describes tools
- Workflow guides → Beginner: explains workflow
- Setup wizard → Event tracking: sends events
- Event tracking → Analytics service: forwards events
