@moretea-labs/forge 1.5.0-rc.1

package/assets/initializer-question-pack.v4.json

@@ -0,0 +1,557 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "version": "initializer-question-pack.v4",
+  "goal": "Infer strong harness defaults first, then confirm only the decisions that materially change the generated repo-local workflow.",
+  "decisionPoints": [
+    {
+      "id": "project_identity",
+      "title": "Project Identity",
+      "batch": 1,
+      "questions": [
+        "Project name",
+        "Developer name",
+        "One-line product brief"
+      ],
+      "required": true
+    },
+    {
+      "id": "plan_selection",
+      "title": "Plan Selection",
+      "batch": 1,
+      "questions": [
+        "Choose core stack family A-F",
+        "If sidecar/runtime preset is needed: choose G/H/I/J/K"
+      ],
+      "required": true
+    },
+    {
+      "id": "delivery_constraints",
+      "title": "Delivery Constraints",
+      "batch": 2,
+      "questions": [
+        "Team size",
+        "MVP scope and acceptance criteria"
+      ],
+      "required": true
+    },
+    {
+      "id": "runtime_defaults",
+      "title": "Runtime Defaults",
+      "batch": 2,
+      "questions": [
+        "Confirm inferred package manager",
+        "Permission mode: Permissionless / Plan-only / Standard (default: Plan-only)",
+        "Confirm commit policy"
+      ],
+      "required": true
+    },
+    {
+      "id": "webapp_rendering_model",
+      "title": "Webapp Rendering Model",
+      "batch": 2,
+      "questions": [
+        "Choose webapp rendering/deployment model: none, client-only, start-workers, astro-content, or custom",
+        "If the app needs SEO/SSR plus an authenticated workspace, prefer start-workers with one apps/web frontend, / SSR/public route, and /app client-only boundary"
+      ],
+      "required": false
+    },
+    {
+      "id": "ai_native_profile",
+      "title": "AI-Native Profile",
+      "batch": 2,
+      "questions": [
+        "Choose AI-native overlay: none (default), chat-agent, collaborative-editor, runtime-console, product-copilot, workflow-agent, generative-ui-agent, browser-agent, research-agent, coding-agent, enterprise-agent-platform, voice-agent, or sidecar-kernel",
+        "Confirm whether generated structure should add AG-UI, assistant-ui or CopilotKit, Bun/Hono gateway, MCP/tool, sidecar, and observability boundaries"
+      ],
+      "required": false
+    },
+    {
+      "id": "orchestration_profile",
+      "title": "Orchestration Profile",
+      "batch": 3,
+      "questions": [
+        "Confirm planner -> generator -> evaluator harness flow",
+        "Override artifact strictness only if the team needs a lighter loop"
+      ],
+      "required": true
+    },
+    {
+      "id": "evaluation_profile",
+      "title": "Evaluation Profile",
+      "batch": 3,
+      "questions": [
+        "Choose browser QA vs command QA default",
+        "Any extra scoring dimensions or hard thresholds"
+      ],
+      "required": false
+    },
+    {
+      "id": "context_profile",
+      "title": "Context Profile",
+      "batch": 3,
+      "questions": [
+        "Choose context profile: stable-root + progressive-subdir (default) or flat-root",
+        "Confirm whether paired CLAUDE.md and AGENTS.md files should be generated only for primary functional blocks in multi-module repos"
+      ],
+      "required": false
+    },
+    {
+      "id": "documentation_profile",
+      "title": "Documentation Profile",
+      "batch": 3,
+      "questions": [
+        "Use minimal-agentic docs by default",
+        "Generate optional product, stack, decision, architecture, and package docs only when evidence exists"
+      ],
+      "required": false
+    },
+    {
+      "id": "handoff_profile",
+      "title": "Handoff Profile",
+      "batch": 4,
+      "questions": [
+        "When should the repo force a handoff artifact",
+        "Any custom handoff sections or restore expectations"
+      ],
+      "required": false
+    },
+    {
+      "id": "resilience_profile",
+      "title": "Recovery & State Profile",
+      "batch": 4,
+      "questions": [
+        "Choose recovery policy: lesson-driven (default) or structured-guards",
+        "Choose state policy: file-backed (default) or context-light"
+      ],
+      "required": false
+    },
+    {
+      "id": "quality_rules",
+      "title": "Quality Rules",
+      "batch": 4,
+      "questions": [
+        "Project-specific prohibitions",
+        "Any must-enforce compliance constraints"
+      ],
+      "required": false
+    },
+    {
+      "id": "external_tooling",
+      "title": "External Tooling",
+      "batch": 5,
+      "questions": [
+        "Use layered routing for complex/gstack, simple/Waza, and knowledge/gbrain workflows",
+        "Default host coverage: Claude Code + Codex",
+        "Enable gbrain knowledge-layer guidance while leaving MCP disabled by default"
+      ],
+      "required": false
+    },
+    {
+      "id": "plugin_profile",
+      "title": "Plugin Profile",
+      "batch": 5,
+      "questions": [
+        "Install recommended global plugins",
+        "Enable LSP set by stack"
+      ],
+      "required": false
+    }
+  ],
+  "planTiers": {
+    "core": [
+      "A",
+      "B",
+      "C",
+      "D",
+      "E",
+      "F"
+    ],
+    "presets": [
+      "G",
+      "H",
+      "I",
+      "J",
+      "K"
+    ]
+  },
+  "inferredDefaults": {
+    "packageManagerPriority": [
+      "bun",
+      "pnpm",
+      "npm"
+    ],
+    "runtimeProfile": "plan-only",
+    "orchestrationProfile": "shared-long-running-harness",
+    "evaluationProfile": "browser-qa",
+    "handoffProfile": "artifact-aware",
+    "recoveryProfile": "hybrid",
+    "stateProfile": "file-backed",
+    "contextProfile": "stable-root-progressive-subdir",
+    "documentationProfile": "minimal-agentic",
+    "aiNativeProfile": "none",
+    "webappRenderingModel": "none"
+  },
+  "runtimeProfiles": {
+    "permissionless": {
+      "label": "Plan + Permissionless",
+      "claudePolicy": "--dangerously-skip-permissions",
+      "codexPolicy": "sandbox_mode=danger-full-access, approval_policy=never"
+    },
+    "plan-only": {
+      "label": "Plan-only (recommended)",
+      "claudePolicy": "(default permissions)",
+      "codexPolicy": "sandbox_mode=platform-default, approval_policy=on-failure"
+    },
+    "standard": {
+      "label": "Standard (ask before each action)",
+      "claudePolicy": "(default permissions)",
+      "codexPolicy": "sandbox_mode=platform-default, approval_policy=always"
+    }
+  },
+  "orchestrationProfiles": {
+    "shared-long-running-harness": {
+      "label": "Shared long-running harness",
+      "description": "Default planner -> generator -> evaluator loop with repo-local artifacts and strict execution gates."
+    },
+    "lightweight-collaboration": {
+      "label": "Lightweight collaboration",
+      "description": "Keeps the artifact model but uses softer review and handoff gates."
+    }
+  },
+  "evaluationProfiles": {
+    "browser-qa": {
+      "label": "Browser QA + evaluator rubric",
+      "description": "Use browser-first QA evidence and UI-aware scoring when the plan includes a user-facing surface."
+    },
+    "command-qa": {
+      "label": "Command QA + evaluator rubric",
+      "description": "Use command/test/build evidence and reliability scoring when the plan is backend or TUI focused."
+    }
+  },
+  "handoffProfiles": {
+    "artifact-aware": {
+      "label": "Artifact-aware handoff",
+      "description": "Force a structured handoff artifact on context rollover, failed verification, and session stop."
+    },
+    "manual-handoff": {
+      "label": "Manual handoff",
+      "description": "Generate handoff artifacts on demand while keeping the same file format."
+    }
+  },
+  "recoveryProfiles": {
+    "lesson-driven": {
+      "label": "Lesson-driven",
+      "description": "Keep human-readable recovery prompts and use tasks/lessons.md as the primary improvement loop."
+    },
+    "structured-guards": {
+      "label": "Structured guards",
+      "description": "Emit standardized failure_class metadata from guards while keeping the same human-readable recovery text."
+    },
+    "hybrid": {
+      "label": "Hybrid",
+      "description": "Combine structured guard metadata with lesson-driven recovery and automatic handoff refresh."
+    }
+  },
+  "stateProfiles": {
+    "file-backed": {
+      "label": "File-backed",
+      "description": "Persist execution, verification, and handoff state to repo-local artifacts."
+    },
+    "context-light": {
+      "label": "Context-light",
+      "description": "Use the same workflow surface with fewer persisted state assumptions for lightweight repos."
+    }
+  },
+  "contextProfiles": {
+    "stable-root-progressive-subdir": {
+      "label": "Stable root + progressive subdir",
+      "description": "Keep the root contract small and expose paired CLAUDE.md and AGENTS.md files for primary functional blocks through a context map."
+    },
+    "flat-root": {
+      "label": "Flat root",
+      "description": "Keep a single root context surface for smaller repos that do not need functional-block context files."
+    }
+  },
+  "webappRenderingModels": {
+    "none": {
+      "label": "None",
+      "description": "Use the selected A-K family without a webapp rendering/deployment overlay.",
+      "frontend": "Selected plan default",
+      "deployment": "Selected plan default",
+      "publicRoute": "Selected plan default",
+      "appRoute": "Selected plan default",
+      "fallback": "Selected plan default",
+      "techStackRows": []
+    },
+    "client-only": {
+      "label": "Client-only Vite",
+      "description": "Dense interactive app, dashboard, internal tool, or embedded surface that does not need crawler-visible landing HTML.",
+      "frontend": "Vite 8 + React + TanStack Router/Query",
+      "deployment": "Cloudflare Pages/static assets or Worker static assets by explicit deploy target",
+      "publicRoute": "Client-rendered routes only; no SEO SSR guarantee",
+      "appRoute": "Browser-only React app shell",
+      "fallback": "Use start-workers when public SEO/SSR matters",
+      "techStackRows": [
+        "| Webapp model | Client-only Vite + TanStack Router/Query |",
+        "| Deploy | Static assets via Pages or Worker assets by explicit target |",
+        "| SEO boundary | No SSR guarantee; use Plan C start-workers for crawler-visible landing HTML |"
+      ]
+    },
+    "start-workers": {
+      "label": "TanStack Start on Cloudflare Workers",
+      "description": "Single React webapp deployment for public SEO/SSR landing plus authenticated or browser-heavy workspace routes.",
+      "frontend": "TanStack Start + Vite + React",
+      "deployment": "Cloudflare Workers with @cloudflare/vite-plugin, wrangler.jsonc, Worker assets, and wrangler deploy",
+      "publicRoute": "`/` SSR/prerender-capable landing route with meta, OG, canonical, and crawler-visible HTML",
+      "appRoute": "`/app` client-only route boundary via route-level `ssr: false`; lazy-load browser-only/WebGL components",
+      "fallback": "If Start + Workers fails a thin gate, evaluate Vike or React Router Framework Mode; do not split into two default frontends",
+      "projectStructureFile": "assets/project-structures/tanstack-start-workers.txt",
+      "techStackRows": [
+        "| Webapp model | TanStack Start + Vite + React |",
+        "| Deploy | Cloudflare Workers, `wrangler.jsonc`, Worker assets, `wrangler deploy` |",
+        "| Public route | `/` SSR/prerender-capable landing with meta/OG/canonical |",
+        "| Workspace route | `/app` client-only with route-level `ssr: false` and lazy browser-only components |",
+        "| Frontend count | One deployable frontend component under `apps/web`; backend Workers remain separate only when they own API/Agent/MCP runtime authority |"
+      ]
+    },
+    "astro-content": {
+      "label": "Astro content shell",
+      "description": "Content-heavy site, docs, blog, or mostly-static landing shell with islands where interaction is limited.",
+      "frontend": "Astro + TypeScript + React islands only when needed",
+      "deployment": "Cloudflare Pages/Workers or Node adapter selected by SSR/runtime needs",
+      "publicRoute": "Astro SSR/content routes",
+      "appRoute": "Separate explicit app surface only when required, not an implicit second frontend",
+      "fallback": "Use start-workers when the React app itself needs both SEO/SSR landing and authenticated workspace",
+      "techStackRows": [
+        "| Webapp model | Astro content/SSR shell |",
+        "| App boundary | Add a React app surface explicitly only when interaction justifies it |",
+        "| SEO boundary | Content-first SSR; not the default dense React workspace shell |"
+      ]
+    },
+    "custom": {
+      "label": "Custom",
+      "description": "Manually specified web rendering and deploy model.",
+      "frontend": "Defined during guided Q&A",
+      "deployment": "Defined during guided Q&A",
+      "publicRoute": "Defined during guided Q&A",
+      "appRoute": "Defined during guided Q&A",
+      "fallback": "Record the tradeoff and verification gate in the plan",
+      "techStackRows": [
+        "| Webapp model | Custom, explicitly documented |"
+      ]
+    }
+  },
+  "aiNativeProfiles": {
+    "none": {
+      "label": "None",
+      "description": "Use the selected A-K plan without an AI-native app runtime overlay.",
+      "frontend": "Existing plan default",
+      "runtimeProtocol": "None",
+      "backend": "Existing plan default",
+      "stateDefault": "Existing plan default",
+      "sidecarPolicy": "None",
+      "uiSchema": "None",
+      "techStackRows": []
+    },
+    "chat-agent": {
+      "label": "Chat agent",
+      "description": "Ordinary AI chat, RAG, or help assistant inside the selected app plan.",
+      "frontend": "Vite 8 + assistant-ui or the selected plan UI",
+      "runtimeProtocol": "AI SDK UI stream or AG-UI lite",
+      "backend": "Bun/Hono gateway or Mastra/Hono runtime behind the existing API boundary",
+      "stateDefault": "TanStack Query + Zustand",
+      "sidecarPolicy": "Python only when the model framework needs it",
+      "uiSchema": "Hardcoded React components",
+      "techStackRows": [
+        "| AI UI | assistant-ui chat surface |",
+        "| Agent stream | AI SDK UI stream or AG-UI lite |",
+        "| Agent runtime | Bun/Hono by default; Mastra when TS agents need memory, tools, workflows, or evals |",
+        "| Agent state | TanStack Query + Zustand |"
+      ]
+    },
+    "collaborative-editor": {
+      "label": "Collaborative editor",
+      "description": "AI-aware document, CMS, or knowledge workspace with local-first collaboration and explicit sync ownership.",
+      "frontend": "Vite 8 + React 19 + Plate + shadcn/ui",
+      "runtimeProtocol": "Loro CRDT document events; AI SDK or AG-UI only for user-visible agent runs",
+      "backend": "Bun/Hono sync and agent gateway, or existing API boundary",
+      "stateDefault": "Loro document state + TanStack Query server cache + Zustand UI state",
+      "sidecarPolicy": "None by default; Python or Go sidecars only for extraction, indexing, or heavy sync workers",
+      "uiSchema": "Plate node/plugin schema plus app-owned document contracts",
+      "projectStructureFile": "assets/project-structures/ai-native-collaborative-editor.txt",
+      "techStackRows": [
+        "| Editor UI | Plate + shadcn/ui in a Vite 8 React surface |",
+        "| Collaboration | Loro CRDT document state and sync contracts |",
+        "| Agent runtime | AI SDK or AG-UI only for user-visible assistant/document actions |",
+        "| Sync gateway | Bun/Hono or existing API boundary owns persistence and auth |",
+        "| State split | Loro for document replicas; TanStack Query for server cache; Zustand for UI chrome |"
+      ]
+    },
+    "runtime-console": {
+      "label": "Runtime console",
+      "description": "Agent runtime console with trace, replay, prompt playground, approvals, artifacts, and tool-call visibility.",
+      "frontend": "Vite 8 + TanStack Router + assistant-ui + trace/timeline panels",
+      "runtimeProtocol": "AG-UI required",
+      "backend": "Bun/Hono agent gateway",
+      "stateDefault": "TanStack Query + Zustand + Jotai",
+      "sidecarPolicy": "Python sidecar allowed for model framework or eval pipelines",
+      "uiSchema": "A2UI optional experiment, not production default",
+      "projectStructureFile": "assets/project-structures/ai-native-runtime-console.txt",
+      "techStackRows": [
+        "| AI UI | assistant-ui + custom run console |",
+        "| Agent protocol | AG-UI events over HTTP streaming |",
+        "| Agent gateway | Bun/Hono `/api/agent/run` |",
+        "| Agent state | TanStack Query + Zustand + Jotai |",
+        "| Contracts | Zod/Valibot run, event, tool, approval, artifact schemas |",
+        "| Observability | OpenTelemetry spans/log events for model, tool, approval, and sidecar latency |"
+      ]
+    },
+    "product-copilot": {
+      "label": "Product copilot",
+      "description": "SaaS in-app copilot that can inspect product context and call business actions through narrow tools.",
+      "frontend": "Vite 8 + CopilotKit or assistant-ui headless",
+      "runtimeProtocol": "AG-UI",
+      "backend": "Bun/Hono agent gateway",
+      "stateDefault": "TanStack Query + Zustand/Jotai",
+      "sidecarPolicy": "MCP tools for business actions; sidecars only by capability",
+      "uiSchema": "Optional A2UI experiment",
+      "projectStructureFile": "assets/project-structures/ai-native-product-copilot.txt",
+      "techStackRows": [
+        "| Copilot UI | CopilotKit or assistant-ui headless |",
+        "| Agent protocol | AG-UI app-domain events |",
+        "| Business tools | MCP or narrow HTTP actions |",
+        "| Agent state | TanStack Query + Zustand/Jotai |"
+      ]
+    },
+    "workflow-agent": {
+      "label": "Workflow agent",
+      "description": "Visual workflow or DAG builder for composing agent steps and tool execution.",
+      "frontend": "Vite 8 + React Flow/xyflow + Monaco",
+      "runtimeProtocol": "AG-UI",
+      "backend": "Bun/Hono gateway",
+      "stateDefault": "Jotai + Zustand + TanStack Query",
+      "sidecarPolicy": "Mastra, LangGraph, Temporal, Inngest, or BullMQ only when execution needs workflow durability or orchestration",
+      "uiSchema": "A2UI optional experiment",
+      "techStackRows": [
+        "| Workflow UI | React Flow/xyflow + Monaco |",
+        "| Agent protocol | AG-UI workflow/run events |",
+        "| Executor | Bun/Hono gateway with optional Mastra or durable workflow engine |",
+        "| Agent state | Jotai + Zustand + TanStack Query |"
+      ]
+    },
+    "generative-ui-agent": {
+      "label": "Generative UI agent",
+      "description": "Agent-generated forms, cards, tables, and artifacts through a safe component registry.",
+      "frontend": "Vite 8 + safe React component registry",
+      "runtimeProtocol": "AG-UI",
+      "backend": "Bun/Hono gateway",
+      "stateDefault": "Jotai + TanStack Query",
+      "sidecarPolicy": "Only when renderer or tool kernels need it",
+      "uiSchema": "A2UI experimental",
+      "techStackRows": [
+        "| Generated UI | Safe React registry |",
+        "| Agent protocol | AG-UI events carrying app-domain payloads |",
+        "| UI schema | A2UI experimental, not executable code |",
+        "| Agent state | Jotai + TanStack Query |"
+      ]
+    },
+    "browser-agent": {
+      "label": "Browser agent",
+      "description": "Browser automation, computer-use, or RPA workbench with explicit task/run visibility.",
+      "frontend": "Vite 8 custom console",
+      "runtimeProtocol": "AG-UI",
+      "backend": "Bun/Hono gateway",
+      "stateDefault": "Jotai + TanStack Query",
+      "sidecarPolicy": "Playwright, Browserbase, or Stagehand worker",
+      "uiSchema": "None by default",
+      "techStackRows": [
+        "| Browser console | Vite 8 custom run console |",
+        "| Agent protocol | AG-UI browser-run events |",
+        "| Automation worker | Playwright/Browserbase/Stagehand sidecar |",
+        "| Agent state | Jotai + TanStack Query |"
+      ]
+    },
+    "research-agent": {
+      "label": "Research agent",
+      "description": "Evidence and report workspace for deep research, artifacts, citations, and handoffs.",
+      "frontend": "Vite 8 + assistant-ui + artifact panels",
+      "runtimeProtocol": "AG-UI",
+      "backend": "Bun/Hono gateway",
+      "stateDefault": "TanStack Query + Zustand + Jotai",
+      "sidecarPolicy": "Python optional for research pipelines",
+      "uiSchema": "Hardcoded artifact components first",
+      "techStackRows": [
+        "| Research UI | assistant-ui + artifact workspace |",
+        "| Agent protocol | AG-UI evidence and artifact events |",
+        "| Research backend | Bun/Hono gateway with optional Python pipeline |",
+        "| Agent state | TanStack Query + Zustand + Jotai |"
+      ]
+    },
+    "coding-agent": {
+      "label": "Coding agent",
+      "description": "AI IDE, repo, PR, or DevOps agent with diff, terminal, and sandbox surfaces.",
+      "frontend": "Vite 8 + assistant-ui + Monaco + diff/terminal panels",
+      "runtimeProtocol": "AG-UI + MCP optional",
+      "backend": "Bun/Hono gateway",
+      "stateDefault": "Jotai + TanStack Query",
+      "sidecarPolicy": "Sandbox worker, Go, or Rust optional by capability",
+      "uiSchema": "None by default",
+      "techStackRows": [
+        "| Coding UI | assistant-ui + Monaco + diff/terminal panels |",
+        "| Agent protocol | AG-UI with optional MCP tool boundary |",
+        "| Sandbox | Worker or sidecar boundary |",
+        "| Agent state | Jotai + TanStack Query |"
+      ]
+    },
+    "enterprise-agent-platform": {
+      "label": "Enterprise agent platform",
+      "description": "Multi-tenant platform with shared agent gateway, capability-scoped sidecars, and docs/marketing shell.",
+      "frontend": "Astro for web/docs/SSR shell + Vite 8 apps",
+      "runtimeProtocol": "AG-UI",
+      "backend": "Bun/Hono gateway",
+      "stateDefault": "TanStack Query + Zustand + Jotai",
+      "sidecarPolicy": "Sidecars by capability",
+      "uiSchema": "A2UI optional experiment",
+      "techStackRows": [
+        "| Web shell | Astro docs/marketing + Vite 8 app surfaces |",
+        "| Agent protocol | AG-UI platform events |",
+        "| Agent gateway | Bun/Hono multi-tenant boundary |",
+        "| Capability sidecars | MCP/HTTP per capability |"
+      ]
+    },
+    "voice-agent": {
+      "label": "Voice agent",
+      "description": "Realtime voice or call assistant with media and run state boundaries.",
+      "frontend": "Vite 8 realtime UI",
+      "runtimeProtocol": "AG-UI side-channel + WebRTC",
+      "backend": "Bun/Hono gateway",
+      "stateDefault": "TanStack Query + Zustand",
+      "sidecarPolicy": "Realtime/media sidecar optional",
+      "uiSchema": "None by default",
+      "techStackRows": [
+        "| Voice UI | Vite 8 realtime controls |",
+        "| Agent protocol | AG-UI side-channel + WebRTC |",
+        "| Media boundary | Realtime/media sidecar optional |",
+        "| Agent state | TanStack Query + Zustand |"
+      ]
+    },
+    "sidecar-kernel": {
+      "label": "Sidecar kernel",
+      "description": "TypeScript app core with Python, Go, or Rust kernels behind MCP or narrow HTTP boundaries.",
+      "frontend": "Selected plan frontend; Vite 8 app shell when interactive",
+      "runtimeProtocol": "AG-UI when user-visible agent runs exist; MCP/HTTP for sidecars",
+      "backend": "Bun/Hono gateway owns app-facing API",
+      "stateDefault": "TanStack Query + Zustand, plus domain stores as needed",
+      "sidecarPolicy": "Python ADK/FastAPI for model/eval/data pipelines, Go/Gin for high-concurrency workers or infra adapters, Rust for low-latency parsing/indexing/sandboxing",
+      "uiSchema": "None by default",
+      "projectStructureFile": "assets/project-structures/ai-native-sidecar-kernel.txt",
+      "techStackRows": [
+        "| App gateway | Bun/Hono owns app-facing API |",
+        "| Sidecar protocol | MCP tools or narrow HTTP jobs |",
+        "| Python sidecar | Google ADK/FastAPI, model frameworks, evals, data science |",
+        "| Go sidecar | Gin workers, Supabase REST adapters, high-concurrency infra jobs |",
+        "| Rust sidecar | Parsing, indexing, sandboxing, native kernels |"
+      ]
+    }
+  }
+}