How dicklesworthstone/agentic_coding_flywheel_setup works
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: wizard Setup wizard · commandBuilder.ts Install command · useInstallationHealth.ts Installation health · index.ts Manifest package
Components 24
Web guidance
- Setup wizard
apps/web/app/wizard - Setup stages
apps/web/lib/wizardSteps.ts - Wizard state
apps/web/lib/wizardInstallation.ts - User preferences
apps/web/lib/userPreferences.ts - Module selection
apps/web/lib/moduleSelection.ts - Install command
apps/web/lib/commandBuilder.ts - Event tracking
apps/web/app/api/track/route.ts
VPS setup
- Install redirect
apps/web/app/install/route.ts - Target VPS
- Configured environment
- Service catalog
apps/web/lib/services.ts - Installation health
apps/web/lib/hooks/useInstallationHealth.ts
Manifest and plugins
- Manifest package
packages/manifest/src/index.ts - Manifest schema
packages/manifest/src/schema.ts - Manifest parser
packages/manifest/src/parser.ts - Metadata generator
packages/manifest/src/generate.ts - Plugin archives
packages/manifest/src/plugin-archive.ts - Plugin review
packages/manifest/src/plugin-review.ts - Plugin runtime
packages/manifest/src/plugin-runtime.ts
Learning resources
- Lessons and guides
apps/web/app/learn - Tool catalog
apps/web/lib/tldr-content.ts - Workflow guides
apps/web/app/workflow/page.tsx
Other components
- Beginner
- Analytics service
Connections 22
- 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