Harness Init Skill

Sets up a project so VibeCoder can start development with natural language only. Completes with minimum 1 question, ready to start development immediately.

Quick Reference

• "Want to launch a new project fastest" → this skill
• "Leave it to you" / "Quickly" → proceed with defaults, no questions
• "With Next.js + Supabase" → technology specification
• "Introduce harness to existing project" → analyze existing code

Deliverables

• Real project generation (e.g., create-next-app) + initial setup
• Prepare Plans.md / AGENTS.md / CLAUDE.md / .claude/
• Optional: Codex CLI compatibility (.codex/ + AGENTS.md)
• Environment diagnosis → SSOT initialization → Final validation
• → Ready to run Plan→Work→Review immediately

Usage

/harness-init                              # Interactive setup (min 1 question)
/harness-init blog --mode=solo             # With partial specification
/harness-init --stack=next-supabase        # Specify tech stack

Feature Details

Feature	Reference
Execution Flow	See references/execution-flow.md
Smart Defaults	See references/smart-defaults.md
Generated Files	See references/generated-files.md

Optimized Flow

Before: Up to 11 dialogue rounds After: Minimum 1, maximum 2 dialogue rounds

Step 1: Unified question (1 time)
  ├─ What are you building?
  ├─ Who will use it?
  └─ Leave it to me or detailed settings?

Step 2: Confirmation (skip if "leave it to me")
  └─ Tech stack + project name

→ Execute setup (includes background analysis)

Step 3: Completion report

Arguments

Argument	Description	Example
[project description]	What to build	"EC site"
--mode	solo / 2agent	--mode=solo
--stack	Tech stack	--stack=next-supabase
--name	Project name	--name=my-app
--lang	Language	--lang=en

Smart Defaults

Item	Default	Auto-determination
Language	ja	Config file
Mode	Solo	2-Agent if .cursor/ exists
Tech stack	next-supabase	In auto mode
Skills Gate	Auto-configured	Adjust with /skills-update

Next Steps

After setup:

• "/plan-with-agent I want to create XXX" → Create plan
• "/work" → Execute tasks in Plans.md
• "npm run dev" → Start dev server
• If you need Codex CLI: run /setup codex