prospectar-direcao

Invoca o agente direction-prospector que aplica a skill leverage-scoring — cada sugestão carrega evidence (file:line ou commit), impact, effort, confidence e o leverage derivado, ordenadas pela fórmula Leverage = (Impact / Effort) × Confidence.

Cria/Atualiza:

• DIRECTION.md (default .planning/DIRECTION.md) — 4-6 sugestões priorizadas com evidência

Após: o user tem uma carteira acionável. Cada sugestão pode ser:

• promovida a backlog via /adicionar-backlog "<sugestão>" (estaciona em 999.x sem comprometer)
• adotada como objetivo do milestone via /novo-marco "<sugestão>" (vira o foco ativo)

Exemplos:

/prospectar-direcao                                  # raiz atual, output default
/prospectar-direcao .                                # explícito
/prospectar-direcao ./apps/web                       # sub-projeto monorepo
/prospectar-direcao . --output .planning/NEXT.md     # output custom

Quando este comando é o caminho:

• O milestone atual fechou e o próximo objetivo está "A definir" — você não sabe o que atacar
• /novo-marco foi disparado sem nome e você quer candidatos com evidência antes de comprometer
• Acúmulo de TODOs/débito/gaps e você quer uma leitura priorizada do que rende mais
• Antes de uma sessão de planejamento de roadmap, para ancorar a discussão em sinais reais

Pré-requisitos:

• .planning/ existe (STATE.md, ROADMAP.md ajudam o sinal; o agente degrada se ausentes)
• Repositório git inicializado (git log é uma das fontes de sinal)

1. Parsear argumentos

PROJECT_ROOT=$(echo "$ARGUMENTS" | awk '{print $1}')
OUTPUT_PATH=$(echo "$ARGUMENTS" | grep -oE -- '--output [^ ]+' | awk '{print $2}')

# se o primeiro token for uma flag, não é project_root
case "$PROJECT_ROOT" in
  --*) PROJECT_ROOT="" ;;
esac

[ -z "$PROJECT_ROOT" ] && PROJECT_ROOT="."
[ -z "$OUTPUT_PATH" ]  && OUTPUT_PATH=".planning/DIRECTION.md"

if [ ! -d "$PROJECT_ROOT" ]; then
  echo "ERROR: project_root não encontrado: $PROJECT_ROOT"
  exit 1
fi

mkdir -p "$(dirname "$OUTPUT_PATH")"