Quick Init Project

Research Baseline (as of 2026-02-26)

Decision making is based on the following public signals:

• Stack Overflow Developer Survey 2024: Node.js 40.8%, React 39.5%, Next.js 17.9%, NestJS 5.8%
• State of JS 2024: 67% respondents write more TypeScript than JavaScript
• State of CSS 2024: Tailwind CSS usage significantly leads CSS framework category
• npm weekly downloads (2026-02-18 to 2026-02-24):
  • typescript: 131,004,723
  • react: 96,415,450
  • tailwindcss: 60,494,373
  • next: 36,026,759
  • @nestjs/core: 7,290,173

Input Contract

Extract at least the following inputs; use defaults when missing and note assumptions:

• Product goal: target users and core scenarios
• Delivery speed: urgent (<1 week) / normal (2-4 weeks) / long (>4 weeks)
• Team shape: frontend-heavy / backend-heavy / fullstack
• Runtime: web / api / both
• Data complexity: low / medium / high

Default assumptions: normal + small team + web-first + medium complexity

Mode Selection

Step 1: Hard Gates

Check in order; if hit, select mode immediately:

1. Only concept demo, idea validation, no production requirement -> demo
2. Backend exists with stable API contract, only need UI -> frontend-only
3. Frontend consumer exists, only need API/service -> backend-only
4. Frontend and backend both needed with frequent interface changes -> proceed to scoring (usually full-stack)

Step 2: Weighted Scoring (0-100)

Dimension scoring range 1-5:

• Requirement complexity (weight 25)
• Delivery speed pressure (weight 20)
• Team skill fitness (weight 20)
• Deployment constraint strength (weight 15)
• Data/state complexity (weight 20)

Mode target profiles:

• full-stack: [4, 3, 4, 3, 4]
• frontend-only: [2, 4, 4, 3, 2]
• backend-only: [3, 3, 4, 4, 4]
• demo: [1, 5, 3, 1, 1]

Calculation:

• fit = 5 - abs(actual - target)
• modeScore = Σ(fit/5 * weight)

Decision rules:

1. Top score < 60 -> fallback to demo + output information gaps
2. Top1 - Top2 >= 8 -> select Top1 directly
3. Gap < 8 -> compare delivery speed, team skill fitness, change surface in order

Tech Stack Policy (Data-Dense First)

Preferred Default Stack

• Language: TypeScript
• Frontend: React + Next.js (App Router) + Tailwind CSS
• Backend: NestJS (REST-first) + OpenAPI
• Package manager: pnpm
• Repository: Monorepo (pnpm workspaces)
• Task orchestration: Turborepo (default), upgrade to Nx when governance is required
• Quality baseline: ESLint + Prettier + Vitest + Playwright

Escalation to Nx

Upgrade from Turborepo to Nx when:

• Project count >= 6 packages/apps
• Need enforced module boundaries (lint-level boundaries)
• Need mature affected execution and stronger governance

Downgrade Rules

• Ultra-short PoC with only runnable pages -> can downgrade to single-repo single-app (non-monorepo)
• Backend single service with no shared packages -> can skip monorepo for now

Architecture Templates

1) full-stack

repo/
  apps/
    web/           # Next.js
    api/           # NestJS
  packages/
    ui/            # React shared components
    config/        # eslint/tsconfig/prettier shared config
    types/         # shared DTO/types
    sdk/           # typed API client
  turbo.json
  pnpm-workspace.yaml
  tsconfig.base.json

Layering rules:

• apps/* can depend on packages/*
• packages/ui cannot depend on apps/*
• packages/types must stay framework-agnostic

2) frontend-only

repo/
  apps/web/
  packages/
    ui/
    config/
    types/

Default: use MSW or mock server to decouple backend availability.

3) backend-only

repo/
  apps/api/
  packages/
    config/
    types/
    contracts/     # OpenAPI schema + generated clients

Default: deliver OpenAPI first with health/readiness endpoints.

4) demo

repo/
  apps/demo/
  packages/config/

Scope limit: single main flow + minimal dependencies + quick demo capability.

Execution Workflow

Phase B (Mode Decision):

• Use task(subagent_type="architect")
• Apply hard gates first, then weighted scoring if needed
• Output: selected mode, scores, hard gate hit (if any), reasoning (max 3 bullets), risk note (1 line)
• Save to: .omc/quick-init/decision.md

Phase C (Bootstrap Plan):

• Use task(subagent_type="planner")
• Generate: directory structure, init commands, milestones (Day 1/3/7), minimal verification commands
• Save to: .omc/quick-init/bootstrap-plan.md

Phase D (Command Generation):

• Direct execution: generate executable commands based on selected mode
• Save to: .omc/quick-init/init-commands.sh

Default Command Templates

Full-stack or multi-package:

pnpm dlx create-turbo@latest
pnpm install
pnpm -r lint
pnpm -r test
pnpm -r build

Frontend-only (non-monorepo):

pnpm create next-app@latest web --ts --tailwind --eslint --app
cd web && pnpm test

Backend-only (non-monorepo):

pnpm add -g @nestjs/cli
nest new api
cd api && pnpm test

Output Format

Every execution must return:

## Init Recommendation
- Selected Mode: <full-stack|frontend-only|backend-only|demo>
- Confidence: <HIGH|MEDIUM|LOW>

## Decision Evidence
- Hard Gate: <rule-id or none>
- Scores: full-stack=<n>, frontend-only=<n>, backend-only=<n>, demo=<n>
- Why: <3 bullets max>

## Recommended Stack
- Runtime: ...
- Frameworks: ...
- Repo Strategy: ...

## Bootstrap Commands
[exact commands here]

## Folder Blueprint
[tree here]

## 7-Day Plan
1. Day 1 ...
2. Day 3 ...
3. Day 7 ...

## Risks & Mitigations
- Risk: ...
- Mitigation: ...

Quality Gates

Before claiming "ready to initialize", must satisfy:

1. Mode selection has traceable basis (hard gate or complete scoring)
2. Tech stack includes TypeScript, with explanation if not using default stack
3. Commands are directly executable, no placeholders
4. Directory structure matches selected mode
5. At least one risk with mitigation provided

Sources

• Stack Overflow Developer Survey 2024 (Technology): https://survey.stackoverflow.co/2024/technology
• State of JS 2024 (Usage): https://2024.stateofjs.com/en-US/usage/
• State of CSS 2024 (Tools): https://2024.stateofcss.com/en-US/tools/
• npm downloads API:
  • https://api.npmjs.org/downloads/point/last-week/typescript
  • https://api.npmjs.org/downloads/point/last-week/react
  • https://api.npmjs.org/downloads/point/last-week/tailwindcss
  • https://api.npmjs.org/downloads/point/last-week/next
  • https://api.npmjs.org/downloads/point/last-week/@nestjs/core
• Turborepo docs: https://turborepo.com/docs
• pnpm workspaces: https://pnpm.io/workspaces
• Nx monorepo docs: https://nx.dev/docs/features/maintain-typescript-monorepos
• TypeScript project references: https://www.typescriptlang.org/docs/handbook/project-references