docs: add sample output artifacts for all 10 PRDs

outputs/sample_prd_01_rate_limiting_requirements.json

@@ -0,0 +1,115 @@
+{
+  "requirements": [
+    {
+      "id": "REQ-001",
+      "title": "Tier-Based Rate Limits",
+      "description": "Implement rate limits based on customer tier to manage API usage and prevent abuse.",
+      "acceptance_criteria": [
+        "Free tier: 100 requests per minute, 1,000 requests per day",
+        "Pro tier: 1,000 requests per minute, unlimited daily requests",
+        "Enterprise tier: Custom limits configured per customer"
+      ],
+      "dependencies": [],
+      "ambiguity_flags": [
+        {
+          "category": "vague_quantifier",
+          "issue": "The term 'fast and scalable' is not quantified.",
+          "severity": "warning",
+          "suggested_action": "Define specific performance metrics for scalability and speed."
+        }
+      ],
+      "priority": "high"
+    },
+    {
+      "id": "REQ-002",
+      "title": "Rate Limit Response Headers",
+      "description": "Include rate limit information in all API responses to inform clients of their usage status.",
+      "acceptance_criteria": [
+        "API responses include X-RateLimit-Limit header",
+        "API responses include X-RateLimit-Remaining header",
+        "API responses include X-RateLimit-Reset header"
+      ],
+      "dependencies": [
+        "REQ-001"
+      ],
+      "ambiguity_flags": [],
+      "priority": "medium"
+    },
+    {
+      "id": "REQ-003",
+      "title": "Rate Limit Exceeded Handling",
+      "description": "Define the response behavior when a client exceeds their rate limit.",
+      "acceptance_criteria": [
+        "Return HTTP 429 status code when limit exceeded",
+        "Include Retry-After header with seconds until reset",
+        "Return JSON error body with clear message and documentation link"
+      ],
+      "dependencies": [
+        "REQ-001"
+      ],
+      "ambiguity_flags": [],
+      "priority": "high"
+    },
+    {
+      "id": "REQ-004",
+      "title": "Developer Dashboard",
+      "description": "Provide a dashboard for developers to view and manage their API usage and limits.",
+      "acceptance_criteria": [
+        "Developers can view current usage and limits",
+        "Developers can see historical usage graphs",
+        "Dashboard is user-friendly and intuitive"
+      ],
+      "dependencies": [],
+      "ambiguity_flags": [
+        {
+          "category": "undefined_term",
+          "issue": "The term 'user-friendly and intuitive' is not defined.",
+          "severity": "suggestion",
+          "suggested_action": "Specify measurable criteria for user-friendliness and intuitiveness."
+        }
+      ],
+      "priority": "medium"
+    },
+    {
+      "id": "REQ-005",
+      "title": "Backend Implementation",
+      "description": "Implement the technical backend for rate limiting using Redis and support additional features.",
+      "acceptance_criteria": [
+        "Use Redis for storing rate limit counters",
+        "Support configurable limits per endpoint",
+        "Implement bypass mechanism for internal services",
+        "Log and alert when customers approach or exceed limits"
+      ],
+      "dependencies": [
+        "REQ-001"
+      ],
+      "ambiguity_flags": [],
+      "priority": "high"
+    },
+    {
+      "id": "REQ-006",
+      "title": "Monitoring and Observability",
+      "description": "Implement monitoring and observability for the rate limiting system.",
+      "acceptance_criteria": [
+        "Emit metrics for rate limit checks, passes, and rejections",
+        "Create dashboards showing rate limit health",
+        "Alert on anomalies such as sudden spikes in rejections or Redis failures"
+      ],
+      "dependencies": [
+        "REQ-005"
+      ],
+      "ambiguity_flags": [],
+      "priority": "medium"
+    }
+  ],
+  "summary": "Implement a tier-based rate limiting system for the public API to prevent abuse, ensure fair usage, and protect backend services.",
+  "source_hash": "a2b4a2f1",
+  "_metadata": {
+    "analyzed_at": "2026-02-15T19:24:38.834881+00:00",
+    "prompt_version": "1.6.0",
+    "model": "gpt-4o",
+    "prompt_tokens": 1247,
+    "completion_tokens": 834,
+    "total_tokens": 2081
+  }
+}