Synopsis

aigon research-prioritise <topic-name or letter>

Shortcuts

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

Description

research-prioritise takes a research topic out of the inbox and gives it the ID it will carry through its entire lifecycle. It assigns the next available numeric ID, renames the spec file with the ID prefix, and moves it from 01-inbox/ to 02-backlog/ — ready to be started when you have capacity.

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

What it does

1. Finds the matching spec in docs/specs/research-topics/01-inbox/
2. Assigns the next available numeric ID
3. Renames the file from research-<slug>.md to research-<ID>-<slug>.md
4. Migrates any existing slug-keyed workflow state to the numeric key
5. Moves the spec to 02-backlog/ and commits the change

Examples

# Prioritise by topic name (partial match is fine)
aigon research-prioritise api-cache-invalidation
 
# Prioritise interactively — omit the name and pick from a list
aigon research-prioritise

Next steps

After prioritising, choose your research mode:

# Drive mode (single agent)
aigon research-start <ID>
 
# Fleet mode (multiple agents research in parallel)
aigon research-start <ID> cc gg cx

Related

• research-create — create the inbox topic (run before prioritise)
• research-start — begin research (run after prioritise)