Enhance milestone descriptions template in /vision skill #30

New Issue

2026-01-04T11:57:41Z

HugoNijhuis commented

2026-01-04 11:57:41 +00:00

Context

Initial milestones created during Arcadia planning only had brief success criteria. They became much more useful after adding structured discovery context.

Problem / Observation

The vision-management skill doesn't guide users to create rich milestone descriptions. Sparse milestones like 'Success: User can X' don't provide enough context for planning issues.

Suggested Improvement

Update milestone creation guidance to include:

## Milestone Description Template

## Who
[User type this milestone serves]

## Goal
[What they're trying to accomplish]

## What Exists
- [Current capabilities]

## What's Missing
- [Gaps to fill]

## MVP
[Minimum to deliver value]

## Success Criteria
[How we know it's done]

Affected Files

skills/vision-management/SKILL.md

## Context Initial milestones created during Arcadia planning only had brief success criteria. They became much more useful after adding structured discovery context. ## Problem / Observation The vision-management skill doesn't guide users to create rich milestone descriptions. Sparse milestones like 'Success: User can X' don't provide enough context for planning issues. ## Suggested Improvement Update milestone creation guidance to include: ```markdown ## Milestone Description Template ## Who [User type this milestone serves] ## Goal [What they're trying to accomplish] ## What Exists - [Current capabilities] ## What's Missing - [Gaps to fill] ## MVP [Minimum to deliver value] ## Success Criteria [How we know it's done] ``` ## Affected Files - skills/vision-management/SKILL.md

HugoNijhuis added this to the Ensure consistent quality milestone 2026-01-04 11:57:41 +00:00

HugoNijhuis closed this issue

2026-05-12 11:09:27 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: flowmade-one/architecture#30