propose

/fractal:propose

Human gates

Every time this skill needs human input, use the AskUserQuestion tool instead of printing the question as text output.

Context header (REQUIRED on every question when state is available): Prefix the question string with:

📍 | 🎯 <active_predicate (max 80 chars)>

Variables come from the pre-loaded State section. If state is not yet loaded (e.g., early steps before tree detection), omit the header.

IMPORTANT: The header must be plain text. No markdown formatting (no **, ##, *, etc.) in the question string. Emojis are fine as visual anchors.

Input: $ARGUMENTS — predicate text in natural language, or empty to enter analyze mode.

---

Step 1: Route on arguments

If $ARGUMENTS IS provided

Use it directly as the predicate text. Skip to Step 2 (Reframe).

---

If $ARGUMENTS is empty — ANALYZE MODE

Enter analyze mode. This evaluates the active predicate and proposes the next sub-predicate.

Step A: Detect tree

REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
FRACTAL_DIR="$REPO_ROOT/.fractal"
TREES=()
for d in "$FRACTAL_DIR"/*/; do [ -f "${d}root.md" ] && TREES+=("$d"); done
if [ "${#TREES[@]}" -eq 1 ]; then
  TREE_DIR="${TREES[0]}"
elif [ "${#TREES[@]}" -gt 1 ]; then
  # Multiple trees — ask user which to use via AskUserQuestion
  echo "multiple_trees: true"
  for t in "${TREES[@]}"; do echo "tree: $(basename "$t")"; done
fi

If no tree found: STOP with message "Nenhuma árvore fractal encontrada. Execute /fractal:init primeiro."

If multiple trees found: ask the user which tree to work with via AskUserQuestion.

ROOT_MD="${TREE_DIR}root.md"
ACTIVE_NODE=$(grep "^active_node:" "$ROOT_MD" | sed 's/^active_node:[[:space:]]*//' | tr -d '"')
FRACTAL_SCRIPTS=$(ls -d ~/.claude/plugins/cache/fractal/fractal/*/scripts 2>/dev/null | tail -1)
[ -z "$FRACTAL_SCRIPTS" ] && FRACTAL_SCRIPTS="$REPO_ROOT/scripts"
bash "$FRACTAL_SCRIPTS/fractal-state.sh"