How shahid0324-git/forge-fsd works
ForgeFSD is a local-first agent-assisted full-stack app development system. Its principal dashboard workflow gathers and clarifies a request, produces a reviewable proposal, waits for approval, delegates source generation, runs build and independent browser checks, and repairs failures before separately approved preview or release actions. The graph also includes task/handoff state, older typed-plan verification, security, and release capabilities documented in the README. Some subsystem links are based on README descriptions or worker dispatch; unsampled internals are not assumed.
Main entry points: dashboard_worker.py Job worker · autonomous_planning.py Autonomous planning · autonomous_testing.py Autonomous QA · builders.py Typed workflow builder
Components 25
Dashboard
- Dashboard UI
apps/web/src/App.tsx - Dashboard API
src/forge/api.py - Job worker
src/forge/dashboard_worker.py
Planning and orchestration
- Autonomous planning
src/forge/autonomous_planning.py - Task coordination
src/forge/coordinator.py - Task ledger
src/forge/tasks.py - Role handoffs
src/forge/handoffs.py - Job persistence
src/forge/persistence.py
App implementation
- Typed workflow builder
src/forge/builders.py - Source agent
src/forge/source_agent.py - Workspace boundary
src/forge/workspace.py - Workspace tools
src/forge/workspace_tools.py
Verification and release
- Autonomous build checks
src/forge/autonomous_build.py - Autonomous QA
src/forge/autonomous_testing.py - Browser acceptance
src/forge/acceptance_browser.py - Suite and scope review
src/forge/acceptance_review.py - Repair workflow
src/forge/repair.py - Senior review
src/forge/senior_review.py - Typed verification
src/forge/verification.py - Security checks
src/forge/security.py - Approved preview
src/forge/preview.py - Release preparation
src/forge/releases.py
Other components
- Developer
- Ollama models
- Groq inference
Connections 26
- Developer → Dashboard UI: submits request
- Dashboard UI → Dashboard API: dashboard actions
- Dashboard API → Job worker: dispatches jobs
- Job worker → Autonomous planning: plans autonomously
src/forge/dashboard_worker.py - Autonomous planning → Task coordination: uses coordination
src/forge/autonomous_planning.py - Autonomous planning → Task ledger: creates task work
src/forge/autonomous_planning.py - Autonomous planning → Workspace boundary: reads workspace context
src/forge/autonomous_planning.py - Job worker → Typed workflow builder: runs typed generation
src/forge/dashboard_worker.py - Job worker → Autonomous QA: runs acceptance QA
src/forge/dashboard_worker.py - Job worker → Approved preview: starts approved preview
src/forge/dashboard_worker.py - Job worker → Release preparation: dispatches release actions
src/forge/dashboard_worker.py - Typed workflow builder → Role handoffs: records delegation
src/forge/builders.py - Typed workflow builder → Workspace boundary: uses workspace context
src/forge/builders.py - Source agent → Workspace tools: uses editing tools
src/forge/source_agent.py - Source agent → Task ledger: reads task state
src/forge/source_agent.py - Task ledger → Job persistence: loads timestamps
src/forge/tasks.py - Role handoffs → Job persistence: records events
src/forge/handoffs.py - Autonomous QA → Browser acceptance: executes browser checks
src/forge/autonomous_testing.py - Autonomous QA → Suite and scope review: reviews proposed suite
src/forge/autonomous_testing.py - Autonomous QA → Autonomous build checks: runs build checks
src/forge/autonomous_testing.py - Job worker → Repair workflow: routes repair work
src/forge/dashboard_worker.py - Senior review → Role handoffs: records review handoff
src/forge/senior_review.py - Typed verification → Typed workflow builder: checks generated app
src/forge/verification.py - Approved preview → Security checks: requires security evidence
src/forge/preview.py - Autonomous planning → Ollama models: uses selected model
- Autonomous planning → Groq inference: optional hybrid inference