decisions

SpecSwarm Decision Pre-Batching

The biggest Marty-time reducer in the v7.x toolchain. Mid-chunk strategic-decision interrupts cost ~15–25 interactions across /ss:tasks + /ss:implement. This command collapses them into ONE front-loaded touchpoint by:

1. Deterministically scanning plan.md for candidate decisions
2. Dispatching the decision-miner subagent to dedup/prioritize/polish into 0–8 well-formed questions
3. Asking Marty all of them via 1-2 AskUserQuestion calls (4-question limit per call)
4. Writing decision-sheet.md (canonical record + provenance)
5. Appending a "Pre-Batched Decisions" section to plan.md so /ss:tasks and /ss:implement see the answers without code changes

After this command runs successfully, the chunk should execute autonomously through /ss:tasks → /ss:implement with minimal further interrupts (only true edge cases the miner missed).

Phase 1: Resolve feature

PLUGIN_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
# shellcheck disable=SC1091
source "${PLUGIN_DIR}/lib/features-location.sh"
# shellcheck disable=SC1091
source "${PLUGIN_DIR}/lib/decisions/scan-plan.sh"
# shellcheck disable=SC1091
[ -f "${PLUGIN_DIR}/lib/notify.sh" ] && source "${PLUGIN_DIR}/lib/notify.sh"

FEATURE_NUM=""
SCAN_ONLY=false
DRY_RUN=false

while [ $# -gt 0 ]; do
  case "$1" in
    --scan-only) SCAN_ONLY=true; shift ;;
    --dry-run)   DRY_RUN=true;   shift ;;
    -h|--help)
      cat <<EOF
Usage: /ss:decisions [FEATURE_NUM] [options]

Pre-batch strategic decisions for a feature.

Options:
  --scan-only   Print deterministic candidates only (no agent, no questions)
  --dry-run     Scan + agent (writes decision-sheet.draft.md); skip questions + plan.md mutation

Examples:
  /ss:decisions
  /ss:decisions 002
  /ss:decisions --scan-only
  /ss:decisions --dry-run
EOF
      exit 0
      ;;
    *)
      if [ -z "$FEATURE_NUM" ]; then FEATURE_NUM="$1"; fi
      shift
      ;;
  esac
done

REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)

# Resolve feature (same cascade as /ss:retrospective)
if [ -z "$FEATURE_NUM" ]; then
  BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
  FEATURE_NUM=$(echo "$BRANCH" | grep -oE '^[0-9]{3}' || echo "")
fi
if [ -z "$FEATURE_NUM" ]; then
  get_features_dir "$REPO_ROOT"
  FEATURE_NUM=$(find "$FEATURES_DIR" -maxdepth 1 -type d -name '[0-9][0-9][0-9]-*' 2>/dev/null \
    | sort | tail -1 | xargs -n1 basename 2>/dev/null \
    | grep -oE '^[0-9]{3}' || echo "")
fi
if [ -z "$FEATURE_NUM" ]; then
  echo "❌ No feature number provided and no feature dirs found." >&2
  exit 2
fi
if ! find_feature_dir "$FEATURE_NUM" "$REPO_ROOT"; then
  echo "❌ Feature $FEATURE_NUM not found." >&2
  exit 2
fi
FEATURE_ID=$(basename "$FEATURE_DIR")
PLAN_PATH="${FEATURE_DIR}/plan.md"

if [ ! -f "$PLAN_PATH" ]; then
  echo "❌ plan.md not found at $PLAN_PATH. Run /ss:plan first." >&2
  exit 2
fi

FOUNDATION="${REPO_ROOT}/.specswarm"
TECH_STACK="${FOUNDATION}/tech-stack.md"
CONSTITUTION="${FOUNDATION}/constitution.md"
QUALITY_STANDARDS="${FOUNDATION}/quality-standards.md"

echo "🔍 Decisions for $FEATURE_ID"
echo "  plan.md:          $PLAN_PATH"
echo "  tech-stack.md:    $([ -f "$TECH_STACK" ] && echo "$TECH_STACK" || echo "(absent — version-anchor check skipped)")"
echo "  constitution:     $([ -f "$CONSTITUTION" ] && echo "$CONSTITUTION" || echo "(absent — constitution callout check skipped)")"
echo "  quality-standards:$([ -f "$QUALITY_STANDARDS" ] && echo " $QUALITY_STANDARDS" || echo " (absent — prior-commitments check skipped)")"
echo ""