From 961e37ee98e464f8f7a2e391f5159a83db19d980 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Fri, 12 Jun 2026 16:17:26 +0900 Subject: [PATCH] feat: rebuild REPL Works Website Around the AI-Native Product Development Framework --- TASKS.md | 72 ++++----- src/content.config.ts | 23 ++- src/content/documents/agents.mdx | 31 ++++ src/content/documents/architecture.mdx | 30 ++++ src/content/documents/ideas.mdx | 30 ++++ src/content/documents/index.mdx | 23 +++ src/content/documents/pitching-script.mdx | 30 ++++ src/content/documents/product-spec.mdx | 30 ++++ src/content/documents/tasks.mdx | 30 ++++ src/content/faq/index.mdx | 34 +++++ src/content/prompts/architecture-design.mdx | 19 +++ src/content/prompts/execution-validation.mdx | 19 +++ src/content/prompts/idea-refinement.mdx | 21 +++ src/content/prompts/index.mdx | 23 +++ src/content/prompts/pitch-creation.mdx | 18 +++ src/content/prompts/product-specification.mdx | 19 +++ src/content/prompts/task-generation.mdx | 18 +++ src/content/showcase/index.mdx | 26 ++-- src/content/showcase/repl-works-website.mdx | 33 +++-- src/content/tools/ai-issue.mdx | 22 +++ src/content/tools/index.mdx | 22 +++ src/content/workflow/index.mdx | 50 +++++++ src/lib/site.ts | 33 +++-- src/pages/index.astro | 140 +++++++----------- src/pages/search.astro | 11 +- src/pages/why.astro | 11 +- 26 files changed, 636 insertions(+), 182 deletions(-) create mode 100644 src/content/documents/agents.mdx create mode 100644 src/content/documents/architecture.mdx create mode 100644 src/content/documents/ideas.mdx create mode 100644 src/content/documents/index.mdx create mode 100644 src/content/documents/pitching-script.mdx create mode 100644 src/content/documents/product-spec.mdx create mode 100644 src/content/documents/tasks.mdx create mode 100644 src/content/faq/index.mdx create mode 100644 src/content/prompts/architecture-design.mdx create mode 100644 src/content/prompts/execution-validation.mdx create mode 100644 src/content/prompts/idea-refinement.mdx create mode 100644 src/content/prompts/index.mdx create mode 100644 src/content/prompts/pitch-creation.mdx create mode 100644 src/content/prompts/product-specification.mdx create mode 100644 src/content/prompts/task-generation.mdx create mode 100644 src/content/tools/ai-issue.mdx create mode 100644 src/content/tools/index.mdx create mode 100644 src/content/workflow/index.mdx diff --git a/TASKS.md b/TASKS.md index 0884e1f..33e5fc4 100644 --- a/TASKS.md +++ b/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 --- diff --git a/src/content.config.ts b/src/content.config.ts index 0ba4291..a5ce50e 100644 --- a/src/content.config.ts +++ b/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, + }), }; diff --git a/src/content/documents/agents.mdx b/src/content/documents/agents.mdx new file mode 100644 index 0000000..fe83f83 --- /dev/null +++ b/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`. diff --git a/src/content/documents/architecture.mdx b/src/content/documents/architecture.mdx new file mode 100644 index 0000000..10d4727 --- /dev/null +++ b/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`. diff --git a/src/content/documents/ideas.mdx b/src/content/documents/ideas.mdx new file mode 100644 index 0000000..3862557 --- /dev/null +++ b/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`. diff --git a/src/content/documents/index.mdx b/src/content/documents/index.mdx new file mode 100644 index 0000000..996606d --- /dev/null +++ b/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. diff --git a/src/content/documents/pitching-script.mdx b/src/content/documents/pitching-script.mdx new file mode 100644 index 0000000..7ce9d99 --- /dev/null +++ b/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`. diff --git a/src/content/documents/product-spec.mdx b/src/content/documents/product-spec.mdx new file mode 100644 index 0000000..557e740 --- /dev/null +++ b/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`. diff --git a/src/content/documents/tasks.mdx b/src/content/documents/tasks.mdx new file mode 100644 index 0000000..071f13f --- /dev/null +++ b/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`. diff --git a/src/content/faq/index.mdx b/src/content/faq/index.mdx new file mode 100644 index 0000000..03e2d82 --- /dev/null +++ b/src/content/faq/index.mdx @@ -0,0 +1,34 @@ +--- +title: 'FAQ' +version: 'v1' +description: 'Frequently asked questions about REPL Works.' +publishedAt: '2026-06-12T00:00:00Z' +--- + +## Why not chat history? + +Chat history is valuable for conversation, but REPL Works needs durable project memory that remains readable and reusable after sessions end. + +## Why Git? + +Git records human-approved changes, keeps project state reviewable, and provides continuity across model changes. + +## Why Markdown? + +Markdown is portable, diffable, easy for humans to read, and easy for AI to generate and consume. + +## Why separate Planning and Execution? + +Planning AI should define the work. Execution AI should implement the work. Keeping those responsibilities separate reduces confusion and context waste. + +## Why PRODUCT_SPEC.md? + +`PRODUCT_SPEC.md` is the product source of truth. It keeps the website aligned with the intended user experience and business intent. + +## How is REPL Works different from AI agents? + +AI agents focus on action. REPL Works focuses on the project memory and document structure that make action reliable over time. + +## How does REPL Works reduce context costs? + +It compresses project memory into durable documents, so the model reads only what it needs instead of reconstructing the entire project from chat history. diff --git a/src/content/prompts/architecture-design.mdx b/src/content/prompts/architecture-design.mdx new file mode 100644 index 0000000..f7c6ebc --- /dev/null +++ b/src/content/prompts/architecture-design.mdx @@ -0,0 +1,19 @@ +--- +title: 'Architecture Design' +version: 'v1' +description: 'Prompt starter for defining the technical structure from a product specification.' +publishedAt: '2026-06-12T00:00:00Z' +--- + +```prompt +Design the architecture for this product. + +Focus on: +- repository structure +- content model +- routing +- constraints +- implementation boundaries + +Return architecture that supports static, content-first delivery. +``` diff --git a/src/content/prompts/execution-validation.mdx b/src/content/prompts/execution-validation.mdx new file mode 100644 index 0000000..4bee032 --- /dev/null +++ b/src/content/prompts/execution-validation.mdx @@ -0,0 +1,19 @@ +--- +title: 'Execution Validation' +version: 'v1' +description: 'Prompt starter for validating implementation against the approved plan.' +publishedAt: '2026-06-12T00:00:00Z' +--- + +```prompt +Validate the implementation against TASKS.md, ARCHITECTURE.md, and PRODUCT_SPEC.md. + +Check: +- required files +- content accuracy +- navigation +- build correctness +- architecture alignment + +Report only mismatches, risks, and missing coverage. +``` diff --git a/src/content/prompts/idea-refinement.mdx b/src/content/prompts/idea-refinement.mdx new file mode 100644 index 0000000..10a3f4a --- /dev/null +++ b/src/content/prompts/idea-refinement.mdx @@ -0,0 +1,21 @@ +--- +title: 'Idea Refinement' +version: 'v1' +description: 'Prompt starter for refining raw ideas into actionable project direction.' +publishedAt: '2026-06-12T00:00:00Z' +--- + +```prompt +You are a critical co-founder helping refine a raw project idea. + +Focus on: +- problem clarity +- target user +- existing alternatives +- differentiation +- constraints +- long-term viability + +Do not write a specification yet. +Ask the most important questions first. +``` diff --git a/src/content/prompts/index.mdx b/src/content/prompts/index.mdx new file mode 100644 index 0000000..1501e3a --- /dev/null +++ b/src/content/prompts/index.mdx @@ -0,0 +1,23 @@ +--- +title: 'Prompts' +version: 'v1' +description: 'Reusable Prompt Library for REPL Works.' +publishedAt: '2026-06-12T00:00:00Z' +--- + +## Purpose + +Reusable prompt library for AI-native product development. + +## Prompt Library + +- [Idea Refinement](/prompts/idea-refinement) +- [Pitch Creation](/prompts/pitch-creation) +- [Product Specification](/prompts/product-specification) +- [Architecture Design](/prompts/architecture-design) +- [Task Generation](/prompts/task-generation) +- [Execution Validation](/prompts/execution-validation) + +## How to Use + +Each prompt is designed to be copied, edited, and reused across projects. diff --git a/src/content/prompts/pitch-creation.mdx b/src/content/prompts/pitch-creation.mdx new file mode 100644 index 0000000..45668bb --- /dev/null +++ b/src/content/prompts/pitch-creation.mdx @@ -0,0 +1,18 @@ +--- +title: 'Pitch Creation' +version: 'v1' +description: 'Prompt starter for turning a validated idea into a clear pitch.' +publishedAt: '2026-06-12T00:00:00Z' +--- + +```prompt +Turn the refined idea into a concise pitch. + +Explain: +- what the product is +- who it is for +- why it matters +- what makes it different + +Keep the output short, direct, and reusable. +``` diff --git a/src/content/prompts/product-specification.mdx b/src/content/prompts/product-specification.mdx new file mode 100644 index 0000000..1afddde --- /dev/null +++ b/src/content/prompts/product-specification.mdx @@ -0,0 +1,19 @@ +--- +title: 'Product Specification' +version: 'v1' +description: 'Prompt starter for writing a product specification from a pitch.' +publishedAt: '2026-06-12T00:00:00Z' +--- + +```prompt +Convert the pitch into PRODUCT_SPEC.md content. + +Include: +- product definition +- user journey +- core message +- information architecture +- page responsibilities + +Stay aligned with the existing framework. +``` diff --git a/src/content/prompts/task-generation.mdx b/src/content/prompts/task-generation.mdx new file mode 100644 index 0000000..947c2be --- /dev/null +++ b/src/content/prompts/task-generation.mdx @@ -0,0 +1,18 @@ +--- +title: 'Task Generation' +version: 'v1' +description: 'Prompt starter for generating task files from approved architecture.' +publishedAt: '2026-06-12T00:00:00Z' +--- + +```prompt +Generate TASKS.md from the approved product specification and architecture. + +Requirements: +- one task per deliverable +- explicit execution order +- no future work +- no speculative scope + +Output only the task list. +``` diff --git a/src/content/showcase/index.mdx b/src/content/showcase/index.mdx index cb54c94..b7fd1e8 100644 --- a/src/content/showcase/index.mdx +++ b/src/content/showcase/index.mdx @@ -1,17 +1,23 @@ --- title: 'Showcase' version: 'v1' -description: 'Showcase는 마케팅이 아니라 Proof of Adoption입니다.' -publishedAt: '2026-06-07T00:00:00Z' +description: 'REPL Works Compatible Projects.' +publishedAt: '2026-06-12T00:00:00Z' --- -실제 프로젝트 사례와 도입 패턴을 통해 REPL Works가 어떻게 적용되는지 보여줍니다. +## Purpose -## Projects +Show compatible projects that use the REPL Works framework in practice. -- [**REPL Works Website**](/showcase/repl-works-website) — REPL Works 자체의 레퍼런스 구현입니다. -- [**ETERNOps**](/showcase/eternops) — 공개 프로젝트 사례로서 Git-first 기억 체계를 보여줍니다. -- [**ETERN Labs**](/showcase/etern-labs) — 아키텍처 일관성과 모델 독립성을 강조하는 공개 사례입니다. -- [**ClayTube**](/showcase/claytube) — 장기 지속성과 세션 복구를 중심으로 적용된 공개 사례입니다. -- [**MMA**](/showcase/mma) — 비공개 프로젝트 사례로, 웹사이트 정보만 제공되고 저장소는 공개되지 않습니다. -- [**WIFI Note**](/showcase/wifi-note) — 비공개 프로젝트 사례로, 프로젝트명만 공유합니다. +## Compatible Projects + +- [REPL Works Website](/showcase/repl-works-website) +- [ETERNOps](/showcase/eternops) +- [ETERN Labs](/showcase/etern-labs) +- [ClayTube](/showcase/claytube) +- [MMA](/showcase/mma) +- [WIFI Note](/showcase/wifi-note) + +## Entry Structure + +Showcase entries should support overview, why REPL Works, documents used, and lessons learned. diff --git a/src/content/showcase/repl-works-website.mdx b/src/content/showcase/repl-works-website.mdx index 3e8ec70..b2e7a82 100644 --- a/src/content/showcase/repl-works-website.mdx +++ b/src/content/showcase/repl-works-website.mdx @@ -1,24 +1,29 @@ --- title: 'REPL Works 웹사이트' version: 'v1' -description: '이 웹사이트는 REPL Works의 레퍼런스 구현입니다.' -publishedAt: '2026-06-07T00:00:00Z' +description: 'REPL Works itself as a compatible project and reference implementation.' +publishedAt: '2026-06-12T00:00:00Z' --- -## REPL Works 적용 방식 +## Overview -- 사이트는 `src/content`의 콘텐츠 컬렉션으로 구성되어 있습니다. -- 핵심 섹션은 MDX 문서로 게시됩니다: Manifesto, Specification, Workflow, Resources, Showcase. -- 사이트 셸과 라우팅은 정적 문서 콘텐츠에 의해 구동됩니다. +The REPL Works website is the reference implementation for the framework. -## AGENTS / ARCHITECTURE / TASKS 매핑 +## Why REPL Works -- **AGENTS**는 콘텐츠 우선 프로세스를 통해 문서화된 작업 단위와 프로젝트 기억으로 표현됩니다. -- **ARCHITECTURE**는 `ARCHITECTURE.md`에 캡처되어 사이트 구조와 탐색에 반영됩니다. -- **TASKS**는 `TASKS.md`에서 추적되며, 각 단계는 하나의 프롬프트와 하나의 커밋 단위입니다. +It demonstrates how content-first, Git-native documentation can preserve product memory across sessions and model changes. -## 워크플로 도입 증거 +## Documents Used -- 콘텐츠는 태스크 단계별로 점진적으로 게시되어 문서화 워크플로를 입증합니다. -- 이 사이트는 Git-first 기억 모델을 사용하며 모든 결정과 출력은 버전 관리된 파일에 저장됩니다. -- Resources와 Showcase 섹션은 실용적 사용과 채택 증거를 문서화하여 워크플로가 실제로 작동함을 보여줍니다. +- `IDEAS.md` +- `PITCHING_SCRIPT.md` +- `PRODUCT_SPEC.md` +- `ARCHITECTURE.md` +- `TASKS.md` +- `AGENTS.md` + +## Lessons Learned + +- The website must stay content-first. +- Planning and execution work better when separated. +- Markdown documents reduce context overhead and make continuity explicit. diff --git a/src/content/tools/ai-issue.mdx b/src/content/tools/ai-issue.mdx new file mode 100644 index 0000000..c6aabc5 --- /dev/null +++ b/src/content/tools/ai-issue.mdx @@ -0,0 +1,22 @@ +--- +title: 'ai-issue' +version: 'v1' +description: 'Issue-shaped workflow asset for AI-native product development.' +publishedAt: '2026-06-12T00:00:00Z' +--- + +## Purpose + +Convert product work into issue-ready structure that an execution AI can implement. + +## Installation + +Use the framework assets directly in a Git-backed REPL Works project. + +## Usage + +Apply `ai-issue` when a task needs a clean issue description, clear acceptance criteria, and execution boundaries. + +## Repository Link + +This tool is a framework asset and can be mirrored into compatible project repositories. diff --git a/src/content/tools/index.mdx b/src/content/tools/index.mdx new file mode 100644 index 0000000..1fb0077 --- /dev/null +++ b/src/content/tools/index.mdx @@ -0,0 +1,22 @@ +--- +title: 'Tools' +version: 'v1' +description: 'REPL Works ecosystem tools and framework assets.' +publishedAt: '2026-06-12T00:00:00Z' +--- + +## Purpose + +Provide REPL Works ecosystem tools as framework assets. + +## Initial Tool + +- [ai-issue](/tools/ai-issue) + +## Future Tools + +- ai-prompt + +## Structure + +Tools are organized as reusable assets, not standalone products. diff --git a/src/content/workflow/index.mdx b/src/content/workflow/index.mdx new file mode 100644 index 0000000..0b1d410 --- /dev/null +++ b/src/content/workflow/index.mdx @@ -0,0 +1,50 @@ +--- +title: 'Workflow' +version: 'v1' +description: 'The current REPL Works process for AI-native product development.' +publishedAt: '2026-06-12T00:00:00Z' +--- + +## Purpose + +Explain the latest REPL Works process from idea refinement through operation. + +## Workflow + +```text +IDEAS.md +↓ +PITCHING_SCRIPT.md +↓ +PRODUCT_SPEC.md +↓ +ARCHITECTURE.md +↓ +TASKS.md +↓ +AGENTS.md +↓ +Planning AI +↓ +Issue +↓ +Execution AI +↓ +PR +↓ +Human Review +↓ +Merge +↓ +Operation +``` + +## Roles + +- Planning AI defines the work and updates the project memory documents. +- Execution AI implements the approved task. +- Human Review approves the result before merge. + +## Continuity + +The process is designed to preserve project memory across sessions and model changes. diff --git a/src/lib/site.ts b/src/lib/site.ts index eb4bd07..fcea1ad 100644 --- a/src/lib/site.ts +++ b/src/lib/site.ts @@ -1,39 +1,40 @@ export const contentCollections = [ - 'manifesto', - 'specification', 'workflow', - 'resources', + 'prompts', + 'documents', + 'tools', 'showcase', + 'faq', ] as const; export type ContentCollection = (typeof contentCollections)[number]; export const navItems = [ { title: 'Home', href: '/' }, - { title: 'Why', href: '/why' }, - { title: 'Manifesto', href: '/manifesto' }, - { title: 'Specification', href: '/specification' }, { title: 'Workflow', href: '/workflow' }, - { title: 'Resources', href: '/resources' }, + { title: 'Prompts', href: '/prompts' }, + { title: 'Documents', href: '/documents' }, + { title: 'Tools', href: '/tools' }, { title: 'Showcase', href: '/showcase' }, - { title: 'Search', href: '/search' }, + { title: 'FAQ', href: '/faq' }, ] as const; export const collectionTitles: Record = { - manifesto: 'Manifesto', - specification: 'Specification', workflow: 'Workflow', - resources: 'Resources', + prompts: 'Prompts', + documents: 'Documents', + tools: 'Tools', showcase: 'Showcase', + faq: 'FAQ', }; export const collectionDescriptions: Record = { - manifesto: 'A shared manifesto for REPL Works and AI development.', - specification: - 'The specification framework for the REPL Works documentation platform.', workflow: 'The workflow and process guidance for using REPL Works.', - resources: 'Curated resources to support REPL Works adoption.', - showcase: 'Proof of adoption and showcase examples for REPL Works.', + prompts: 'Reusable prompts for AI-native product development.', + documents: 'Reusable document standards for the REPL Works framework.', + tools: 'REPL Works ecosystem tools and framework assets.', + showcase: 'REPL Works compatible projects and adoption examples.', + faq: 'Answers to recurring questions about REPL Works.', }; export function isContentCollection(value: string): value is ContentCollection { diff --git a/src/pages/index.astro b/src/pages/index.astro index 8f491b2..bae8d8d 100644 --- a/src/pages/index.astro +++ b/src/pages/index.astro @@ -4,121 +4,89 @@ import SiteLayout from '../layouts/SiteLayout.astro';
-
-

- Project Memory System +

+

+ AI-Native Product Development Framework

-

- REPL Works +

+ Build projects that remember.

- AI Development는 프로젝트를 위한 지속 가능한 기억을 필요로 합니다. - Models forget. Projects must not. + REPL Works keeps product work durable with project memory, model independence, Git-native development, context compression, and long-term project continuity.

- 왜 REPL Works인가 + Learn the Workflow - 선언문 읽기 + View GitHub
-
-
-

- 문서 중심의 프로젝트 기억 -

+
+
+

Project Memory

- REPL Works는 프로젝트 기억을 구조화된 문서로 포착하여 팀이 AI - Development를 신뢰할 수 있게 관리하도록 돕는 Documentation - Platform입니다. + Capture decisions, constraints, and intent in durable documents instead of leaving them in chat history.

-
    -
  • 한곳에서 핵심 내용을 읽고 이해합니다.
    • -
  • 왜, 선언문, 스펙, 워크플로를 순서대로 탐색합니다.
    • -
  • 명확하고 최소한의 정보 계층으로 학습합니다.
    • -
- +
+ +
+

Git-Native Development

+

+ Keep product memory in versioned Markdown so every change can be reviewed, committed, and traced. +

+
+ +
+

Context Compression

+

+ Compress project history into the smallest set of documents needed for the next decision or task. +

+
+ +
+

Long-Term Continuity

+

+ Preserve momentum across sessions, contributors, and release cycles without rebuilding context from scratch. +

+
-

- 깃허브 -

-

- 프로젝트 기억 공개 예정 -

-

- 이 사이트와 프로젝트 문서는 Git 기반으로 관리되며, 향후 공개 저장소 - 링크를 통해 더 많은 증거를 제시할 예정입니다. +

Start with the workflow

+

+ The best entry point is the workflow, because it shows how REPL Works moves from idea refinement to operation through documents, planning AI, execution AI, and human review.

- - - GitHub 링크 - - + + Workflow + + + Documents + + + Prompts +
diff --git a/src/pages/search.astro b/src/pages/search.astro index 06b4021..36e7756 100644 --- a/src/pages/search.astro +++ b/src/pages/search.astro @@ -4,24 +4,23 @@ import Search from 'astro-pagefind/components/Search.astro'; ---

- Search docs + Search

- REPL Works 문서 내용 전체 검색 + Search the REPL Works content library

- Pagefind 기반의 전체 정적 검색 기능으로 매니페스토, 사양(스펙), - 워크플로우, 리소스 및 쇼케이스 콘텐츠를 찾아보세요. + Pagefind indexes the framework content so you can find workflow, prompts, documents, tools, showcase, and FAQ pages quickly.

diff --git a/src/pages/why.astro b/src/pages/why.astro index 7c2e357..be5da60 100644 --- a/src/pages/why.astro +++ b/src/pages/why.astro @@ -4,7 +4,7 @@ import SiteLayout from '../layouts/SiteLayout.astro';

- 선언문에서 해결 방법을 확인하세요. + 워크플로에서 해결 방법을 확인하세요.

- 이 문제가 현실적이라면, 장기적인 프로젝트 기억을 가능하게 하는 원칙을 - 이해하는 것이 다음 단계입니다. + 이제는 REPL Works의 최신 워크플로가 공식 진입점입니다.

- 선언문 읽기 + Workflow 보기