help

/help — Context-Aware Workflow Guidance (Thin Wrapper)

v2.0 Architecture: This command analyzes state inline for speed, with detailed rendering logic in the help-agent brief.

Active Feature: !ls -td specs/[0-9]*-* 2>/dev/null | head -1 || echo "none"

State Exists: !test -f "$(ls -td specs/[0-9]*-* 2>/dev/null | head -1)/state.yaml" 2>/dev/null && echo "yes" || echo "no"

Six Contexts (mutually exclusive):

1. no_feature - No specs/ directory, show getting started
2. no_state - Feature dir exists but state.yaml missing
3. blocked - Workflow failed, show recovery options
4. manual_gate - Waiting for approval, show checklist
5. complete - All phases done, show next feature options
6. active - In progress, show current phase and next steps

Architecture: Inline analysis for fast response. Agent brief at .claude/agents/phase/help-agent.md contains rendering templates.

Step 1: Detect Context

FEATURE_DIR=$(ls -td specs/[0-9]*-* 2>/dev/null | head -1)

if [ -z "$FEATURE_DIR" ]; then
    CONTEXT="no_feature"
elif [ ! -f "$FEATURE_DIR/state.yaml" ]; then
    CONTEXT="no_state"
else
    STATUS=$(yq eval '.workflow.status' "$FEATURE_DIR/state.yaml" 2>/dev/null || echo "unknown")
    PREVIEW=$(yq eval '.workflow.manual_gates.preview.status' "$FEATURE_DIR/state.yaml" 2>/dev/null || echo "null")
    STAGING=$(yq eval '.workflow.manual_gates.validate_staging.status' "$FEATURE_DIR/state.yaml" 2>/dev/null || echo "null")

    if [ "$STATUS" = "failed" ]; then
        CONTEXT="blocked"
    elif [ "$PREVIEW" = "pending" ] || [ "$STAGING" = "pending" ]; then
        CONTEXT="manual_gate"
    elif [ "$STATUS" = "completed" ]; then
        CONTEXT="complete"
    else
        CONTEXT="active"
    fi
fi

echo "Context: $CONTEXT"
echo "Feature: $FEATURE_DIR"

Step 2: Render Based on Context