popeye-cli 1.2.0 → 1.3.0

package/.env.example

@@ -14,7 +14,7 @@ POPEYE_GEMINI_KEY=
 POPEYE_GROK_KEY=
 
 # Default output language for generated projects
-# Options: python, typescript, fullstack
+# Options: python/be (backend), typescript/fe (frontend), fullstack/fs, website/web, all
 POPEYE_DEFAULT_LANGUAGE=python
 
 # Default OpenAI model for consensus reviews
@@ -28,6 +28,9 @@ POPEYE_GEMINI_MODEL=gemini-2.0-flash
 # Common models: grok-3, grok-2
 POPEYE_GROK_MODEL=grok-3
 
+# Grok API URL (optional, defaults to https://api.x.ai/v1)
+# POPEYE_GROK_API_URL=https://api.x.ai/v1
+
 # Consensus reviewer provider
 # Options: openai, gemini, grok
 POPEYE_CONSENSUS_REVIEWER=openai

package/CONTRIBUTING.md

@@ -188,8 +188,18 @@ src/
 ├── state/         # State management
 ├── types/         # TypeScript type definitions
 └── workflow/      # Core workflow logic
+    ├── plan-storage.ts      # Consensus docs per-app storage
+    └── workspace-manager.ts # Multi-app workspace management
 ```
 
+### App Target Types
+
+For fullstack and ALL projects, feedback is tracked per app target:
+- `frontend` - React/Vue application
+- `backend` - FastAPI/Express API
+- `website` - Marketing/landing pages (ALL projects)
+- `unified` - Cross-app integration concerns
+
 ### Formatting
 
 We use Prettier for code formatting:

package/README.md

@@ -312,6 +312,9 @@ popeye create "A React component library for data visualization" --language type
 
 # Create a Fullstack project (React frontend + FastAPI backend)
 popeye create "A task management app with user authentication" --language fullstack
+
+# Create an ALL project (React app + FastAPI backend + Marketing website)
+popeye create "A SaaS product with landing page and dashboard" --language all
 ```
 
 ### 3. Monitor Progress
@@ -408,6 +411,26 @@ Example fullstack task in a plan:
 **Dependencies**: Task 1.1, Task 1.2
 ```
 
+### ALL Project Support (Fullstack + Website)
+
+For comprehensive projects that need both an application and a marketing/landing website, Popeye supports the `all` project type which includes:
+
+- **Frontend App**: React application (same as fullstack)
+- **Backend API**: FastAPI backend (same as fullstack)
+- **Website**: Static marketing/landing site (Astro, Next.js static, or similar)
+
+Tasks can be tagged with:
+- `[FE]` - Frontend application work
+- `[BE]` - Backend API work
+- `[WEB]` - Website/marketing pages work
+- `[INT]` - Integration work across multiple apps
+
+The consensus system tracks approval separately for each app target:
+- `frontend` - React/Vue application components
+- `backend` - API endpoints and database logic
+- `website` - Marketing pages, landing pages, SEO content
+- `unified` - Cross-app integration and shared concerns
+
 ### Reliability Features
 
 - **Rate Limit Handling**: Automatically waits and retries when API rate limits are hit
@@ -460,6 +483,33 @@ Example fullstack task in a plan:
   - Checks component library setup
   - Validates theme configuration
 
+### Consensus Documentation Storage
+
+For fullstack and ALL projects, Popeye maintains detailed consensus documentation with per-app feedback tracking:
+
+- **Per-App Feedback**: Feedback is stored separately for each app target:
+  - `unified/` - Cross-app and integration concerns
+  - `frontend/` - React/Vue application feedback
+  - `backend/` - API and database feedback
+  - `website/` - Marketing/landing page feedback (ALL projects only)
+
+- **Hierarchical Storage**: Feedback is organized by plan level:
+  - `docs/plans/master/` - Master plan feedback
+  - `docs/plans/milestone-N/` - Milestone-level feedback
+  - `docs/plans/milestone-N/tasks/task-N/` - Task-level feedback
+
+- **Tracked Metadata**: Each plan level includes `metadata.json` with:
+  - Per-app scores (frontendScore, backendScore, websiteScore, unifiedScore)
+  - Per-app approval status
+  - Correction history and iteration counts
+  - Timestamps for auditing
+
+- **Human-Readable Feedback**: Both JSON and Markdown formats:
+  - `feedback.json` - Structured data for programmatic access
+  - `feedback.md` - Human-readable reviewer feedback
+
+This system ensures full traceability of all AI decisions and enables debugging of consensus failures.
+
 ## Commands
 
 ### `popeye create <idea>`
@@ -477,7 +527,7 @@ popeye create "A CLI tool for converting markdown to PDF" \
 | Option | Description | Default |
 |--------|-------------|---------|
 | `-n, --name <name>` | Project name | Derived from idea |
-| `-l, --language <lang>` | `python` or `typescript` | `python` |
+| `-l, --language <lang>` | `python`, `typescript`, `fullstack`, or `all` | `python` |
 | `-d, --directory <dir>` | Output directory | Current directory |
 | `-m, --model <model>` | OpenAI model for consensus | `gpt-4o` |
 
@@ -567,6 +617,7 @@ popeye
 - `/lang py` or `/lang python` - Python projects
 - `/lang ts` or `/lang typescript` - TypeScript projects
 - `/lang fs` or `/lang fullstack` - Fullstack projects (React + FastAPI)
+- `/lang all` or `/lang web` - ALL projects (React + FastAPI + Website)
 
 **Status Bar Indicators:**
 The input box shows current configuration:
@@ -794,7 +845,38 @@ my-project/
 │
 ├── docs/
 │   ├── PLAN.md                # Development plan with [FE], [BE], [INT] tags
-│   └── WORKFLOW_LOG.md
+│   ├── WORKFLOW_LOG.md
+│   └── plans/                 # Consensus documentation (fullstack/all projects)
+│       ├── master/
+│       │   ├── plan.md
+│       │   ├── metadata.json
+│       │   ├── unified/       # Cross-app feedback
+│       │   │   ├── feedback.json
+│       │   │   └── feedback.md
+│       │   ├── frontend/      # Frontend-specific feedback
+│       │   │   ├── feedback.json
+│       │   │   └── feedback.md
+│       │   ├── backend/       # Backend-specific feedback
+│       │   │   ├── feedback.json
+│       │   │   └── feedback.md
+│       │   └── website/       # Website-specific feedback (ALL projects)
+│       │       ├── feedback.json
+│       │       └── feedback.md
+│       └── milestone-N/
+│           ├── plan.md
+│           ├── metadata.json
+│           ├── unified/
+│           ├── frontend/
+│           ├── backend/
+│           ├── website/
+│           └── tasks/
+│               └── task-N/
+│                   ├── plan.md
+│                   ├── metadata.json
+│                   ├── unified/
+│                   ├── frontend/
+│                   ├── backend/
+│                   └── website/
 ├── README.md
 ├── .gitignore
 ├── .env.example
@@ -802,9 +884,34 @@ my-project/
 ├── popeye.md                  # Project configuration
 └── .popeye/
     ├── state.json
+    ├── workspace.json         # Workspace configuration for multi-app projects
     └── ui-spec.json
 ```
 
+### ALL Projects (Fullstack + Website)
+
+For projects using the `all` language option, an additional `website/` app is included:
+
+```
+my-project/
+├── apps/
+│   ├── frontend/              # React application
+│   ├── backend/               # FastAPI backend
+│   └── website/               # Marketing/landing site
+│       ├── src/
+│       │   ├── pages/
+│       │   ├── components/
+│       │   └── content/
+│       ├── public/
+│       ├── package.json
+│       └── astro.config.mjs   # (or next.config.js, etc.)
+│
+├── docs/
+│   └── plans/                 # Includes website/ directories
+│       └── ...
+└── ...
+```
+
 ## UI Design System
 
 Popeye automatically generates a complete UI design system for frontend projects. The design decisions are based on analyzing your project idea and are fully customizable.
@@ -974,6 +1081,8 @@ src/
 │   ├── task-workflow.ts
 │   ├── test-runner.ts    # Test execution
 │   ├── workflow-logger.ts # Persistent logging
+│   ├── plan-storage.ts   # Consensus docs storage (per-app feedback)
+│   ├── workspace-manager.ts # Multi-app workspace management
 │   ├── ui-designer.ts    # AI-powered UI design generation
 │   ├── ui-setup.ts       # Tailwind/shadcn setup automation
 │   ├── ui-verification.ts # UI setup verification

package/dist/adapters/claude.d.ts

@@ -3,9 +3,14 @@
  * Wraps the Claude Agent SDK for code execution and generation
  */
 import { type SDKMessage } from '@anthropic-ai/claude-agent-sdk';
+import type { OutputLanguage } from '../types/project.js';
 /**
  * Options for executing a prompt through Claude
  */
+/**
+ * User's choice when rate limit wait time exceeds maximum
+ */
+export type RateLimitChoice = 'wait' | 'pause';
 export interface ClaudeExecuteOptions {
     cwd?: string;
     allowedTools?: string[];
@@ -23,6 +28,12 @@ export interface ClaudeExecuteOptions {
         baseWaitMs?: number;
         maxWaitMs?: number;
     } | false;
+    /**
+     * Callback when rate limit wait time exceeds maximum.
+     * Returns 'wait' to wait for the full duration, or 'pause' to exit gracefully.
+     * If not provided, defaults to 'pause' behavior.
+     */
+    onRateLimitChoice?: (waitTimeMs: number, resetMessage: string) => Promise<RateLimitChoice>;
 }
 /**
  * Result from Claude execution
@@ -32,6 +43,19 @@ export interface ClaudeExecuteResult {
     response: string;
     toolCalls: ToolCallRecord[];
     error?: string;
+    /**
+     * True if the operation was paused due to rate limiting (not a failure).
+     * When true, the user can resume later without losing progress.
+     */
+    rateLimitPaused?: boolean;
+    /**
+     * Information about the rate limit if applicable
+     */
+    rateLimitInfo?: {
+        resetTime?: Date;
+        waitTimeMs?: number;
+        message?: string;
+    };
 }
 /**
  * Record of a tool call made by Claude
@@ -83,7 +107,7 @@ export declare function analyzeCodebase(cwd: string, onProgress?: (message: stri
  * @param language - Target programming language (default: 'python')
  * @param onProgress - Progress callback
  */
-export declare function createPlan(specification: string, context?: string, language?: 'python' | 'typescript' | 'fullstack', onProgress?: (message: string) => void): Promise<ClaudeExecuteResult>;
+export declare function createPlan(specification: string, context?: string, language?: OutputLanguage, onProgress?: (message: string) => void): Promise<ClaudeExecuteResult>;
 /**
  * Revise a plan based on feedback
  *
@@ -93,5 +117,5 @@ export declare function createPlan(specification: string, context?: string, lang
  * @param language - Target programming language (default: 'python')
  * @param onProgress - Progress callback
  */
-export declare function revisePlan(originalPlan: string, feedback: string, concerns: string[], language?: 'python' | 'typescript' | 'fullstack', onProgress?: (message: string) => void): Promise<ClaudeExecuteResult>;
+export declare function revisePlan(originalPlan: string, feedback: string, concerns: string[], language?: OutputLanguage, onProgress?: (message: string) => void): Promise<ClaudeExecuteResult>;
 //# sourceMappingURL=claude.d.ts.map

package/dist/adapters/claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,mBAAmB,GAAG,MAAM,CAAC;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC;;;OAGG;IACH,eAAe,CAAC,EAAE;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,KAAK,CAAC;CACX;AAiRD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,UAWjC,CAAC;AAmPF;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CA+F9B;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAyB9B;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,CAoB9B;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACrC,OAAO,CAAC,mBAAmB,CAAC,CAoB9B;AA0SD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,MAAW,EACpB,QAAQ,GAAE,QAAQ,GAAG,YAAY,GAAG,WAAsB,EAC1D,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACrC,OAAO,CAAC,mBAAmB,CAAC,CAmF9B;AAsDD;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,GAAE,QAAQ,GAAG,YAAY,GAAG,WAAsB,EAC1D,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACrC,OAAO,CAAC,mBAAmB,CAAC,CAsE9B"}
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"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"}

package/dist/adapters/claude.js

@@ -455,7 +455,7 @@ async function executePromptInternal(prompt, options = {}) {
  * @returns The execution result
  */
 export async function executePrompt(prompt, options = {}) {
-    const { onProgress, rateLimitConfig: userRateLimitConfig } = options;
+    const { onProgress, rateLimitConfig: userRateLimitConfig, onRateLimitChoice } = options;
     // If rate limit handling is disabled, run once without retry
     if (userRateLimitConfig === false) {
         const result = await executePromptInternal(prompt, options);
@@ -508,16 +508,49 @@ export async function executePrompt(prompt, options = {}) {
         }
         // Ensure minimum wait time
         waitMs = Math.max(waitMs, 30_000);
-        // IMPORTANT: Cap wait time to maxWaitMs - don't wait hours for rate limits
+        // Check if wait time exceeds maximum
         if (waitMs > rateLimitConfig.maxWaitMs) {
-            onProgress?.(`Rate limit reset time is too far in the future (${formatWaitTime(waitMs)})`);
-            onProgress?.(`Maximum wait time is ${formatWaitTime(rateLimitConfig.maxWaitMs)}. Please try again later.`);
-            return {
-                success: false,
-                response: result.response,
-                toolCalls: result.toolCalls,
-                error: `Rate limit exceeded. Reset time is ${formatWaitTime(waitMs)} away - too long to wait. Please try again later.`,
-            };
+            const resetMessage = result.rateLimitInfo.message || `Reset in ${formatWaitTime(waitMs)}`;
+            // If callback provided, ask user what to do
+            if (onRateLimitChoice) {
+                onProgress?.(`Rate limit: wait time is ${formatWaitTime(waitMs)} (exceeds ${formatWaitTime(rateLimitConfig.maxWaitMs)} max)`);
+                const choice = await onRateLimitChoice(waitMs, resetMessage);
+                if (choice === 'wait') {
+                    // User chose to wait - continue with the full wait time
+                    onProgress?.(`Waiting ${formatWaitTime(waitMs)} as requested...`);
+                }
+                else {
+                    // User chose to pause - return graceful pause (not failure)
+                    onProgress?.(`Pausing due to rate limit. You can resume later with /resume`);
+                    return {
+                        success: false,
+                        response: result.response,
+                        toolCalls: result.toolCalls,
+                        rateLimitPaused: true,
+                        rateLimitInfo: {
+                            resetTime: result.rateLimitInfo.resetTime,
+                            waitTimeMs: waitMs,
+                            message: resetMessage,
+                        },
+                    };
+                }
+            }
+            else {
+                // No callback - return graceful pause by default
+                onProgress?.(`Rate limit: wait time is ${formatWaitTime(waitMs)} (exceeds ${formatWaitTime(rateLimitConfig.maxWaitMs)} max)`);
+                onProgress?.(`Pausing due to rate limit. You can resume later with /resume`);
+                return {
+                    success: false,
+                    response: result.response,
+                    toolCalls: result.toolCalls,
+                    rateLimitPaused: true,
+                    rateLimitInfo: {
+                        resetTime: result.rateLimitInfo.resetTime,
+                        waitTimeMs: waitMs,
+                        message: resetMessage,
+                    },
+                };
+            }
         }
         onProgress?.(`Rate limit hit (attempt ${attempt}/${rateLimitConfig.maxRetries}). ${result.rateLimitInfo.message || ''}`);
         onProgress?.(`Waiting ${formatWaitTime(waitMs)} before retry...`);
@@ -780,6 +813,220 @@ Your response MUST be the complete plan in this EXACT format:
 6. Each task MUST start with an action verb: Implement, Create, Build, Add, Configure, Set up, Write, Design, etc.
 7. Each task MUST be specific and implementable
 
+IMPORTANT: Output the COMPLETE plan now. Start with "# Development Plan:" on the first line.
+`.trim();
+    }
+    // "All" project format (FE + BE + Website)
+    if (language === 'all') {
+        return `
+${baseInstructions}
+
+## Project Type: ALL (Frontend + Backend + Website)
+- **Frontend**: React + Vite + TypeScript + Tailwind CSS (apps/frontend)
+- **Backend**: FastAPI (Python) + PostgreSQL (apps/backend)
+- **Website**: Next.js SSG/SSR marketing site (apps/website)
+- **Shared**: Design tokens, UI components (packages/)
+- **Structure**: Monorepo with apps/ and packages/
+
+## Specification
+${specification}
+
+${context ? `## Additional Context\n${context}` : ''}
+
+## Required Plan Format for All-in-One Projects
+
+Your response MUST be the complete plan in this EXACT format:
+
+# Development Plan: [Project Name]
+
+## Overview
+[2-3 sentence summary covering app, API, and website]
+
+## Architecture
+- **Frontend App**: React SPA at apps/frontend/
+- **Backend API**: FastAPI service at apps/backend/
+- **Marketing Website**: Next.js at apps/website/
+- **Shared Packages**: packages/ui, packages/design-tokens
+
+---
+
+## Milestone 1: [Name]
+**Description**: [What this milestone achieves]
+
+### Frontend Tasks
+
+#### Task 1.1 [FE]: [Actionable task name]
+**App**: frontend
+**Files**:
+- \`apps/frontend/src/components/...\`
+**Dependencies**: None
+**Acceptance Criteria**:
+- [ ] Criterion 1
+
+### Backend Tasks
+
+#### Task 1.2 [BE]: [Actionable task name]
+**App**: backend
+**Files**:
+- \`apps/backend/src/...\`
+**Dependencies**: None
+**Acceptance Criteria**:
+- [ ] Criterion 1
+
+### Website Tasks
+
+#### Task 1.3 [WEB]: [Actionable task name]
+**App**: website
+**Files**:
+- \`apps/website/src/app/...\`
+**Dependencies**: None
+**Acceptance Criteria**:
+- [ ] Page renders with proper SEO metadata
+- [ ] Page passes Lighthouse performance check
+
+### Integration Tasks
+
+#### Task 1.4 [INT]: [Actionable task name]
+**App**: unified
+**Dependencies**: Task 1.1, Task 1.2
+**Acceptance Criteria**:
+- [ ] Integration criterion
+
+---
+
+## Milestone 2: [Name]
+[Continue same pattern...]
+
+---
+
+## Test Plan
+
+### Frontend Tests (apps/frontend)
+- Vitest + Testing Library for unit tests
+- Playwright for E2E
+
+### Backend Tests (apps/backend)
+- pytest for unit tests
+- pytest + TestClient for integration
+
+### Website Tests (apps/website)
+- Vitest for component tests
+- SEO acceptance tests (sitemap, robots, metadata)
+- Lighthouse performance checks
+
+### Integration Tests
+- API contract validation
+- E2E user flows across all apps
+
+## Risks & Mitigations
+[Include frontend, backend, website, and integration risks separately]
+
+---
+
+## CRITICAL REQUIREMENTS FOR "ALL" PROJECTS:
+1. **Tag every task** with [FE], [BE], [WEB], or [INT]
+   - [FE] = Frontend app task
+   - [BE] = Backend API task
+   - [WEB] = Marketing website task
+   - [INT] = Integration/unified task
+2. **Specify App field** for each task (frontend, backend, website, or unified)
+3. **List exact file paths** under the appropriate apps/ or packages/ directory
+4. **Group tasks** under "Frontend Tasks", "Backend Tasks", "Website Tasks", or "Integration Tasks" headers
+5. **Website tasks MUST include SEO requirements** in acceptance criteria
+6. **Website must NOT import from apps/frontend/** - use packages/ui instead
+7. Each task MUST start with an action verb
+8. Include at least 3 milestones
+
+IMPORTANT: Output the COMPLETE plan now. Start with "# Development Plan:" on the first line.
+`.trim();
+    }
+    // Website-only format
+    if (language === 'website') {
+        return `
+${baseInstructions}
+
+## Project Type: WEBSITE (Next.js Marketing Site)
+- **Framework**: Next.js 14+ App Router
+- **Styling**: Tailwind CSS
+- **Content**: MDX for blog/docs
+- **SEO**: Sitemap, robots.txt, OpenGraph
+
+## Specification
+${specification}
+
+${context ? `## Additional Context\n${context}` : ''}
+
+## Required Plan Format for Website Projects
+
+Your response MUST be the complete plan in this EXACT format:
+
+# Development Plan: [Project Name]
+
+## Overview
+[2-3 sentence summary of the marketing website]
+
+## Architecture
+- **Framework**: Next.js App Router
+- **Styling**: Tailwind CSS
+- **Content**: MDX for blog posts and documentation
+- **Deployment**: Vercel/Docker
+
+---
+
+## Milestone 1: [Name]
+**Description**: [What this milestone achieves]
+
+### Task 1.1: [Actionable task name]
+**Files**:
+- \`src/app/page.tsx\`
+- \`src/components/...\`
+**Dependencies**: None
+**Acceptance Criteria**:
+- [ ] Page renders correctly
+- [ ] SEO metadata is properly configured
+- [ ] Page passes Lighthouse performance check (90+ score)
+
+### Task 1.2: [Another actionable task]
+...
+
+---
+
+## Milestone 2: [Name]
+...
+
+---
+
+## SEO Requirements (ALL pages must have)
+
+1. **Metadata exports** in every page.tsx:
+   - title (unique per page)
+   - description
+   - openGraph data
+2. **sitemap.ts** - Auto-generated sitemap
+3. **robots.ts** - robots.txt configuration
+4. **OG images** - Default and per-page OpenGraph images
+5. **Structured data** - JSON-LD where applicable
+
+## Test Plan
+- Vitest for component tests
+- SEO acceptance tests
+- Lighthouse performance audits
+- Accessibility testing
+
+## Risks & Mitigations
+[Include SEO, performance, and content risks]
+
+---
+
+## Requirements for Tasks
+
+1. Each task MUST start with an action verb
+2. Each task MUST include SEO considerations
+3. Each milestone MUST have at least 3-5 specific tasks
+4. The plan MUST have at least 3 milestones
+5. Files to create/modify MUST be listed for each task
+6. Acceptance criteria MUST include SEO requirements where applicable
+
 IMPORTANT: Output the COMPLETE plan now. Start with "# Development Plan:" on the first line.
 `.trim();
     }