---
name: "Interactive project setup wizard for new huskies projects"
agent: coder-opus
---

# Story 429: Interactive project setup wizard for new huskies projects

## User Story

As a developer adopting huskies on an existing project, I want a guided setup process that scaffolds the .huskies directory and has an agent generate project-specific configuration files, so that I can get up and running without manually writing specs and scripts.

## Acceptance Criteria

- [ ] huskies init scaffolds .huskies/ directory structure, project.toml, and .mcp.json without clobbering any existing files (especially CLAUDE.md)
- [ ] Setup wizard tracks progress through ordered steps, resumable if interrupted
- [ ] Step 1: scaffold .huskies/ directory structure and project.toml
- [ ] Step 2: agent reads codebase and generates specs/00_CONTEXT.md, user confirms or requests revision
- [ ] Step 3: agent reads tech stack and generates specs/tech/STACK.md, user confirms or requests revision
- [ ] Step 4: agent creates script/test that runs the project's actual test suite, user runs it to verify, then confirms
- [ ] Step 5: agent creates script/release tailored to the project's deployment, user confirms
- [ ] Step 6: agent creates script/test_coverage if the stack supports it, user confirms
- [ ] Each step gates on user confirmation before advancing to the next
- [ ] Existing CLAUDE.md is preserved — huskies appends its content or leaves it untouched

## Out of Scope

- TBD
