# Alto Feature Setup

> Use when starting a new feature - running /alto-feature-setup, updating objective.md, or running alto-new-run. Interactive workflow for feature initialization.

- Skill: `diegosouzapw/alto-feature-setup` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/alto-feature-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/alto-feature-setup/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/alto-feature-setup

---


# ALTO Feature Setup

Interactive skill for starting a new feature.

## Flow

### 1. Analyze Current State

First, invoke `alto-feature-finder` agent to understand:
- What features are completed
- What's currently in progress
- What should be next

```
Use the alto-feature-finder agent to analyze the project
```

### 2. Mark Previous Feature Complete (if needed)

If there's a completed feature that hasn't been marked done:

- Update `objective.md`:
  - Mark Definition of Done items as `[x]`
  - Add completion note: `**Completed:** run/NNN (YYYY-MM-DD)`

### 3. Discuss New Feature

Have a conversation with the user:
- What feature to work on next?
- Any clarifications on scope?
- Any constraints or preferences?

Then update `objective.md` with the feature definition:
- Goal statement
- Requirements (numbered: N.1, N.2, etc.)
- Definition of Done (checkboxes)

### 4. Run Mechanical Setup

Tell the user to run:

```bash
# Clean previous artifacts
alto-clean

# Create new run branch
alto-new-run
```

Or they can do it manually if they prefer different branch naming.

### 5. Handoff

Tell user:

> Feature setup complete. Run `claude` in a new terminal.
> Say "continue" to start the architecture phase.

---

## Devenv Scripts Reference

| Script | Purpose |
|--------|---------|
| `alto-setup` | First-time project initialization |
| `alto-feature` | Quick reminder of this flow |
| `alto-new-run` | Create run branch, reset state |
| `alto-clean` | Clean previous run artifacts |
| `alto-status` | Show current ALTO status |

## Notes

- This skill is INTERACTIVE - follow it WITH the user
- Use `alto-feature-finder` agent for codebase analysis
- Mechanical tasks are scripts, not manual commands
- After setup, user starts NEW session for autonomous work