start-scout-app

name	start-scout-app
description	Start odin-scout-ent locally via run-local.sh. Use when the user asks to start, run, or restart Scout.

Start Scout App

Use this skill to start Scout locally with the same checks and defaults enforced by run-local.sh.

Trigger

Activate this skill whenever:

• The user asks to start/run/restart Scout locally
• The user asks to bring up only Scout (not both services)
• You need to relaunch Scout after a local change

Workflow

Step 1: Confirm Prerequisites

Before starting Scout, verify prerequisites with the user:

• OAM is running locally on localhost:9006 (start from odin-account-manager-ent/run-local.sh if needed)
• Java 21 is installed
• Ask the user which AWS profile to use. If no profile is provided, use central.
• AWS auth is valid for the chosen profile

Step 2: Start Scout

Run:

AWS_PROFILE="${AWS_PROFILE:-central}"
export AWS_PROFILE

# Resolve repo root from cwd + known skill location.
if [ -d ".cursor/skills/start-scout-app" ] && [ -f "run-local.sh" ]; then
  REPO_ROOT="$PWD"
elif [ -d "odin-scout-ent/.cursor/skills/start-scout-app" ] && [ -f "odin-scout-ent/run-local.sh" ]; then
  REPO_ROOT="$PWD/odin-scout-ent"
else
  REPO_ROOT="$(realpath "$(dirname "$(realpath .cursor/skills/start-scout-app/SKILL.md)")/../../..")"
fi

cd "$REPO_ROOT"
./run-local.sh

The script enforces local defaults and then starts Spring Boot with local profile.

Step 3: Validate Startup

Watch terminal output for:

• Starting Scout (HTTP on port 8080, OAM gRPC at localhost:9006)...
• AWS context line with profile and region
• Spring Boot startup completion with HTTP listening on port 8080

Step 4: Report Result

If startup succeeds, report Scout is running and suggest:

if [ -f "./run-onboarding-status-apis.sh" ]; then
  ./run-onboarding-status-apis.sh
elif [ -f "odin-scout-ent/run-onboarding-status-apis.sh" ]; then
  (cd odin-scout-ent && ./run-onboarding-status-apis.sh)
else
  echo "Could not find run-onboarding-status-apis.sh from current directory."
fi

If startup fails, report the exact error and recommended fix from the failure handling table below.

Failure Handling

Failure	What it means	Fix
ERROR: AWS auth failed for profile '...'	AWS session is missing/expired for selected profile	aws sso login --profile <profile> and rerun
ERROR: Java 21 is required but not found on this machine.	Java 21 is not available	Install Java 21 and ensure /usr/libexec/java_home -v 21 resolves
OAM calls fail after startup	Scout started but OAM is not reachable on localhost:9006	Start OAM first, then rerun Scout

Notes

• run-local.sh defaults:
  • AWS_PROFILE=central
  • AWS_REGION=us-east-1
  • AWS_DEFAULT_REGION follows AWS_REGION
  • AWS_SDK_LOAD_CONFIG=1
  • SKIP_ASSUME_ROLE=true
  • AWS_MOCK_MUTATIONS=true
• The script clears stale AWS env credentials before startup.
• Scout runs with --spring.profiles.active=local.