From ba30b56e36258f9c30f7d3b8f4fab9adbf864810 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Sat, 13 Jun 2026 00:49:34 +0900 Subject: [PATCH 1/3] chore: replace `Planning AI` with `Discussion AI` --- PRODUCT_SPEC.md | 2 +- TASKS.md | 2 +- src/content/documents/architecture.mdx | 2 +- src/content/documents/example-tasks.mdx | 2 +- src/content/documents/framework.mdx | 2 +- src/content/documents/ideas.mdx | 2 +- src/content/documents/pitching-script.mdx | 2 +- src/content/documents/product-spec.mdx | 2 +- src/content/showcase/ai-issue.mdx | 6 +++--- src/content/showcase/repl-works-website.mdx | 4 ++-- src/content/workflow/index.mdx | 8 ++++---- 11 files changed, 17 insertions(+), 17 deletions(-) diff --git a/PRODUCT_SPEC.md b/PRODUCT_SPEC.md index 2e66067..c23fa22 100644 --- a/PRODUCT_SPEC.md +++ b/PRODUCT_SPEC.md @@ -243,7 +243,7 @@ Continuous Improvement Must explain: ```text -Planning AI +Discussion AI Execution AI diff --git a/TASKS.md b/TASKS.md index fe48471..110ef4e 100644 --- a/TASKS.md +++ b/TASKS.md @@ -139,7 +139,7 @@ Propose TASK update * [x] T409 Rewrite Workflow documentation * [x] T410 Publish current REPL Works workflow -* [x] T411 Explain Planning AI vs Execution AI +* [x] T411 Explain Discussion AI vs Execution AI * [x] T412 Explain continuous improvement workflow --- diff --git a/src/content/documents/architecture.mdx b/src/content/documents/architecture.mdx index ffa3eed..afc0168 100644 --- a/src/content/documents/architecture.mdx +++ b/src/content/documents/architecture.mdx @@ -112,7 +112,7 @@ TASKS.md는 무엇을 해야 하는지 정의한다. # AI Usage -Planning AI가 반드시 읽어야 하는 문서다. +Discussion AI가 반드시 읽어야 하는 문서다. --- diff --git a/src/content/documents/example-tasks.mdx b/src/content/documents/example-tasks.mdx index 21ff73a..d72e3ff 100644 --- a/src/content/documents/example-tasks.mdx +++ b/src/content/documents/example-tasks.mdx @@ -147,7 +147,7 @@ Propose TASK update * [x] T409 Rewrite Workflow documentation * [x] T410 Publish current REPL Works workflow -* [x] T411 Explain Planning AI vs Execution AI +* [x] T411 Explain Discussion AI vs Execution AI * [x] T412 Explain continuous improvement workflow --- diff --git a/src/content/documents/framework.mdx b/src/content/documents/framework.mdx index 12d332e..b3c44c1 100644 --- a/src/content/documents/framework.mdx +++ b/src/content/documents/framework.mdx @@ -107,7 +107,7 @@ Execution AI가 반드시 읽어야 하는 문서다. --- -Planning AI는 필요 시 참고할 수 있다. +Discussion AI는 필요 시 참고할 수 있다. --- diff --git a/src/content/documents/ideas.mdx b/src/content/documents/ideas.mdx index c6968c1..c1fca15 100644 --- a/src/content/documents/ideas.mdx +++ b/src/content/documents/ideas.mdx @@ -92,7 +92,7 @@ IDEAS.md는 프로젝트의 출발점이다. # AI Usage -IDEAS.md는 주로 Planning AI와 사람이 함께 사용하는 문서다. +IDEAS.md는 주로 Discussion AI와 사람이 함께 사용하는 문서다. --- diff --git a/src/content/documents/pitching-script.mdx b/src/content/documents/pitching-script.mdx index 92cdfb0..c1cc441 100644 --- a/src/content/documents/pitching-script.mdx +++ b/src/content/documents/pitching-script.mdx @@ -89,7 +89,7 @@ PITCHING_SCRIPT.md는 아이디어와 제품 명세 사이를 연결한다. ## AI Usage -PITCHING_SCRIPT.md는 Planning AI와 사람이 함께 사용하는 문서다. +PITCHING_SCRIPT.md는 Discussion AI와 사람이 함께 사용하는 문서다. --- diff --git a/src/content/documents/product-spec.mdx b/src/content/documents/product-spec.mdx index 7525922..37293a3 100644 --- a/src/content/documents/product-spec.mdx +++ b/src/content/documents/product-spec.mdx @@ -108,7 +108,7 @@ TASKS.md는 PRODUCT_SPEC.md를 실현하기 위해 존재한다. # AI Usage -Planning AI가 반드시 읽어야 하는 문서다. +Discussion AI가 반드시 읽어야 하는 문서다. --- diff --git a/src/content/showcase/ai-issue.mdx b/src/content/showcase/ai-issue.mdx index 3a3af76..8e1a67e 100644 --- a/src/content/showcase/ai-issue.mdx +++ b/src/content/showcase/ai-issue.mdx @@ -10,7 +10,7 @@ publishedAt: '2026-06-12T00:00:00Z' AI 이슈 퍼블리셔(AI Issue Publisher 줄여서 `ai-issue`)는 아이디어, 토론, 작업 요청을 실행 가능한 GitHub Issue로 변환하기 위한 도구다. -REPL Works 워크플로에서 Planning AI와 Execution AI 사이를 연결하는 역할을 수행한다. +REPL Works 워크플로에서 Discussion AI와 Execution AI 사이를 연결하는 역할을 수행한다. --- @@ -104,11 +104,11 @@ Execution AI가 바로 사용할 수 있는 프롬프트 역할을 수행한다. --- -### Planning And Execution Should Be Separate +### Discussion And Execution Should Be Separate 계획과 구현을 분리하면 품질이 향상된다. -Planning AI는 무엇을 해야 하는지 정의하고, +Discussion AI는 무엇을 해야 하는지 정의하고, Execution AI는 정의된 작업을 수행한다. diff --git a/src/content/showcase/repl-works-website.mdx b/src/content/showcase/repl-works-website.mdx index 45db764..fb69f42 100644 --- a/src/content/showcase/repl-works-website.mdx +++ b/src/content/showcase/repl-works-website.mdx @@ -71,9 +71,9 @@ AGENTS.md --- -### Planning And Execution Should Be Separate +### Discussion And Execution Should Be Separate -Planning AI와 Execution AI를 분리하면 결과 품질이 높아진다. +Discussion AI와 Execution AI를 분리하면 결과 품질이 높아진다. 문서가 계획을 담당하고, 구현은 문서를 따른다. diff --git a/src/content/workflow/index.mdx b/src/content/workflow/index.mdx index 2f4be16..22a96d7 100644 --- a/src/content/workflow/index.mdx +++ b/src/content/workflow/index.mdx @@ -114,7 +114,7 @@ TASKS.md ↓ AGENTS.md ↓ -Planning AI +Discussion AI ↓ Issue ↓ @@ -357,9 +357,9 @@ AI는 항상 AGENTS.md부터 읽는다. # Phase 6. 계획 수립 -## Planning AI +## Discussion AI -Planning AI는 구현보다 이해에 집중한다. +Discussion AI는 구현보다 이해에 집중한다. --- @@ -567,7 +567,7 @@ REPL Works는 AI-Native Product Development Framework이다. 프로젝트 기억을 Git과 문서에 저장하고, -Planning AI, Execution AI, Human Review를 통해 +Discussion AI, Execution AI, Human Review를 통해 장기적으로 유지 가능한 제품 개발 프로세스를 제공한다. From 1d811dbfece0aa419217763218d0a65616877b7d Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Sat, 13 Jun 2026 00:51:22 +0900 Subject: [PATCH 2/3] chore: run `npm run format` --- TASKS.md | 144 ++++++++--------- docs/IDEAS.md | 24 +-- docs/PITCHING_SCRIPT.md | 10 +- src/content/documents/architecture.mdx | 46 +++--- src/content/documents/example-agents.mdx | 38 ++--- .../documents/example-architecture.mdx | 4 +- src/content/documents/example-ideas-md.mdx | 28 ++-- .../documents/example-pitching-script.mdx | 14 +- .../documents/example-product-spec.mdx | 4 +- src/content/documents/example-tasks.mdx | 146 +++++++++--------- src/content/frameworks/astro.mdx | 4 +- src/content/frameworks/fastapi.mdx | 4 +- src/content/frameworks/golang-cli.mdx | 4 +- src/content/frameworks/nextjs.mdx | 4 +- src/content/frameworks/react-vite.mdx | 8 +- src/content/frameworks/vanilla.mdx | 4 +- src/content/prompts/architecture-design.mdx | 4 +- src/content/prompts/execution-validation.mdx | 4 +- src/content/prompts/product-specification.mdx | 4 +- src/content/prompts/task-generation.mdx | 4 +- src/content/showcase/ai-issue.mdx | 5 +- src/content/showcase/etern-labs.mdx | 1 - src/content/showcase/eternops.mdx | 1 - src/content/showcase/wifi-note.mdx | 5 +- src/pages/index.astro | 90 ++++++++--- src/pages/search.astro | 3 +- 26 files changed, 326 insertions(+), 281 deletions(-) diff --git a/TASKS.md b/TASKS.md index 110ef4e..579f3aa 100644 --- a/TASKS.md +++ b/TASKS.md @@ -76,13 +76,13 @@ Propose TASK update ## FOUNDATION -* [x] T001 Initialize Astro Project -* [x] T002 Configure Tailwind CSS -* [x] T003 Configure Content Collections -* [x] T004 Configure MDX Support -* [x] T005 Configure GitHub Pages Deployment -* [x] T006 Configure Linting and Formatting -* [x] T007 Configure Testing +- [x] T001 Initialize Astro Project +- [x] T002 Configure Tailwind CSS +- [x] T003 Configure Content Collections +- [x] T004 Configure MDX Support +- [x] T005 Configure GitHub Pages Deployment +- [x] T006 Configure Linting and Formatting +- [x] T007 Configure Testing --- @@ -90,11 +90,11 @@ Propose TASK update ## PLATFORM FOUNDATION -* [x] T101 Create Site Shell -* [x] T102 Configure Navigation -* [x] T103 Configure Layout System -* [x] T104 Configure Content Rendering -* [x] T105 Configure Search Infrastructure +- [x] T101 Create Site Shell +- [x] T102 Configure Navigation +- [x] T103 Configure Layout System +- [x] T104 Configure Content Rendering +- [x] T105 Configure Search Infrastructure --- @@ -102,14 +102,14 @@ Propose TASK update ## INITIAL WEBSITE RELEASE -* [x] T201 Create Home Page -* [x] T202 Publish Why Content -* [x] T203 Publish Manifesto -* [x] T204 Publish Specification -* [x] T205 Publish Workflow -* [x] T206 Publish Resources -* [x] T207 Publish Showcase -* [x] T208 Publish FAQ +- [x] T201 Create Home Page +- [x] T202 Publish Why Content +- [x] T203 Publish Manifesto +- [x] T204 Publish Specification +- [x] T205 Publish Workflow +- [x] T206 Publish Resources +- [x] T207 Publish Showcase +- [x] T208 Publish FAQ --- @@ -119,77 +119,77 @@ Propose TASK update ### INFORMATION ARCHITECTURE -* [x] T401 Replace legacy navigation with new navigation structure -* [x] T402 Remove Why section -* [x] T403 Remove Manifesto section -* [x] 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 -* [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 +- [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 -* [x] T409 Rewrite Workflow documentation -* [x] T410 Publish current REPL Works workflow -* [x] T411 Explain Discussion AI vs Execution AI -* [x] T412 Explain continuous improvement workflow +- [x] T409 Rewrite Workflow documentation +- [x] T410 Publish current REPL Works workflow +- [x] T411 Explain Discussion AI vs Execution AI +- [x] T412 Explain continuous improvement workflow --- ### 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 +- [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 -* [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 +- [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 -* [x] T425 Create Tools section -* [x] T426 Publish ai-issue -* [x] T427 Add installation guide -* [x] 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 -* [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 +- [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 -* [x] T433 Rewrite FAQ for framework positioning -* [x] T434 Add compatibility questions -* [x] T435 Add workflow questions -* [x] 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 --- @@ -197,11 +197,11 @@ Propose TASK update ## SEARCH -* [ ] T501 Verify search indexing for Prompts -* [ ] T502 Verify search indexing for Documents -* [ ] T503 Verify search indexing for Tools -* [ ] T504 Verify search indexing for Showcase -* [ ] T505 Verify search indexing for FAQ +- [ ] T501 Verify search indexing for Prompts +- [ ] T502 Verify search indexing for Documents +- [ ] T503 Verify search indexing for Tools +- [ ] T504 Verify search indexing for Showcase +- [ ] T505 Verify search indexing for FAQ --- @@ -209,12 +209,12 @@ Propose TASK update ## CONTENT REVIEW -* [x] T601 Review Workflow content -* [x] T602 Review Prompt content -* [x] T603 Review Document content -* [x] T604 Review Tool content -* [x] T605 Review Showcase content -* [ ] T605 Review FAQ content +- [x] T601 Review Workflow content +- [x] T602 Review Prompt content +- [x] T603 Review Document content +- [x] T604 Review Tool content +- [x] T605 Review Showcase content +- [ ] T605 Review FAQ content --- @@ -222,11 +222,11 @@ Propose TASK update ## RELEASE -* [ ] T701 Responsive Review -* [ ] T702 Accessibility Review -* [ ] T703 Search Verification -* [ ] T704 GitHub Pages Verification -* [ ] T705 Release v2 +- [ ] T701 Responsive Review +- [ ] T702 Accessibility Review +- [ ] T703 Search Verification +- [ ] T704 GitHub Pages Verification +- [ ] T705 Release v2 --- diff --git a/docs/IDEAS.md b/docs/IDEAS.md index 8667f46..057895f 100644 --- a/docs/IDEAS.md +++ b/docs/IDEAS.md @@ -61,12 +61,12 @@ REPL Works는 이 문제의 원인이 AI의 지능 부족이 아니라고 믿는 프로젝트 지식은 다음 위치에 흩어진다. -* Chat History -* Prompt -* Context Window -* Agent Runtime -* 개인 메모 -* 운영 경험 +- Chat History +- Prompt +- Context Window +- Agent Runtime +- 개인 메모 +- 운영 경험 --- @@ -82,12 +82,12 @@ REPL Works는 이 문제의 원인이 AI의 지능 부족이 아니라고 믿는 결과적으로 다음 문제가 발생한다. -* 프로젝트 의도가 유지되지 않는다. -* 동일한 실수를 반복한다. -* 중요한 의사결정이 소실된다. -* 아키텍처가 드리프트한다. -* 운영 경험이 축적되지 않는다. -* 프로젝트가 특정 사람 또는 특정 세션에 종속된다. +- 프로젝트 의도가 유지되지 않는다. +- 동일한 실수를 반복한다. +- 중요한 의사결정이 소실된다. +- 아키텍처가 드리프트한다. +- 운영 경험이 축적되지 않는다. +- 프로젝트가 특정 사람 또는 특정 세션에 종속된다. --- diff --git a/docs/PITCHING_SCRIPT.md b/docs/PITCHING_SCRIPT.md index 7becad8..a01dd82 100644 --- a/docs/PITCHING_SCRIPT.md +++ b/docs/PITCHING_SCRIPT.md @@ -102,11 +102,11 @@ AI의 능력 부족이라고 생각한다. 프로젝트 지식은 다음 위치에 흩어진다. -* Chat History -* Prompt -* Context Window -* Agent Runtime -* 개인 메모 +- Chat History +- Prompt +- Context Window +- Agent Runtime +- 개인 메모 --- diff --git a/src/content/documents/architecture.mdx b/src/content/documents/architecture.mdx index afc0168..fc61928 100644 --- a/src/content/documents/architecture.mdx +++ b/src/content/documents/architecture.mdx @@ -35,11 +35,11 @@ ARCHITECTURE.md는 프로젝트의 기술적 진실(Source of Truth)이다. 일반적으로 다음 정보를 기반으로 작성한다. -* PRODUCT_SPEC.md -* 선택된 기술 스택 -* 프로젝트 요구사항 -* 운영 제약 -* 배포 환경 +- PRODUCT_SPEC.md +- 선택된 기술 스택 +- 프로젝트 요구사항 +- 운영 제약 +- 배포 환경 --- @@ -47,14 +47,14 @@ ARCHITECTURE.md는 프로젝트의 기술적 진실(Source of Truth)이다. 다음 내용을 정의한다. -* 시스템 구조 -* 저장소 구조 -* 콘텐츠 구조 -* 라우팅 구조 -* 데이터 흐름 -* 모듈 구조 -* 구현 경계 -* 운영 제약 +- 시스템 구조 +- 저장소 구조 +- 콘텐츠 구조 +- 라우팅 구조 +- 데이터 흐름 +- 모듈 구조 +- 구현 경계 +- 운영 제약 --- @@ -134,11 +134,11 @@ ARCHITECTURE.md는 일반적으로 다음 프롬프트를 통해 생성한다. Architecture Design Prompt는 다음을 수행한다. -* 저장소 구조 설계 -* 콘텐츠 구조 설계 -* 라우팅 설계 -* 구현 경계 정의 -* 운영 제약 정의 +- 저장소 구조 설계 +- 콘텐츠 구조 설계 +- 라우팅 설계 +- 구현 경계 정의 +- 운영 제약 정의 --- @@ -152,11 +152,11 @@ Architecture Design Prompt는 다음을 수행한다. 예시는 다음 내용을 포함한다. -* 시스템 구조 -* 콘텐츠 구조 -* 라우팅 구조 -* 모듈 구조 -* 제약 사항 +- 시스템 구조 +- 콘텐츠 구조 +- 라우팅 구조 +- 모듈 구조 +- 제약 사항 --- diff --git a/src/content/documents/example-agents.mdx b/src/content/documents/example-agents.mdx index 759449b..a9a32d6 100644 --- a/src/content/documents/example-agents.mdx +++ b/src/content/documents/example-agents.mdx @@ -5,7 +5,7 @@ description: 'ReplWorks가 제공하는 AGENTS.md 입니다.' publishedAt: '2026-06-12T00:00:00Z' --- -``````markdown +````markdown # AGENTS.md ## DOCUMENT_ORDER @@ -113,11 +113,11 @@ Implement only the selected task. Do not implement: -* future work -* roadmap items -* optional features -* assumptions -* inferred requirements +- future work +- roadmap items +- optional features +- assumptions +- inferred requirements Requirements must originate from: @@ -202,15 +202,15 @@ Update TASKS.md. Prefer: -* simple -* explicit -* minimal +- simple +- explicit +- minimal Avoid: -* abstraction without use -* premature optimization -* speculative features +- abstraction without use +- premature optimization +- speculative features --- @@ -226,12 +226,12 @@ Prefer modifying existing files. Task is complete only when: -* product requirements satisfied -* architectural requirements satisfied -* framework constraints satisfied -* acceptance criteria satisfied -* code runs -* tests pass +- product requirements satisfied +- architectural requirements satisfied +- framework constraints satisfied +- acceptance criteria satisfied +- code runs +- tests pass Then stop. -`````` +```` diff --git a/src/content/documents/example-architecture.mdx b/src/content/documents/example-architecture.mdx index 6e2fe36..88e9cc4 100644 --- a/src/content/documents/example-architecture.mdx +++ b/src/content/documents/example-architecture.mdx @@ -5,7 +5,7 @@ description: '아키텍쳐 prompt로 만든 AGENTS.md 입니다.' publishedAt: '2026-06-12T00:00:00Z' --- -``````markdown +````markdown # ARCHITECTURE.md Version 3.0 @@ -639,4 +639,4 @@ Long-Term Maintainability REPL Works Adoption ``` -`````` +```` diff --git a/src/content/documents/example-ideas-md.mdx b/src/content/documents/example-ideas-md.mdx index 163aacd..81fd4d5 100644 --- a/src/content/documents/example-ideas-md.mdx +++ b/src/content/documents/example-ideas-md.mdx @@ -5,7 +5,7 @@ description: '아이디어 정제 Prompt로 만든 IDEAS.md 예시입니다.' publishedAt: '2026-06-12T00:00:00Z' --- -``````markdown +````markdown # IDEAS.md Version 4.0 @@ -69,12 +69,12 @@ REPL Works는 이 문제의 원인이 AI의 지능 부족이 아니라고 믿는 프로젝트 지식은 다음 위치에 흩어진다. -* Chat History -* Prompt -* Context Window -* Agent Runtime -* 개인 메모 -* 운영 경험 +- Chat History +- Prompt +- Context Window +- Agent Runtime +- 개인 메모 +- 운영 경험 --- @@ -90,12 +90,12 @@ REPL Works는 이 문제의 원인이 AI의 지능 부족이 아니라고 믿는 결과적으로 다음 문제가 발생한다. -* 프로젝트 의도가 유지되지 않는다. -* 동일한 실수를 반복한다. -* 중요한 의사결정이 소실된다. -* 아키텍처가 드리프트한다. -* 운영 경험이 축적되지 않는다. -* 프로젝트가 특정 사람 또는 특정 세션에 종속된다. +- 프로젝트 의도가 유지되지 않는다. +- 동일한 실수를 반복한다. +- 중요한 의사결정이 소실된다. +- 아키텍처가 드리프트한다. +- 운영 경험이 축적되지 않는다. +- 프로젝트가 특정 사람 또는 특정 세션에 종속된다. --- @@ -510,4 +510,4 @@ Project continuity must be preserved. Models forget. Projects must continue. -`````` +```` diff --git a/src/content/documents/example-pitching-script.mdx b/src/content/documents/example-pitching-script.mdx index 2e0c0a7..79c269f 100644 --- a/src/content/documents/example-pitching-script.mdx +++ b/src/content/documents/example-pitching-script.mdx @@ -5,7 +5,7 @@ description: '피치 작성 Prompt로 만든 PITCHING_SCRIPT.md 예시입니다. publishedAt: '2026-06-12T00:00:00Z' --- -``````markdown +````markdown # PITCHING_SCRIPT.md Version 3.0 @@ -110,11 +110,11 @@ AI의 능력 부족이라고 생각한다. 프로젝트 지식은 다음 위치에 흩어진다. -* Chat History -* Prompt -* Context Window -* Agent Runtime -* 개인 메모 +- Chat History +- Prompt +- Context Window +- Agent Runtime +- 개인 메모 --- @@ -367,4 +367,4 @@ Project continuity must be preserved. Models forget. Projects continue. -`````` +```` diff --git a/src/content/documents/example-product-spec.mdx b/src/content/documents/example-product-spec.mdx index 87a3bfd..fa5b030 100644 --- a/src/content/documents/example-product-spec.mdx +++ b/src/content/documents/example-product-spec.mdx @@ -5,6 +5,6 @@ description: '제품 명세 Prompt로 만든 PRODUCT_SPEC.md 예시입니다.' publishedAt: '2026-06-12T00:00:00Z' --- -``````markdown +```markdown 준비 중... -`````` +``` diff --git a/src/content/documents/example-tasks.mdx b/src/content/documents/example-tasks.mdx index d72e3ff..0563672 100644 --- a/src/content/documents/example-tasks.mdx +++ b/src/content/documents/example-tasks.mdx @@ -5,7 +5,7 @@ description: '제품 명세 Prompt로 만든 TASKS.md 예시입니다.' publishedAt: '2026-06-12T00:00:00Z' --- -``````markdown +````markdown # TASKS.md Version 4.0 @@ -84,13 +84,13 @@ Propose TASK update ## FOUNDATION -* [x] T001 Initialize Astro Project -* [x] T002 Configure Tailwind CSS -* [x] T003 Configure Content Collections -* [x] T004 Configure MDX Support -* [x] T005 Configure GitHub Pages Deployment -* [x] T006 Configure Linting and Formatting -* [x] T007 Configure Testing +- [x] T001 Initialize Astro Project +- [x] T002 Configure Tailwind CSS +- [x] T003 Configure Content Collections +- [x] T004 Configure MDX Support +- [x] T005 Configure GitHub Pages Deployment +- [x] T006 Configure Linting and Formatting +- [x] T007 Configure Testing --- @@ -98,11 +98,11 @@ Propose TASK update ## PLATFORM FOUNDATION -* [x] T101 Create Site Shell -* [x] T102 Configure Navigation -* [x] T103 Configure Layout System -* [x] T104 Configure Content Rendering -* [x] T105 Configure Search Infrastructure +- [x] T101 Create Site Shell +- [x] T102 Configure Navigation +- [x] T103 Configure Layout System +- [x] T104 Configure Content Rendering +- [x] T105 Configure Search Infrastructure --- @@ -110,14 +110,14 @@ Propose TASK update ## INITIAL WEBSITE RELEASE -* [x] T201 Create Home Page -* [x] T202 Publish Why Content -* [x] T203 Publish Manifesto -* [x] T204 Publish Specification -* [x] T205 Publish Workflow -* [x] T206 Publish Resources -* [x] T207 Publish Showcase -* [x] T208 Publish FAQ +- [x] T201 Create Home Page +- [x] T202 Publish Why Content +- [x] T203 Publish Manifesto +- [x] T204 Publish Specification +- [x] T205 Publish Workflow +- [x] T206 Publish Resources +- [x] T207 Publish Showcase +- [x] T208 Publish FAQ --- @@ -127,77 +127,77 @@ Propose TASK update ### INFORMATION ARCHITECTURE -* [x] T401 Replace legacy navigation with new navigation structure -* [x] T402 Remove Why section -* [x] T403 Remove Manifesto section -* [x] 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 -* [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 +- [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 -* [x] T409 Rewrite Workflow documentation -* [x] T410 Publish current REPL Works workflow -* [x] T411 Explain Discussion AI vs Execution AI -* [x] T412 Explain continuous improvement workflow +- [x] T409 Rewrite Workflow documentation +- [x] T410 Publish current REPL Works workflow +- [x] T411 Explain Discussion AI vs Execution AI +- [x] T412 Explain continuous improvement workflow --- ### 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 +- [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 -* [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 +- [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 -* [x] T425 Create Tools section -* [x] T426 Publish ai-issue -* [x] T427 Add installation guide -* [x] 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 -* [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 +- [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 -* [x] T433 Rewrite FAQ for framework positioning -* [x] T434 Add compatibility questions -* [x] T435 Add workflow questions -* [x] 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 --- @@ -205,11 +205,11 @@ Propose TASK update ## SEARCH -* [ ] T501 Verify search indexing for Prompts -* [ ] T502 Verify search indexing for Documents -* [ ] T503 Verify search indexing for Tools -* [ ] T504 Verify search indexing for Showcase -* [ ] T505 Verify search indexing for FAQ +- [ ] T501 Verify search indexing for Prompts +- [ ] T502 Verify search indexing for Documents +- [ ] T503 Verify search indexing for Tools +- [ ] T504 Verify search indexing for Showcase +- [ ] T505 Verify search indexing for FAQ --- @@ -217,11 +217,11 @@ Propose TASK update ## CONTENT REVIEW -* [ ] T601 Review Workflow content -* [ ] T602 Review Prompt content -* [ ] T603 Review Document content -* [ ] T604 Review Tool content -* [ ] T605 Review Showcase content +- [ ] T601 Review Workflow content +- [ ] T602 Review Prompt content +- [ ] T603 Review Document content +- [ ] T604 Review Tool content +- [ ] T605 Review Showcase content --- @@ -229,11 +229,11 @@ Propose TASK update ## RELEASE -* [ ] T701 Responsive Review -* [ ] T702 Accessibility Review -* [ ] T703 Search Verification -* [ ] T704 GitHub Pages Verification -* [ ] T705 Release v2 +- [ ] T701 Responsive Review +- [ ] T702 Accessibility Review +- [ ] T703 Search Verification +- [ ] T704 GitHub Pages Verification +- [ ] T705 Release v2 --- @@ -256,4 +256,4 @@ Review ARCHITECTURE.md If architecture changed: Update ARCHITECTURE.md -`````` +```` diff --git a/src/content/frameworks/astro.mdx b/src/content/frameworks/astro.mdx index c290999..66cc101 100644 --- a/src/content/frameworks/astro.mdx +++ b/src/content/frameworks/astro.mdx @@ -5,7 +5,7 @@ description: 'ReplWorks에서 제공하는 ASTRO.md framework 파일' publishedAt: '2026-06-12T00:00:00Z' --- -``````markdown +````markdown # ASTRO.md ## STACK @@ -308,4 +308,4 @@ USE_ISLANDS_ARCHITECTURE MINIMIZE_JAVASCRIPT HYDRATE_ONLY_WHEN_NECESSARY -`````` +```` diff --git a/src/content/frameworks/fastapi.mdx b/src/content/frameworks/fastapi.mdx index 470ae2c..dcf4235 100644 --- a/src/content/frameworks/fastapi.mdx +++ b/src/content/frameworks/fastapi.mdx @@ -5,7 +5,7 @@ description: 'ReplWorks에서 제공하는 FASTAPI.md framework 파일' publishedAt: '2026-06-12T00:00:00Z' --- -``````markdown +````markdown # FASTAPI.md ## STACK @@ -265,4 +265,4 @@ NO_ARCHITECTURAL_GUESSING REUSE_BEFORE_CREATING KEEP_IT_SIMPLE -`````` +```` diff --git a/src/content/frameworks/golang-cli.mdx b/src/content/frameworks/golang-cli.mdx index e48e5c4..9bd6a4b 100644 --- a/src/content/frameworks/golang-cli.mdx +++ b/src/content/frameworks/golang-cli.mdx @@ -5,7 +5,7 @@ description: 'ReplWorks에서 제공하는 GOLANG-CLI.md framework 파일' publishedAt: '2026-06-12T00:00:00Z' --- -``````markdown +````markdown # GOLANG-CLI.md # AI Issue Publisher Framework @@ -412,4 +412,4 @@ Single Binary CLI ``` Any implementation that violates these invariants is incorrect. -`````` +```` diff --git a/src/content/frameworks/nextjs.mdx b/src/content/frameworks/nextjs.mdx index dc4616c..6614ce2 100644 --- a/src/content/frameworks/nextjs.mdx +++ b/src/content/frameworks/nextjs.mdx @@ -5,7 +5,7 @@ description: 'ReplWorks에서 제공하는 NEXTJS.md framework 파일' publishedAt: '2026-06-12T00:00:00Z' --- -``````markdown +````markdown # NEXTJS.md ## STACK @@ -335,4 +335,4 @@ RESPONSIVE_BY_DEFAULT ACCESSIBLE_BY_DEFAULT REUSE_BEFORE_CREATING -`````` +```` diff --git a/src/content/frameworks/react-vite.mdx b/src/content/frameworks/react-vite.mdx index a94dd39..e4276b8 100644 --- a/src/content/frameworks/react-vite.mdx +++ b/src/content/frameworks/react-vite.mdx @@ -5,7 +5,7 @@ description: 'ReplWorks에서 제공하는 REACT_VITE.md framework 파일' publishedAt: '2026-06-12T00:00:00Z' --- -``````markdown +````markdown # REACT_VITE.md ## STACK @@ -266,7 +266,7 @@ EXAMPLE Component ```jsx -__("회원가입"); +__('회원가입'); ``` Translation @@ -286,7 +286,7 @@ WHEN_ADDING_NEW_TEXT FORBIDDEN ```jsx -t("auth.register.button"); +t('auth.register.button'); ``` ```json @@ -340,4 +340,4 @@ TASKS_MD_OVERRIDES_ASSUMPTIONS PACKAGE_JSON_OVERRIDES_VERSION_ASSUMPTIONS DO_NOT_GUESS -`````` +```` diff --git a/src/content/frameworks/vanilla.mdx b/src/content/frameworks/vanilla.mdx index fa9c518..e84cbb1 100644 --- a/src/content/frameworks/vanilla.mdx +++ b/src/content/frameworks/vanilla.mdx @@ -5,7 +5,7 @@ description: 'ReplWorks에서 제공하는 VANILLA.md framework 파일' publishedAt: '2026-06-12T00:00:00Z' --- -``````markdown +````markdown # VANILLA.md ## STACK @@ -267,4 +267,4 @@ KEEP_IT_SIMPLE AVOID_DEPENDENCIES DO_NOT_INTRODUCE_FRAMEWORKS -`````` +```` diff --git a/src/content/prompts/architecture-design.mdx b/src/content/prompts/architecture-design.mdx index d3fa38a..329ae1f 100644 --- a/src/content/prompts/architecture-design.mdx +++ b/src/content/prompts/architecture-design.mdx @@ -35,7 +35,7 @@ AI는 제품 요구사항을 만족할 수 있는 기술 구조를 설계해야 # 프롬프트 -``````prompt +````prompt Generate ARCHITECTURE.md. Assume PRODUCT_SPEC.md already exists and is correct. @@ -97,4 +97,4 @@ Prefer clear ownership over abstraction. Optimize for implementation certainty. The document is intended for AI implementation, not human documentation. -`````` +```` diff --git a/src/content/prompts/execution-validation.mdx b/src/content/prompts/execution-validation.mdx index d9340e6..a53adf0 100644 --- a/src/content/prompts/execution-validation.mdx +++ b/src/content/prompts/execution-validation.mdx @@ -39,7 +39,7 @@ AI는 구현 결과를 PRODUCT_SPEC.md, ARCHITECTURE.md, TASKS.md와 비교하 # 프롬프트 -``````prompt +````prompt Review the following documents together: - PRODUCT_SPEC.md @@ -97,4 +97,4 @@ Implementation can begin with high confidence. ``` Optimize for implementation certainty. -`````` +```` diff --git a/src/content/prompts/product-specification.mdx b/src/content/prompts/product-specification.mdx index 0237b77..7af6d91 100644 --- a/src/content/prompts/product-specification.mdx +++ b/src/content/prompts/product-specification.mdx @@ -35,7 +35,7 @@ AI는 프로젝트의 목적을 기반으로 제품 관점에서 요구사항을 ## 프롬프트 -``````prompt +````prompt Generate PRODUCT_SPEC.md. Assume all product discovery and idea validation are already complete. @@ -97,4 +97,4 @@ Prefer explicit requirements over explanations. Optimize for implementation certainty. The document is intended for AI implementation, not human marketing. -`````` +```` diff --git a/src/content/prompts/task-generation.mdx b/src/content/prompts/task-generation.mdx index d579a34..b58c049 100644 --- a/src/content/prompts/task-generation.mdx +++ b/src/content/prompts/task-generation.mdx @@ -31,7 +31,7 @@ AI는 PRODUCT_SPEC.md와 ARCHITECTURE.md 요구사항을 지키는 TASKS를 체 ## Prompt -``````prompt +````prompt # TASKS_PROMPT.md Generate TASKS.md. @@ -103,4 +103,4 @@ A task is complete only when acceptance criteria are satisfied. Optimize for autonomous execution by AI systems. The document is intended for AI implementation, not human project management. -`````` +```` diff --git a/src/content/showcase/ai-issue.mdx b/src/content/showcase/ai-issue.mdx index 8e1a67e..b3db22f 100644 --- a/src/content/showcase/ai-issue.mdx +++ b/src/content/showcase/ai-issue.mdx @@ -1,10 +1,11 @@ --- - title: 'AI 이슈 퍼블리셔(AI Issue Publisher)' version: 'v1' description: 'AI와의 토론을 바로 실행 가능한 Github Issue로 변환해 주는 REPL Works 호환 도구.' publishedAt: '2026-06-12T00:00:00Z' ------------------------------------ +--- + +--- ## Overview diff --git a/src/content/showcase/etern-labs.mdx b/src/content/showcase/etern-labs.mdx index 8cdbfe8..606c1f2 100644 --- a/src/content/showcase/etern-labs.mdx +++ b/src/content/showcase/etern-labs.mdx @@ -1,5 +1,4 @@ --- - title: '이턴랩스(ETERN Labs)' version: 'v1' description: '이턴랩스(ETERN Labs)는 새로운 아이디어와 제품을 실험하고 검증하기 위한 ReplWorks 호환 프로젝트다.' diff --git a/src/content/showcase/eternops.mdx b/src/content/showcase/eternops.mdx index e138154..a5bde42 100644 --- a/src/content/showcase/eternops.mdx +++ b/src/content/showcase/eternops.mdx @@ -1,5 +1,4 @@ --- - title: '이터놉스(ETERNOps)' version: 'v1' description: '장기간 운영에 포커스를 맞춘 ReplWorks 호환 프로젝트.' diff --git a/src/content/showcase/wifi-note.mdx b/src/content/showcase/wifi-note.mdx index 0cd0cbd..8f66d97 100644 --- a/src/content/showcase/wifi-note.mdx +++ b/src/content/showcase/wifi-note.mdx @@ -1,10 +1,11 @@ --- - title: '와이파이 노트(WIFI Note)' version: 'v1' description: '구조화된 프로젝트 기억을 통한 제품 개발을 보여주는 비공개 REPL Works 호환 프로젝트.' publishedAt: '2026-06-12T00:00:00Z' ------------------------------------ +--- + +--- ## Overview diff --git a/src/pages/index.astro b/src/pages/index.astro index bae8d8d..7690d2f 100644 --- a/src/pages/index.astro +++ b/src/pages/index.astro @@ -7,15 +7,23 @@ import SiteLayout from '../layouts/SiteLayout.astro'; description="REPL Works is an AI-Native Product Development Framework for building projects with durable memory, model independence, and Git-native continuity." >
-
-

+

+

AI-Native Product Development Framework

-

+

Build projects that remember.

- REPL Works keeps product work durable with project memory, model independence, Git-native development, context compression, and long-term project continuity. + REPL Works keeps product work durable with project memory, model + independence, Git-native development, context compression, and long-term + project continuity.

-
+

Project Memory

- Capture decisions, constraints, and intent in durable documents instead of leaving them in chat history. + Capture decisions, constraints, and intent in durable documents + instead of leaving them in chat history.

-
-

Model Independence

+
+

+ Model Independence +

- Switch models without losing the project structure that keeps work understandable and reviewable. + Switch models without losing the project structure that keeps work + understandable and reviewable.

-
-

Git-Native Development

+
+

+ Git-Native Development +

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

-
-

Context Compression

+
+

+ Context Compression +

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

-
-

Long-Term Continuity

+
+

+ Long-Term Continuity +

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

-

Start with the workflow

+

+ 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. + The best entry point is the workflow, because it shows how REPL Works + moves from idea refinement to operation through documents, discussion + AI, execution AI, and human review.

- + Workflow - + Documents - + Prompts
diff --git a/src/pages/search.astro b/src/pages/search.astro index 36e7756..093e505 100644 --- a/src/pages/search.astro +++ b/src/pages/search.astro @@ -20,7 +20,8 @@ import Search from 'astro-pagefind/components/Search.astro'; Search the REPL Works content library

- Pagefind indexes the framework content so you can find workflow, prompts, documents, tools, showcase, and FAQ pages quickly. + Pagefind indexes the framework content so you can find workflow, + prompts, documents, tools, showcase, and FAQ pages quickly.

From cf41596d5aadf1b9fb2c3bb20855ddde9bb5cd7f Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Sat, 13 Jun 2026 00:52:14 +0900 Subject: [PATCH 3/3] docs: review `/faq` content --- src/content/faq/index.mdx | 237 +++++++++++++++++++++++++++++++++++--- 1 file changed, 221 insertions(+), 16 deletions(-) diff --git a/src/content/faq/index.mdx b/src/content/faq/index.mdx index 03e2d82..934654f 100644 --- a/src/content/faq/index.mdx +++ b/src/content/faq/index.mdx @@ -1,34 +1,239 @@ --- -title: 'FAQ' +title: '자주 묻는 질문(FAQ)' version: 'v1' -description: 'Frequently asked questions about REPL Works.' +description: 'REPL Works에 대한 자주 묻는 질문.' publishedAt: '2026-06-12T00:00:00Z' --- -## Why not chat history? +--- + +## Getting Started + +### 왜 REPL Works를 만들었나요? + +AI는 코드를 잘 작성합니다. 하지만 프로젝트를 기억하지는 못합니다. 몇 주가 지나면 다시 설명해야 합니다. + +- 왜 만들고 있는가 +- 어떤 결정을 내렸는가 +- 현재 어디까지 진행되었는가 + +REPL Works는 이 문제를 해결하기 위해 만들어졌습니다. + +프로젝트 기억(Project Memory)을 Git과 문서에 저장하여 세션과 모델이 바뀌어도 프로젝트를 이어갈 수 있도록 합니다. + +--- + +### REPL Works는 무엇인가요? + +REPL Works는 [AI Issue Publisher](/tools/ai-issue)와 같은 AI 협업 개발 도구를 지원하지만, AI 도구 자체는 아닙니다. + +REPL Works는 AI와 사람이 장기간 프로젝트를 함께 운영하기 위한 AI-Native Product Development Framework입니다. + +문서, Git, 그리고 명확한 워크플로를 통해 프로젝트 완성 및 운영 개발을 포함해서 장기간 프로젝트를 진행하는 효율적이고 비용절감할 수 있는 개발 방법을 제안합니다. + +--- + +### AI Agent와 REPL Works는 무엇이 다른가요? + +AI Agent는 작업을 수행합니다. 반면 REPL Works는 작업이 올바른 방향으로 수행되도록 돕습니다. + +Agent는 프로젝트를 기억하지 않습니다. 반면 REPL Works는 프로젝트를 기억합니다. + +| 항목 | AI Agent | REPL Works | +| ------------------ | ----------------------- | ----------------------------- | +| 목적 | 작업 수행 | 프로젝트 지속성 확보 | +| 중심 개념 | Action | Project Memory | +| 기억 저장 위치 | 세션, 런타임, 벡터DB | Git + Markdown Documents | +| 모델 의존성 | 높음 | 낮음 | +| 모델 변경 시 | 재학습 또는 재설정 필요 | 문서만 읽으면 복원 가능 | +| 프로젝트 이해 방식 | 현재 컨텍스트 기반 | 프로젝트 문서 기반 | +| 강점 | 빠른 자동화 | 장기 운영 | +| 약점 | 컨텍스트 손실 가능 | 초기 문서 작성 필요 | +| 핵심 질문 | "무엇을 할까?" | "왜 만들고 어떻게 유지할까?" | +| 결과물 | 코드, 파일, 작업 실행 | 프로젝트 기억, 구조, 워크플로 | + +둘은 경쟁 관계가 아니라 함께 사용되는 관계입니다. + +--- + +### ChatGPT만 써도 되지 않나요? + +ChatGPT로 개발하는 것은 쉬운 일이 아닙니다. 차라리 하나만 쓴다면 Codex가 유리합니다. 그것도 작은 프로젝트라면 가능합니다. -Chat history is valuable for conversation, but REPL Works needs durable project memory that remains readable and reusable after sessions end. +하지만 프로젝트가 커질수록 같은 설명을 반복하게 되며, 프로젝트의 현재 상태를 반복해서 설명해야 하는 경우가 필연적으로 생깁니다. -## Why Git? +REPL Works는 ChatGPT, Gemini와 같은 Discussion LLM와 Codex, Cloude Code와 같은 Execution LLM 모두를 사용하며, 프로젝트의 의도와 구조를 문서에 저장하여 반복 설명을 줄입니다. -Git records human-approved changes, keeps project state reviewable, and provides continuity across model changes. +REPL Works는 최소한의 LLM 비용 지출로 소프트웨어를 완성하기 위한 최고의 선택입니다. -## Why Markdown? +--- + +## How It Works + +### 왜 채팅 기록(Chat History)만 사용하지 않나요? + +채팅 기록은 대화를 위한 도구입니다. 프로젝트는 수개월 또는 수년 동안 유지될 수 있습니다. + +REPL Works는 중요한 프로젝트 기억을 Git의 commit 리스트로 채팅 기록을 대신하며, 채팅 기록을 직접 사용했을 때 발생하는 LLM 환각을 최소화 할 수 있다는 결과를 얻었습니다. + +따라서, 대안이 있기 때문에 단점이 큰 채팅 기록을 사용할 필요가 없습니다. + +--- + +### 왜 Github을 사용하나요? + +Git은 Commit과 Pull Request 그리고 Merge 라는 절차가 있습니다. + +전통적인 개발 환경은 개발자가 Commit을 하면 보통 시니어 개발자인 리뷰어가 리뷰를 승인하고 Merge를 해서 제품에 반영합니다. + +REPL Works 에서는 AI가 코드를 만들면 Human이 승인을 하게 되는데 이 절차가 Commit 입니다. + +이 절차를 간소화 하기 위해서 REPL Works에서는 여러가지 도구를 제공할 예정이며, 큰 규모의 개발에도 대응할 수 있는 AI 단독 Github 계정을 운영할 수 있는 시스템도 개발하고 있습니다. + +Github을 사용하는 이유는 AI와 개발하기 위한 최고의 서비스를 제공하기 때문입니다. + +--- + +### 왜 Markdown 문서를 사용하나요? + +문서 기반 개발에 있어서 문서의 Linting와 Formatting은 프로그래밍 코드에서의 그것과 마찬가지로 매우 중요합니다. + +Markdown은 유구한 역사로 이미 어떤 파이프에서도 Linting과 Formatting을 할 수 있는 환경을 지원하는 거의 유일한 문서 포멧입니다. + +게다가 사람이 읽기 쉽고 AI가 문서를 이해하고 생성하기 쉽습니다. + +또한 Git에서 변경 사항을 추적하기 쉽고 특정 도구에 종속되지 않습니다. + +REPL Works는 장기 보존과 모델 독립성을 위해 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. +| 문서 | 핵심 질문 | +| ------------------ | ----------------------------------- | +| IDEAS.md | 이 아이디어가 가치가 있는가? | +| PITCHING_SCRIPT.md | 이 프로젝트를 어떻게 설명할 것인가? | +| PRODUCT_SPEC.md | 무엇을 만들 것인가? | +| ARCHITECTURE.md | 어떻게 만들 것인가? | +| FRAMEWORK.md | 기술 사양과 개발 규칙은 무엇인가? | +| TASKS.md | 지금 무엇을 해야 하는가? | +| AGENTS.md | AI는 어떤 규칙으로 작업해야 하는가? | -## Why PRODUCT_SPEC.md? +문서가 명확할수록 AI와 사람 모두 프로젝트를 더 쉽게 이해할 수 있습니다. + +ReplWorks에서는 사실 실제 프로젝트에서 사용하는 10여개의 문서를 4개로 줄인 것입니다. 나머지 3개는 ReplWorks에서 제공하는 프롬프트로 생성할 수 있습니다. + +문서는 더 줄어들었는데 그 이유는 AI가 이 구조의 문서를 가장 잘 이해한다는 결과를 얻었기 때문입니다. + +--- + +### 왜 Discussion AI와 Execution AI를 분리하나요? + +그 둘을 분리하는 이유는 두가지 입니다. + +1. AI 환각(Hallucination) 현상 방지 +2. AI 토큰 비용 절약 + +문서 없이 채팅만으로 프로젝트를 진행하게 되면 일주일만 넘으면 나도 길을 읽고 AI도 길을 잃습니다. 게다가 처음 정한 정책과 같은 내용도 AI가 잊어버리면 관련 코드가 있는데도 새로 만들곤 합니다. + +가장 위험한건 AI 환각인데요, 일단 이 모드로 들어가게 되면 프로젝트를 처음부터 다시 시작해야 하는 상황도 빈번하게 발생합니다. 과정이 관리되지 않았으니까요. + +게다가 ReplWorks compatible 방식이 아닌 Cloude Code의 상위모델로 프로젝트 개발을 끝낸다면 생각보다 많은 토큰 사용량과 비용에 놀라게 됩니다. + +REPL Works는 고품질 결정이 필요한 내용은 무료이거나 매우 저렴한 Discussion AI를 사용해서 개발에 필수적인 문서를 ReplWorks 제공 프롬프트를 통해서 완성합니다. + +Execution AI는 필수 문서만 보고 작업하며, TASKS.md 문서에 체크리스트를 보면서 작업하기 때문에 사용 토큰이 최소화 됩니다. 게다가 개발 도중이라고 상태관리가 됩니다. + +이런 방법은 모델 독립적이라, 중간에 좋은 모델을 사용할 수 있는 환경이 생기면 프로젝트 개발 중간이라도 다른 모델로도 개발이 가능하게 됩니다. + +## Architecture & Principles + +### 왜 PRODUCT_SPEC.md가 필요한가요? + +PRODUCT_SPEC.md는 여러분의 아이디어를 AI가 개발 완료에 필요한 모든(All) 정보와 콘텐츠가 담긴 유일한 문서입니다. + +AI는 스스로 이 문서를 진실의 소스(Source of Truth) 혹은 유일한 진리라고 부릅니다. + +이 문서는 아래 네가지 질문에 답할 수 있어야 합니다. + + - 이 제품은 무엇?(What the product is). + - 이 제품이 할 수 있는 일은 무엇?(What the product does). + - 사용자가 할 수 있는 것은 무엇?(What the user can do). + - 성공을 만드는 것은 무엇?(What success means). + +기획 문서라고 생각할 수도 있지만, 기획팀과 사업팀 그리고 UI/UX팀이 섞여서 만드는 문서라고 생각하면 비슷할 것 같네요. + +--- + +### REPL Works는 어떻게 컨텍스트 비용을 줄이나요? + +일반적인 AI 프로젝트는 같은 설명을 반복합니다. + +> 왜 만드는가? +> +> 현재 구조는 무엇인가? +> +> 어떤 결정을 내렸는가? + +REPL Works는 이러한 정보를 문서로 압축합니다. + +```text +PRODUCT_SPEC.md + +ARCHITECTURE.md + +TASKS.md +``` + +Execution AI는 필요한 문서만 읽고 작업할 수 있습니다. + +결과적으로 컨텍스트 길이와 비용을 줄일 수 있습니다. + +--- + +### REPL Works는 특정 AI 모델에 의존하나요? + +아니요. + +REPL Works는 모델 독립성(Model Independence)을 핵심 원칙으로 합니다. + +프로젝트 기억(Long-term & Session Memory)은 모델이 아니라 Git과 문서에 저장됩니다. + +따라서 새로운 모델이나 새로운 세션에서도 동일한 프로젝트를 이어갈 수 있습니다. + +--- + +### REPL Works는 어떤 프로젝트에 적합한가요? + +REPL Works는 아래 프로젝트에서 성공적으로 테스트되고 운영되고 있으며, 지금도 개선되고 있습니다. + +- SaaS +- 웹사이트 +- 내부 도구 +- 오픈소스 프로젝트 +- AI 제품 +- 장기 운영 서비스 + +기술 스택으로는 아래와 같이 테스트 되고 있으며, 개발 시작 당시의 최신 버전을 이용합니다. + +- React/Vite +- NodeJS +- Astro +- Go +- Python +- Laravel + +--- -`PRODUCT_SPEC.md` is the product source of truth. It keeps the website aligned with the intended user experience and business intent. +### REPL Works를 한 문장으로 설명하면 무엇인가요? -## How is REPL Works different from AI agents? +AI는 바뀝니다. -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. +REPL Works는 프로젝트가 AI보다 오래 살아남도록 만드는 프레임워크입니다.