Rebuild REPL Works Website Around the AI-Native Product Development Framework #35

TASKS.md

@@ -119,77 +119,77 @@ Propose TASK update
 
 ### INFORMATION ARCHITECTURE
 
-* [ ] T401 Replace legacy navigation with new navigation structure
-* [ ] T402 Remove Why section
-* [ ] T403 Remove Manifesto section
-* [ ] T404 Remove Specification section
+* [x] T401 Replace legacy navigation with new navigation structure
+* [x] T402 Remove Why section
+* [x] T403 Remove Manifesto section
+* [x] T404 Remove Specification section
 
 ---
 
 ### HOME
 
-* [ ] T405 Rewrite Home page for AI-Native Product Development Framework positioning
-* [ ] T406 Add workflow-first messaging
-* [ ] T407 Add REPL Works Compatible positioning
-* [ ] T408 Add GitHub call-to-action
+* [x] T405 Rewrite Home page for AI-Native Product Development Framework positioning
+* [x] T406 Add workflow-first messaging
+* [x] T407 Add REPL Works Compatible positioning
+* [x] T408 Add GitHub call-to-action
 
 ---
 
 ### WORKFLOW
 
-* [ ] T409 Rewrite Workflow documentation
-* [ ] T410 Publish current REPL Works workflow
-* [ ] T411 Explain Planning AI vs Execution AI
-* [ ] T412 Explain continuous improvement workflow
+* [x] T409 Rewrite Workflow documentation
+* [x] T410 Publish current REPL Works workflow
+* [x] T411 Explain Planning AI vs Execution AI
+* [x] T412 Explain continuous improvement workflow
 
 ---
 
 ### PROMPTS
 
-* [ ] T413 Create Prompts section
-* [ ] T414 Publish IDEAS prompt
-* [ ] T415 Publish PITCHING_SCRIPT prompt
-* [ ] T416 Publish PRODUCT_SPEC prompt
-* [ ] T417 Publish ARCHITECTURE prompt
-* [ ] T418 Publish TASKS prompt
-* [ ] T419 Publish Review prompts
+* [x] T413 Create Prompts section
+* [x] T414 Publish IDEAS prompt
+* [x] T415 Publish PITCHING_SCRIPT prompt
+* [x] T416 Publish PRODUCT_SPEC prompt
+* [x] T417 Publish ARCHITECTURE prompt
+* [x] T418 Publish TASKS prompt
+* [x] T419 Publish Review prompts
 
 ---
 
 ### DOCUMENTS
 
-* [ ] T420 Create Documents section
-* [ ] T421 Publish AGENTS.md standard
-* [ ] T422 Publish PRODUCT_SPEC.md standard
-* [ ] T423 Publish ARCHITECTURE.md standard
-* [ ] T424 Publish TASKS.md standard
+* [x] T420 Create Documents section
+* [x] T421 Publish AGENTS.md standard
+* [x] T422 Publish PRODUCT_SPEC.md standard
+* [x] T423 Publish ARCHITECTURE.md standard
+* [x] T424 Publish TASKS.md standard
 
 ---
 
 ### TOOLS
 
-* [ ] T425 Create Tools section
-* [ ] T426 Publish ai-issue
-* [ ] T427 Add installation guide
-* [ ] T428 Add GitHub repository links
+* [x] T425 Create Tools section
+* [x] T426 Publish ai-issue
+* [x] T427 Add installation guide
+* [x] T428 Add GitHub repository links
 
 ---
 
 ### SHOWCASE
 
-* [ ] T429 Convert Showcase to REPL Works Compatible Projects
-* [ ] T430 Publish REPL Works Website showcase
-* [ ] T431 Publish ai-issue showcase
-* [ ] T432 Publish Wifi Note showcase
+* [x] T429 Convert Showcase to REPL Works Compatible Projects
+* [x] T430 Publish REPL Works Website showcase
+* [x] T431 Publish ai-issue showcase
+* [x] T432 Publish Wifi Note showcase
 
 ---
 
 ### FAQ
 
-* [ ] T433 Rewrite FAQ for framework positioning
-* [ ] T434 Add compatibility questions
-* [ ] T435 Add workflow questions
-* [ ] T436 Add planning vs execution questions
+* [x] T433 Rewrite FAQ for framework positioning
+* [x] T434 Add compatibility questions
+* [x] T435 Add workflow questions
+* [x] T436 Add planning vs execution questions
 
 ---
 

src/content.config.ts

@@ -10,30 +10,30 @@ const baseCollectionSchema = z.object({
 });
 
 export const collections = {
-  manifesto: defineCollection({
+  workflow: defineCollection({
     loader: glob({
-      base: './src/content/manifesto',
+      base: './src/content/workflow',
       pattern: '**/*.{md,mdx}',
     }),
     schema: baseCollectionSchema,
   }),
-  specification: defineCollection({
+  prompts: defineCollection({
     loader: glob({
-      base: './src/content/specification',
+      base: './src/content/prompts',
       pattern: '**/*.{md,mdx}',
     }),
     schema: baseCollectionSchema,
   }),
-  workflow: defineCollection({
+  documents: defineCollection({
     loader: glob({
-      base: './src/content/workflow',
+      base: './src/content/documents',
       pattern: '**/*.{md,mdx}',
     }),
     schema: baseCollectionSchema,
   }),
-  resources: defineCollection({
+  tools: defineCollection({
     loader: glob({
-      base: './src/content/resources',
+      base: './src/content/tools',
       pattern: '**/*.{md,mdx}',
     }),
     schema: baseCollectionSchema,
@@ -45,4 +45,11 @@ export const collections = {
     }),
     schema: baseCollectionSchema,
   }),
+  faq: defineCollection({
+    loader: glob({
+      base: './src/content/faq',
+      pattern: '**/*.{md,mdx}',
+    }),
+    schema: baseCollectionSchema,
+  }),
 };

src/content/documents/agents.mdx

@@ -0,0 +1,31 @@
+---
+title: 'AGENTS.md'
+version: 'v1'
+description: 'Project entrypoint and operating rules for AI collaborators.'
+publishedAt: '2026-06-12T00:00:00Z'
+---
+
+## Purpose
+
+Define the authoritative reading order, scope boundaries, and implementation rules.
+
+## Inputs
+
+- repository context
+- product specification
+- architecture
+- tasks
+
+## Outputs
+
+- collaboration rules
+- task execution order
+- scope limits
+
+## Lifecycle
+
+Reviewed first, then updated only when operating rules or authoritative sources change.
+
+## Relationships
+
+Depends on `PRODUCT_SPEC.md`, `ARCHITECTURE.md`, and `TASKS.md`.

src/content/documents/architecture.mdx

@@ -0,0 +1,30 @@
+---
+title: 'ARCHITECTURE.md'
+version: 'v1'
+description: 'Technical structure and repository constraints for REPL Works.'
+publishedAt: '2026-06-12T00:00:00Z'
+---
+
+## Purpose
+
+Describe the system design, technical structure, and repository constraints.
+
+## Inputs
+
+- `PRODUCT_SPEC.md`
+- repository structure
+- implementation constraints
+
+## Outputs
+
+- content model
+- routing plan
+- file placement rules
+
+## Lifecycle
+
+Updated when technical structure or implementation constraints change.
+
+## Relationships
+
+Constrained by `PRODUCT_SPEC.md` and implemented through `TASKS.md`.

src/content/documents/ideas.mdx

@@ -0,0 +1,30 @@
+---
+title: 'IDEAS.md'
+version: 'v1'
+description: 'Idea refinement record for project discovery and validation.'
+publishedAt: '2026-06-12T00:00:00Z'
+---
+
+## Purpose
+
+Capture refined project ideas before specification work begins.
+
+## Inputs
+
+- raw ideas
+- market observations
+- user pain points
+
+## Outputs
+
+- validated direction
+- risks
+- open questions
+
+## Lifecycle
+
+Created during discovery and updated until the idea is ready for pitching.
+
+## Relationships
+
+Feeds `PITCHING_SCRIPT.md` and informs `PRODUCT_SPEC.md`.

src/content/documents/index.mdx

@@ -0,0 +1,23 @@
+---
+title: 'Documents'
+version: 'v1'
+description: 'Reusable document standards for the REPL Works framework.'
+publishedAt: '2026-06-12T00:00:00Z'
+---
+
+## Purpose
+
+Document the standards that keep REPL Works projects consistent over time.
+
+## Documents
+
+- [AGENTS.md](/documents/agents)
+- [PITCHING_SCRIPT.md](/documents/pitching-script)
+- [PRODUCT_SPEC.md](/documents/product-spec)
+- [ARCHITECTURE.md](/documents/architecture)
+- [TASKS.md](/documents/tasks)
+- [IDEAS.md](/documents/ideas)
+
+## Lifecycle
+
+Each document captures a different stage of the project lifecycle and is updated only when its responsibility changes.

src/content/documents/pitching-script.mdx

@@ -0,0 +1,30 @@
+---
+title: 'PITCHING_SCRIPT.md'
+version: 'v1'
+description: 'Pitch document that turns a refined idea into a concise narrative.'
+publishedAt: '2026-06-12T00:00:00Z'
+---
+
+## Purpose
+
+Turn refined ideas into a clear pitch that can be reviewed and reused.
+
+## Inputs
+
+- `IDEAS.md`
+- target audience
+- problem definition
+
+## Outputs
+
+- project pitch
+- positioning
+- rationale
+
+## Lifecycle
+
+Written after idea refinement and before product specification.
+
+## Relationships
+
+Sits between `IDEAS.md` and `PRODUCT_SPEC.md`.

src/content/documents/product-spec.mdx

@@ -0,0 +1,30 @@
+---
+title: 'PRODUCT_SPEC.md'
+version: 'v1'
+description: 'Product source of truth for the website and framework.'
+publishedAt: '2026-06-12T00:00:00Z'
+---
+
+## Purpose
+
+Define the product, users, journey, UX, content, and business intent.
+
+## Inputs
+
+- pitch
+- user needs
+- business goals
+
+## Outputs
+
+- product definition
+- page responsibilities
+- information architecture
+
+## Lifecycle
+
+Updated when product meaning or user-facing structure changes.
+
+## Relationships
+
+Guides `ARCHITECTURE.md` and constrains `TASKS.md`.

src/content/documents/tasks.mdx

@@ -0,0 +1,30 @@
+---
+title: 'TASKS.md'
+version: 'v1'
+description: 'Current work scope and execution order for REPL Works.'
+publishedAt: '2026-06-12T00:00:00Z'
+---
+
+## Purpose
+
+Track the current implementation scope and the order in which work should be done.
+
+## Inputs
+
+- `PRODUCT_SPEC.md`
+- `ARCHITECTURE.md`
+- active project state
+
+## Outputs
+
+- task list
+- execution order
+- completion status
+
+## Lifecycle
+
+Updated as tasks are completed or newly scoped work is approved.
+
+## Relationships
+
+Must stay aligned with `PRODUCT_SPEC.md` and `ARCHITECTURE.md`.