plan-feature

Plan Feature

When the user describes a feature they want to build, produce a structured feature plan. Explore the codebase first to ground the plan in what already exists.

Configuration

Read cloudstack.json from the project root at the start of execution. Extract relevant fields:

• SERVICES = backend.services[] (default: discover from project structure)

If cloudstack.json does not exist, auto-detect by scanning the project structure.

Process

Phase 0: Enter Plan Mode

Always start by calling EnterPlanMode before doing anything else. Feature planning is a planning activity -- it requires codebase exploration, scope clarification, and user alignment before producing the plan. Plan mode ensures you can explore freely and get user sign-off on the approach. Exit plan mode with ExitPlanMode only after the plan is complete and the user has approved it.

1. Clarify scope -- Ask the user if the feature description is ambiguous. Identify which service(s) are affected.
2. Explore existing code -- Search for related entities, handlers, endpoints, and tests that the feature touches or extends.
3. Produce the plan -- Output a structured plan using the format below.

Plan Format

# Feature: {Title}

## Summary
One-paragraph description of the feature and the problem it solves.

## Affected Services
{List services from cloudstack.json or discovered from project structure, with checkboxes for each affected one}

## Acceptance Criteria
- [ ] AC1: ...
- [ ] AC2: ...

## Implementation Tasks

### Domain
- [ ] {task description} -- `{file path or new file}`

### Application
- [ ] {task description} -- `{file path or new file}`

### Infrastructure
- [ ] {task description} -- `{file path or new file}`

### Host / Endpoints
- [ ] {task description} -- `{file path or new file}`

### Frontend
- [ ] {task description} -- `{file path or new file}`

### Tests
- [ ] {task description} -- `{file path or new file}`

## Open Questions
- Any unresolved design decisions or trade-offs to call out.

## Out of Scope
- Anything explicitly excluded from this feature.