discuss-milestone-goallisted
Install: claude install-skill uHappyLogic/cairn
# discuss-milestone-goal
Facilitates a structured conversation to sharpen a vague or incomplete milestone goal into a clear, actionable statement ready for `/define-milestone-goal`. The output is a refined goal description — not a document yet: this skill is purely conversational, creates no files, and assigns no milestone number (that is the user's decision).
## Usage
```
/discuss-milestone-goal <overall_goal_description>
```
- `<overall_goal_description>`: a free-form description of what you want the milestone to accomplish.
**Example:**
```
/discuss-milestone-goal add a getting-started guide that walks a new user through their first session
```
## Workflow
### 1. Read project context
Read `CLAUDE.md` to understand the current milestone, the project's domain context, and project overview. Read `milestones/README.md` to understand what has already been built in past milestones. This grounds all questions in the real project state.
### 2. Analyze the goal
Identify what is clear, what is ambiguous, and what is missing. Look for:
- **Scope ambiguity** — what exactly is in vs. out?
- **Dependency gaps** — does this assume systems that don't exist yet?
- **Success criteria** — how would you know the milestone is done?
- **Conflicts** — does anything in the goal conflict with the current architecture or existing milestones?
### 3. Open with a crisp framing
Restate the goal in one sentence to show you understood it. Then immediately surface the most important ambiguiti