The Super Wolf — Pack Coordination

A session chronicle of The Super Wolf — Pack Coordination.

Act I · Backlog

IDP Backlog Entry

FiremanDecko

ADd to backlog: setup a different IDP from google that'll make it easier for testing. Suggest IDP based on target audience.

Created backlog item on branch docs/backlog-idp-testing after analyzing target audience from product brief. Recommended Clerk as IDP — matches credit card churners (mainstream consumers, privacy-conscious, mobile-first). GitHub as initial social provider for dev testing, with path to add Google/Apple later.

✦ designs/product/backlog/idp-testing-alternative.md

Act II · Infrastructure

Dual-Port Worktree Foundation

FiremanDecko

[Phase 0: Build dual-port worktree infrastructure before launching teams]

Created backend-server.sh — parallel script to dev-server.sh. Frontend runs on 9653+offset, backend on 9753+offset (port = frontend + 100). Every worktree gets isolated frontend and backend servers with independent log files and environment overrides.

Updated all worktree docs to reflect dual-port model. Committed to feat/dual-port-worktrees branch and opened PR #26.

✦ .claude/scripts/backend-server.sh ◈ .claude/commands/create_worktree_prompt.md ◈ .claude/commands/dev-server.md ◈ .claude/commands/list_worktrees_prompt.md ◈ .claude/skills/worktree-manager-skill/REFERENCE.md

Act III · Coordination

Parallel Pack Launch

FiremanDecko

[Launch 3 teams in parallel: Team A (IDP/Clerk), Team B (Backend/WS), Team C (Luna wireframes)]

Spawned 3 agents in isolated worktrees simultaneously — FiremanDecko for Clerk investigation, FiremanDecko for backend/WebSocket architecture, Luna for multi-IDP wireframes. All three worked in parallel with no cross-contamination.

Provided GitHub OAuth setup instructions while teams ran in background: Clerk dashboard → Social Connections → GitHub, copy client ID/secret from GitHub OAuth app settings.

Act IV · Design

Luna's Multi-IDP Wireframes

Luna

[Team C completed first]

Luna delivered multi-idp-sign-in.html (4 scenarios: desktop/mobile × 1-button/4-button variants) and multi-idp-interaction-spec.md with full state machine diagrams. Modal dialog, not a page — vertical button stack scales from 1 to 4+ providers. Bottom-anchored on mobile, no close button (one exit: "Continue without signing in"), backdrop click disabled.

✦ designs/ux-design/wireframes/multi-idp-sign-in.html ✦ designs/ux-design/multi-idp-interaction-spec.md

Act V · Investigation

Backend WebSocket Investigation

FiremanDecko

[Team B completed]

FiremanDecko produced ADR evaluating 5 backend options — recommended Hono + ws dedicated server on Fly.io. API route audit: POST /api/auth/token (~200ms) stays in Next.js, POST /api/sheets/import (5-30s+) migrates to backend with WebSocket progress streaming. 4-phase rollout plan with file-by-file change list and Mermaid diagrams.

✦ designs/architecture/adr-backend-server.md ✦ designs/architecture/backend-implementation-plan.md

Act VI · Architecture

Clerk Auth Architecture

FiremanDecko

[Team A completed — PR #27 opened]

FiremanDecko delivered ADR-007 — Clerk as auth platform, GitHub initial provider. 5-phase implementation plan: clerkMiddleware() replaces no-op middleware (all routes stay public, no auth gates), householdId contract unchanged (anonymous UUID from localStorage or Clerk user.id when signed in), FenrirSession type removed. Playwright testing via @clerk/testing — Testing Tokens bypass OAuth in CI entirely.

✦ designs/architecture/adr-clerk-auth.md ✦ designs/architecture/clerk-implementation-plan.md

Act VII · Validation

Loki's Validation — Both Teams

FiremanDecko

[Launched 2 Loki agents in parallel to validate Team A and Team B outputs]

Loki QA for Team A (Clerk): APPROVED WITH NOTES (10/10 checks PASS). 3 non-blocking notes: JSDoc still references "Google sub claim", document Clerk Testing Token lifetime, product brief update deferred correctly.

Loki QA for Team B (Backend/WS): APPROVED (8/8 checks PASS). 3 minor notes: SSE prototype vs evaluation acceptable, cost estimate excludes egress, Anthropic streaming deferred intentionally.

✦ designs/architecture/clerk-auth-qa-report.md ✦ designs/architecture/backend-ws-qa-report.md

Act VIII · Delivery

The Great Merge

FiremanDecko

Merge the PR for Phase 0 — Dual-port infra

Merged PR #26 (dual-port worktree infra — already merged by user). Merged PR #27 (Clerk ADR + implementation plan). Merged PR #25 (backlog items for IDP + Backend/WS). Cleaned up stale worktree branch (backend docs were already on main via PR #26).

Act IX · Completion

Final Luna Wireframe PR

FiremanDecko

create a PR on the wireframe branch, sync up to master then merge it

Rebased Luna's worktree branch onto latest main (clean rebase — 1 commit on top). Created PR #28: "design: multi-IDP sign-in dialog wireframe and interaction spec". Merged immediately. All 4 PRs now on main — the pack's work is complete.

✦ PR #28 merged