Synopsis

aigon feature-prioritise <feature-name or letter>

Shortcuts

• /afp (slash command) · aigon afp (CLI)

Description

feature-prioritise graduates a feature from the inbox to the backlog by assigning it the ID it will carry through its entire lifecycle. It renames the spec file with the numeric ID prefix, resolves any depends_on declarations to canonical IDs, checks for circular dependencies, and commits the move.

The name argument accepts partial matches — if you type dark, Aigon finds any inbox spec whose filename contains that string. If multiple match, it lists them and asks you to pick.

Always use this CLI command — never manually move or rename spec files. The CLI handles ID assignment, workflow state migration, and git housekeeping atomically.

What it does

1. Finds the matching spec in docs/specs/features/01-inbox/
2. Assigns the next available numeric ID
3. Renames the file to feature-<ID>-<slug>.md
4. Resolves depends_on declarations to canonical numeric IDs
5. Validates that no circular dependencies exist
6. Migrates any existing slug-keyed workflow state to the numeric key
7. Moves the spec to 02-backlog/ and commits the change

Examples

# Prioritise by partial name
aigon feature-prioritise dark-mode
 
# Prioritise interactively — list all inbox specs
aigon feature-prioritise

Next steps

After prioritising, choose your mode:

# Drive mode (branch in current repo)
aigon feature-start <ID>
 
# Drive worktree (isolated, parallel development)
aigon feature-start <ID> cc
 
# Fleet mode (multiple agents compete)
aigon feature-start <ID> cc gg cx

Related

• feature-create — create the inbox spec (run before prioritise)
• feature-start — create the workspace (run after prioritise)
• feature-rename — rename an inbox spec before it has been prioritised