Project Init Wizard

Run on setup requests and context-recovery requests such as "Setup project", "Initialize context", "Generate CONTEXT.md", or "CONTEXT.md was deleted".

Core Rules

Do not run blindly. Trigger only for setup intent or missing/incomplete context recovery intent.
Ask one question at a time.
Analyze local files before asking setup questions.
Do not re-ask values that are already inferred with high confidence.
If first user message is non-English, ask one language confirmation question before any other setup question.
If
```
.agents/CONTEXT.md
```
has checklist and
```
CONTEXT_READY
```
is checked, skip analysis and only confirm whether updates are needed.

Hard Trigger Policy

Trigger

project-init

with high priority when one of these is true:

User explicitly asks setup/init/context generation.
User says
```
.agents/CONTEXT.md
```
is missing, deleted, empty, outdated, or needs regeneration.
User asks to remap skills from scratch for the project.

Do not stay only in

global-config

when the request matches this policy.

Workflow

Step 0: Conversation Language

Ask this only if first user message is non-English. This must be the first setup prompt.

text

O'zbekcha davom etamizmi?

1) Ha
2) Yo'q (English)
3) Boshqa til

Fallback template for other non-English languages:

text

Use {detected_language} for this setup conversation?

1) Yes
2) No (English)
3) Other language

If answer is

, ask:

Qaysi tilda davom etamiz?

(or

Which language?

if user replies in English).

Step A: Quick Analysis and Confirmation

Scan and summarize:

```
.agents/CONTEXT.md
```
```
package.json
```
```
tsconfig.json
```
```
vite.config.*
```
```
next.config.*
```
```
nest-cli.json
```

Ask:

text

Here is the quick analysis summary. Continue with this direction or adjust it?

1) Continue
2) I want changes

, apply user corrections first. If

, continue.

Step B: Ask Only Missing Inputs

Collect only unresolved fields from this question bank:

Field	Options
Project Name	text
Project Type	SaaS, E-commerce, Admin Dashboard, Landing Page, API Backend, Mobile App, Portfolio/Blog, Other
Frontend Framework	Next.js, Vite + React, Remix, None
TypeScript	Yes, No
UI Library	Tailwind, shadcn + Tailwind, MUI, Ant Design, None
State Management	TanStack Query, Zustand, Redux Toolkit, TanStack + Zustand, None
Backend	NestJS, Express, Next.js API Routes, Hono, None
Database	PostgreSQL, MySQL, MongoDB, SQLite, Supabase, None
ORM	Prisma, Drizzle, TypeORM, None
Package Manager	pnpm, npm, yarn, bun

Output Contract

Generate

.agents/CONTEXT.md

with this structure:

markdown

# {PROJECT_NAME} - Project Context

> Auto-generated by project-init wizard

## Context Checklist (for agents)
- [ ] CONTEXT_READY
- [ ] STACK_CONFIRMED
- [ ] STRUCTURE_CONFIRMED
- [ ] COMMANDS_CONFIRMED
- [ ] SKILLS_MAPPED
- [ ] NOTES_CONFIRMED
- [ ] LOCAL_SKILLS_SYNCED

## Tech Stack
| Category | Technology |
|----------|------------|
| Framework | {FRAMEWORK} |
| Language | {LANGUAGE} |
| Styling | {UI_LIBRARY} |
| State | {STATE_MANAGEMENT} |
| Backend | {BACKEND} |
| Database | {DATABASE} |
| ORM | {ORM} |
| Package Manager | {PACKAGE_MANAGER} |

## Skills
- Core: `global-config`, `errors`, `git`, `solid`
- Frontend: {FRONTEND_SKILLS}
- Backend: {BACKEND_SKILLS}
- Data: {DATA_SKILLS}
- State: {STATE_SKILLS}
- UI: {UI_SKILLS}
- Testing: {TESTING_SKILLS}

## Project Structure
{PROJECT_STRUCTURE}

## Coding Rules
- Components: Keep focused and small
- TypeScript: Strict mode, avoid `any`
- Commits: Conventional Commit format
- Naming: PascalCase components, camelCase utilities

## Commands
# pnpm
pnpm dev
pnpm build
pnpm lint
pnpm test

# npm
npm run dev
npm run build
npm run lint
npm run test

# yarn
yarn dev
yarn build
yarn lint
yarn test

# bun
bun run dev
bun run build
bun run lint
bun run test

Skill Mapping Rules

Frontend:
```
nextjs
```
->
```
react-core
```
,
```
react-nextjs
```
```
vite
```
->
```
react-core
```
,
```
react-vite
```
```
remix
```
->
```
react-core
```
TypeScript:
```
yes
```
->
```
typescript
```
UI:
```
tailwind
```
->
```
tailwind
```
```
shadcn
```
->
```
shadcn
```
,
```
tailwind
```
```
mui
```
or
```
ant-design
```
->
```
design
```
State:
```
tanstack
```
->
```
tanstack-query
```
```
zustand
```
->
```
zustand
```
```
redux
```
->
```
redux
```
Backend:
```
nestjs
```
->
```
nestjs
```
,
```
api-patterns
```
,
```
security
```
```
express
```
or
```
next-api
```
or
```
hono
```
->
```
api-patterns
```
,
```
security
```
Forms:
if required ->
```
forms
```
Testing:
if planned ->
```
testing
```
Any project:
always include
```
git
```
,
```
solid
```
,
```
errors
```
,
```
global-config
```

References

For complete legacy question flow and examples:
```
references/guide.md
```

project-init

NPX Install

Tags

SKILL.md Content

Project Init Wizard

Core Rules

Hard Trigger Policy

Workflow

Step 0: Conversation Language

Step A: Quick Analysis and Confirmation

Step B: Ask Only Missing Inputs

Output Contract

Skill Mapping Rules

References