onboard

Onboard: New Project Setup

Overview

Guide users through setting up codingbuddy in a new project via interactive, step-by-step onboarding. Detect the tech stack automatically, generate configuration, and create adapter files for their AI tools.

Step 1: Project Scanning

Scan the project root to detect:

Package managers & languages:

• package.json → Node.js/TypeScript (check for typescript dep)
• requirements.txt / pyproject.toml / setup.py → Python
• go.mod → Go
• Cargo.toml → Rust
• pom.xml / build.gradle → Java/Kotlin
• Gemfile → Ruby
• composer.json → PHP

Frameworks (from dependency files):

• React, Next.js, Vue, Angular, Svelte, Express, NestJS, Django, Flask, FastAPI, Spring Boot, Rails, Laravel, Gin, Echo, etc.

Test setup:

• Jest, Vitest, Mocha, Pytest, Go test, JUnit, RSpec, PHPUnit, etc.

Monorepo indicators:

• workspaces in package.json, lerna.json, pnpm-workspace.yaml, nx.json, turbo.json

AI tools already present:

• .cursor/ → Cursor
• .claude/ → Claude Code
• .antigravity/ → Antigravity (Gemini)
• .codex/ → Codex
• .q/ → Amazon Q
• .kiro/ → Kiro
• .github/copilot/ → GitHub Copilot

After scanning, present findings to the user:

Detected:
- Language: TypeScript
- Framework: Next.js 14, React 18
- Test: Vitest
- Monorepo: Yarn workspaces
- AI tools: .claude/ (existing)

Ask: "Does this look correct? Anything to add or change?" (use AskUserQuestion)

Step 2: Generate codingbuddy.config.json

Based on detected info, generate a draft config:

{
  "language": "en",
  "techStack": {
    "languages": ["typescript"],
    "frameworks": ["nextjs", "react"],
    "testing": ["vitest"],
    "packageManager": "yarn"
  },
  "architecture": {
    "pattern": "layered",
    "monorepo": true
  },
  "agents": {
    "primary": "software-engineer",
    "specialists": ["frontend-developer", "test-engineer"]
  }
}

Ask the user to confirm or adjust:

• Communication language (en, ko, ja, zh, es, etc.)
• Primary agent selection (show top 3 recommendations based on tech stack)
• Architecture pattern (layered, clean, hexagonal, or custom)