---
name: "Interactive onboarding guides user through project setup after init"
---

# Story 148: Interactive onboarding guides user through project setup after init

## User Story

As a new Story Kit user, after the project structure has been scaffolded, I want a guided conversation that asks me about my project goals and tech stack, so that the specs are populated and I'm ready to write Story #1.

## Acceptance Criteria

- [ ] After scaffold completes and the user opens the chat UI, the agent detects empty/template specs and enters onboarding mode
- [ ] The agent asks the user what the project is about (goal, domain) and writes a populated specs/00_CONTEXT.md based on their answers
- [ ] The agent asks the user what tech stack they want (language, framework, build tools, test runner, linter) and writes a populated specs/tech/STACK.md based on their answers
- [ ] The agent updates script/test to invoke the project's actual test runner (e.g. cargo test, pytest, pnpm test)
- [ ] The agent updates project.toml component setup commands to match the chosen stack (e.g. pnpm install for a JS project, cargo check for Rust)
- [ ] After onboarding completes, the agent commits the populated specs and tells the user they're ready for Story #1

## Out of Scope

- TBD
