feat: scaffold next-postgres-shadcn full stack developer harness

.claude/hooks/notify_slack.sh

@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+# Get script directory for fallback env path
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Prefer global env file, fall back to repo-local .claude/.env.claude
+PREFERRED_ENV_PATH="$HOME/.env/.claude/.env.claude"
+FALLBACK_ENV_PATH="$(dirname "$SCRIPT_DIR")/.env.claude"
+
+if [[ -f "$PREFERRED_ENV_PATH" ]]; then
+    DOTENV_PATH="$PREFERRED_ENV_PATH"
+else
+    DOTENV_PATH="$FALLBACK_ENV_PATH"
+fi
+
+# Load env file if it exists
+if [[ -f "$DOTENV_PATH" ]]; then
+    # Export variables from env file (handles quoted values and comments)
+    set -a
+    # shellcheck disable=SC1090
+    source "$DOTENV_PATH"
+    set +a
+    echo "Loaded env from: $DOTENV_PATH" >&2
+else
+    echo "No env file found at $PREFERRED_ENV_PATH or $FALLBACK_ENV_PATH" >&2
+fi
+
+# Check for SLACK_WEBHOOK_URL
+if [[ -z "${SLACK_WEBHOOK_URL:-}" ]]; then
+    echo "SLACK_WEBHOOK_URL is not set" >&2
+    exit 1
+fi
+
+# Read input JSON from stdin
+INPUT_JSON=$(cat)
+
+if [[ -z "$INPUT_JSON" ]]; then
+    echo "Failed to read input from stdin" >&2
+    exit 1
+fi
+
+# Parse JSON fields using jq
+EVENT=$(echo "$INPUT_JSON" | jq -r '.hook_event_name // ""')
+CWD=$(echo "$INPUT_JSON" | jq -r '.cwd // ""')
+SESSION_ID=$(echo "$INPUT_JSON" | jq -r '.session_id // ""')
+
+# Get current timestamp
+TIMESTAMP=$(date '+%Y-%m-%d %H:%M:%S')
+
+# Function to extract final response from transcript JSONL file
+get_final_response() {
+    local transcript_path="$1"
+    local max_length="${2:-1500}"
+
+    # Expand ~ in path
+    transcript_path="${transcript_path/#\~/$HOME}"
+
+    if [[ -z "$transcript_path" || ! -f "$transcript_path" ]]; then
+        echo "(transcript not found)"
+        return
+    fi
+
+    # Extract final assistant response from JSONL
+    # Look for entries with type=assistant and extract text content
+    local final_response=""
+    final_response=$(jq -rs '
+        [.[] | select(.type == "assistant" and .message.role == "assistant" and .message.content)]
+        | last
+        | .message.content
+        | if type == "array" then
+            [.[] | if type == "object" and .type == "text" then .text elif type == "string" then . else empty end]
+            | join("\n")
+          elif type == "string" then
+            .
+          else
+            ""
+          end
+        // ""
+    ' "$transcript_path" 2>/dev/null || echo "")
+
+    if [[ -z "$final_response" ]]; then
+        echo "(no response found)"
+        return
+    fi
+
+    # Truncate if too long
+    if [[ ${#final_response} -gt $max_length ]]; then
+        echo "${final_response:0:$max_length}...
+_(truncated)_"
+    else
+        echo "$final_response"
+    fi
+}
+
+# Build Slack message based on event type
+TEXT=""
+case "$EVENT" in
+    "Notification")
+        NOTIFICATION_TYPE=$(echo "$INPUT_JSON" | jq -r '.notification_type // ""')
+        MESSAGE=$(echo "$INPUT_JSON" | jq -r '.message // ""')
+        TEXT="🧠 Claude Code: *${NOTIFICATION_TYPE}*
+${MESSAGE}
+• time: \`${TIMESTAMP}\`
+• cwd: \`${CWD}\`
+• session: \`${SESSION_ID}\`"
+        ;;
+    "Stop")
+        STOP_HOOK_ACTIVE=$(echo "$INPUT_JSON" | jq -r '.stop_hook_active // false')
+        TRANSCRIPT_PATH=$(echo "$INPUT_JSON" | jq -r '.transcript_path // ""')
+        FINAL_RESPONSE=$(get_final_response "$TRANSCRIPT_PATH")
+        TEXT="✅ Claude Code: *Stop*
+• time: \`${TIMESTAMP}\`
+• cwd: \`${CWD}\`
+• session: \`${SESSION_ID}\`
+• stop_hook_active: \`${STOP_HOOK_ACTIVE}\`
+
+*Final Response:*
+\`\`\`
+${FINAL_RESPONSE}
+\`\`\`"
+        ;;
+    *)
+        TEXT="Claude Code hook: ${EVENT}
+• time: \`${TIMESTAMP}\`
+• cwd: ${CWD}
+• session: ${SESSION_ID}"
+        ;;
+esac
+
+# Build Slack payload
+SLACK_PAYLOAD=$(jq -n --arg text "$TEXT" '{"text": $text}')
+
+# Send to Slack
+HTTP_RESPONSE=$(curl -s -w "\n%{http_code}" \
+    -X POST "$SLACK_WEBHOOK_URL" \
+    -H "Content-Type: application/json" \
+    -d "$SLACK_PAYLOAD" \
+    --max-time 10 \
+    2>&1) || {
+    echo "Failed to send Slack notification: curl error" >&2
+    exit 1
+}
+
+# Extract HTTP status code (last line)
+HTTP_CODE=$(echo "$HTTP_RESPONSE" | tail -n1)
+
+# Check for success (2xx status codes)
+if [[ ! "$HTTP_CODE" =~ ^2[0-9][0-9]$ ]]; then
+    RESPONSE_BODY=$(echo "$HTTP_RESPONSE" | sed '$d')
+    echo "Failed to send Slack notification: HTTP $HTTP_CODE - $RESPONSE_BODY" >&2
+    exit 1
+fi

.claude/plans/agile-waddling-pixel.md

@@ -0,0 +1,63 @@
+# Plan: Root-Level CLAUDE.md and AGENTS.md
+
+## Context
+
+The project has a `workspace/` folder that serves as the template for all agent sandboxes, but the project root has no CLAUDE.md or AGENTS.md. The root-level Claude Code instance currently has no instructions defining its role. We need root-level files that clearly scope the orchestrator's purpose: managing sandboxed agents via `.worktrees/`, not writing application code.
+
+Additionally, the Makefile and `.gitignore` still reference `worktrees/` (no dot) while the actual directory on disk is `.worktrees/`. This needs to be reconciled.
+
+## Changes
+
+### 1. Create `/home/ryaneggz/ruska-ai/sandboxes/AGENTS.md` (new file)
+
+The canonical root instruction file. Content defines:
+
+- **Identity**: You are the harness orchestrator, not a coding agent
+- **Permissions**: Git-only operations (per `.claude/settings.local.json`)
+- **Lifecycle** with three phases:
+  - **Setup**: Create GitHub issue → `make NAME=X quickstart` → `make NAME=X shell` → start agent
+  - **Validate**: `make list` to check running sandboxes, `make NAME=X shell` to verify workspace files exist (`AGENTS.md`, `SOUL.md`, `MEMORY.md`), `make NAME=X heartbeat-status` for heartbeat health
+  - **Teardown**: Commit/push any unmerged work → `make NAME=X stop` → `make NAME=X clean`
+- **Git workflow**: Branch conventions (`agent/<name>` from `development`), commit format, PR targets
+- **Project structure**: Brief map pointing to key directories
+- **Boundary**: All coding/building/testing happens inside sandboxes, never at root
+
+### 2. Create `/home/ryaneggz/ruska-ai/sandboxes/CLAUDE.md` as symlink → `AGENTS.md`
+
+Matches the `workspace/` convention where `CLAUDE.md` symlinks to `AGENTS.md`.
+
+```bash
+cd /home/ryaneggz/ruska-ai/sandboxes && ln -s AGENTS.md CLAUDE.md
+```
+
+### 3. Update Makefile: `worktrees/` → `.worktrees/`
+
+Line 16: Change `WORKTREE = worktrees/$(NAME)` → `WORKTREE = .worktrees/$(NAME)`
+
+### 4. Update `.gitignore`: `worktrees/` → `.worktrees/`
+
+```
+worktrees/*          →  .worktrees/*
+!worktrees/.gitkeep  →  !.worktrees/.gitkeep
+```
+
+### 5. Track `.worktrees/.gitkeep`
+
+Ensure `.worktrees/.gitkeep` exists and is tracked (replacing the deleted `worktrees/.gitkeep`).
+
+## Files to Modify
+
+| File | Action |
+|------|--------|
+| `AGENTS.md` | Create (new) |
+| `CLAUDE.md` | Create symlink → `AGENTS.md` |
+| `Makefile` | Edit line 16: `worktrees/` → `.worktrees/` |
+| `.gitignore` | Edit: `worktrees/` → `.worktrees/` |
+| `.worktrees/.gitkeep` | Ensure exists and tracked |
+
+## Verification
+
+1. `cat CLAUDE.md` resolves through symlink and shows AGENTS.md content
+2. `make list` still works (references `.worktrees/` correctly)
+3. `git status` shows the new files staged cleanly
+4. `.worktrees/` contents are still gitignored (except `.gitkeep`)