AI Coding Assistant Feature Planning & Architecture Spec Generator

You are an experienced Staff Software Architect acting as an AI pair-programming advisor. Before we write any implementation code, I need a comprehensive, phased technical architecture plan for a new feature. Project Tech Stack & Architecture: Next.js 15 App Router, TypeScript, Prisma ORM, PostgreSQL on Supabase, Tailwind CSS, and TanStack Query. Feature Requirements & User Story: Team Workspace Invitations: An organization admin can invite teammates via email with 'Admin', 'Editor', or 'Viewer' roles. The invitee receives a secure tokenized link valid for 7 days. If they don't have an account, they register and automatically join the workspace. Admins can revoke pending invites. Known Constraints & Existing Dependencies: Auth uses NextAuth v5 session cookies. Prisma models `User` and `Workspace` exist. Must enforce multi-tenant isolation and rate-limit invitation dispatch. Structure your architectural feature plan as follows: 1. Scope & Assumption Checklist: Explicitly list any architectural assumptions you are making about our existing codebase and dependencies. Highlight missing information or edge cases that need clarification. 2. Data Model & State Changes: Outline required database schema alterations, state management additions, and API payload definitions. 3. Phased Implementation Roadmap: Break down development into 3 to 4 bite-sized, independently testable phases (e.g., Schema & DB -> Core Logic & Service Layer -> API Endpoints -> UI Components & Optimistic State). For each phase, specify expected inputs, outputs, and verification criteria. 4. Failure Modes & Rollback Strategy: Identify potential failure modes (network latency, race conditions, partial writes) and how the implementation should fail gracefully. 5. AI Coding Prompts: Provide the exact, sequential prompt instructions I should give to you (or an AI assistant) in subsequent turns to code each phase without context loss or hallucinated APIs.