diff --git a/TASKS.md b/TASKS.md index 33e5fc4..fe48471 100644 --- a/TASKS.md +++ b/TASKS.md @@ -209,11 +209,12 @@ 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 +* [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 --- diff --git a/src/content/showcase/ai-issue.mdx b/src/content/showcase/ai-issue.mdx new file mode 100644 index 0000000..3a3af76 --- /dev/null +++ b/src/content/showcase/ai-issue.mdx @@ -0,0 +1,153 @@ +--- + +title: 'AI 이슈 퍼블리셔(AI Issue Publisher)' +version: 'v1' +description: 'AI와의 토론을 바로 실행 가능한 Github Issue로 변환해 주는 REPL Works 호환 도구.' +publishedAt: '2026-06-12T00:00:00Z' +----------------------------------- + +## Overview + +AI 이슈 퍼블리셔(AI Issue Publisher 줄여서 `ai-issue`)는 아이디어, 토론, 작업 요청을 실행 가능한 GitHub Issue로 변환하기 위한 도구다. + +REPL Works 워크플로에서 Planning AI와 Execution AI 사이를 연결하는 역할을 수행한다. + +--- + +## Why REPL Works + +많은 AI 프로젝트는 구현보다 작업 정의에서 더 많은 시간을 소비한다. + +무엇을 만들어야 하는지 명확하지 않으면 AI는 범위를 추측하고, 불필요한 기능을 추가하며, 의도와 다른 결과를 만들 수 있다. + +`ai-issue`는 이러한 문제를 줄이기 위해 만들어졌다. + +--- + +## Website / Repository + +Website + +```text +No exist +``` + +Repository + +[https://github.com/replworks/ai-issue](https://github.com/replworks/ai-issue) + +--- + +## Workflow + +```text +Discussion +↓ +Issue +↓ +Execution AI +↓ +PR +↓ +Review +↓ +Merge +``` + +--- + +`ai-issue`는 Discussion과 Issue 사이를 담당한다. + +--- + +## Documents Used + +`ai-issue`는 일반적으로 다음 문서를 기반으로 작업한다. + +```text +IDEAS.md + +PITCHING_SCRIPT.md + +PRODUCT_SPEC.md + +ARCHITECTURE.md + +FRAMEWORK.md + +TASKS.md + +AGENTS.md +``` + +--- + +Issue는 프로젝트 문서와 일관성을 유지해야 한다. + +--- + +## Lessons Learned + +### Good Execution Starts With Good Tasks + +좋은 구현은 좋은 작업 정의에서 시작된다. + +작업 범위가 명확할수록 AI의 결과도 안정적이다. + +--- + +### Issues Become Reusable Prompts + +잘 작성된 Issue는 단순한 작업 요청이 아니다. + +Execution AI가 바로 사용할 수 있는 프롬프트 역할을 수행한다. + +--- + +### Planning And Execution Should Be Separate + +계획과 구현을 분리하면 품질이 향상된다. + +Planning AI는 무엇을 해야 하는지 정의하고, + +Execution AI는 정의된 작업을 수행한다. + +--- + +### Structure Reduces Hallucination + +명확한 Problem, Goal, Scope, Acceptance Criteria는 AI가 추측해야 할 영역을 줄여준다. + +결과적으로 구현 품질이 향상되고 리뷰 비용도 감소한다. + +--- + +## Current Status + +운영 중. + +REPL Works 프로젝트에서 실제 이슈 생성과 작업 계획에 사용되고 있다. + +--- + +## What This Project Proves + +`ai-issue`는 REPL Works가 단순한 문서 체계가 아니라, + +아이디어를 실행 가능한 작업으로 변환하는 실용적인 워크플로임을 보여준다. + +--- + +## Key Insight + +```text +Idea +↓ +Issue +↓ +Execution AI +``` + +좋은 Issue는 작업을 설명하지 않는다. + +좋은 Issue는 작업을 실행 가능하게 만든다. diff --git a/src/content/showcase/claytube.mdx b/src/content/showcase/claytube.mdx index 0970afe..5a69f5c 100644 --- a/src/content/showcase/claytube.mdx +++ b/src/content/showcase/claytube.mdx @@ -1,29 +1,120 @@ --- -title: 'ClayTube' +title: '클래이튜브(ClayTube)' version: 'v1' -description: 'ClayTube는 다중 세션에 걸쳐 연속성을 보존하는 공개 프로젝트 사례입니다.' +description: 'ClayTube는 장기간에 걸쳐 개발되고 운영되는지 검증하는데 포커스를 둔 ReplWorks 호환 프로젝트다.' publishedAt: '2026-06-07T00:00:00Z' --- -## 웹사이트 / 저장소 +## Overview -- Website: [https://www.etern.co.kr/claytube](https://www.etern.co.kr/claytube) -- Repository: private +ClayTube는 장기간에 걸쳐 개발되고 운영되는 프로젝트다. -## 장기 프로젝트 연속성 +프로젝트의 목표는 기능을 만드는 것뿐만 아니라, 시간이 지나도 프로젝트의 의도와 맥락을 유지할 수 있는 개발 방식을 검증하는 것이다. -- 프로젝트는 Git과 구조화된 문서에 내구성 있는 기억을 유지합니다. -- 구현 세부 사항이 진화해도 아키텍처와 태스크는 안정적으로 유지됩니다. -- 이 프로젝트는 몇 달 동안 중단을 견디도록 설계되었습니다. +--- + +## Why REPL Works + +대부분의 AI 프로젝트는 세션이 종료되면 기억도 함께 사라진다. + +ClayTube는 프로젝트 기억(Project Memory)을 문서와 Git에 저장함으로써 이러한 문제를 해결하고자 한다. + +프로젝트는 특정 채팅이나 특정 AI 모델에 의존하지 않아야 한다. + +--- + +## Website / Repository + +Website + +[https://www.etern.co.kr/claytube](https://www.etern.co.kr/claytube) + +Repository + +```text +Private +``` + +--- + +## Documents Used + +이 프로젝트는 REPL Works 핵심 문서 구조를 사용한다. + +```text +IDEAS.md + +PITCHING_SCRIPT.md + +PRODUCT_SPEC.md + +ARCHITECTURE.md + +FRAMEWORK.md + +TASKS.md + +AGENTS.md +``` + +--- + +프로젝트 기억은 문서와 Git에 저장된다. + +세션은 일시적이지만 문서는 지속된다. + +--- -## AI_MEMORY.md를 통한 세션 복구 +## Lessons Learned + +### Long-Term Continuity Requires Durable Memory + +프로젝트는 수개월 또는 수년에 걸쳐 유지될 수 있다. + +프로젝트 기억이 채팅에만 존재한다면 연속성은 쉽게 사라진다. + +문서와 Git은 장기 프로젝트를 위한 더 안정적인 기억 저장소였다. + +--- + +### Session Recovery Should Be Explicit + +프로젝트를 다시 시작할 때 가장 어려운 일은 맥락을 복원하는 것이다. + +중요한 의도와 결정은 문서에 남아 있어야 하며, 새로운 세션은 그 문서를 기반으로 시작되어야 한다. + +--- + +### Model Changes Should Not Break Projects + +AI 모델은 계속 바뀐다. + +프로젝트가 특정 모델의 기억에 의존한다면 유지보수는 어려워진다. + +프로젝트 기억을 문서에 저장하면 모델이 바뀌어도 동일한 워크플로를 유지할 수 있다. + +--- + +### Git Preserves More Than Code + +Git은 단순히 코드를 저장하는 공간이 아니다. + +프로젝트의 역사와 의사결정을 함께 보존하는 시스템이다. + +시간이 지나도 프로젝트를 이해할 수 있는 이유는 Git에 기록이 남기 때문이다. + +--- + +## Current Status + +운영 중. + +장기 프로젝트에서 프로젝트 기억과 모델 독립성을 검증하는 사례로 활용되고 있다. + +--- -- 복구 요약은 `AI_MEMORY.md`에 저장되어 새로운 세션을 부트스트랩합니다. -- 긴 컨텍스트 형식은 의도, 진행 상황, 다음 행동을 캡처합니다. -- 이를 통해 새로운 세션은 전체 맥락을 다시 구성하지 않고도 빠르게 재개할 수 있습니다. +## What This Project Proves -## AI 모델 전환 +ClayTube는 REPL Works가 단기 생산성 향상 도구가 아니라, -- 이 프로젝트는 단일 AI 모델에 의존하지 않습니다. -- 모델이 바뀌어도 문서화된 프로젝트 기억이 연속성을 제공합니다. -- 모델 전환은 세션 상태가 아니라 리포지토리와 문서를 통해 관리됩니다. +장기간 프로젝트의 연속성을 유지하기 위한 프레임워크임을 보여준다. diff --git a/src/content/showcase/etern-labs.mdx b/src/content/showcase/etern-labs.mdx index f351f30..8cdbfe8 100644 --- a/src/content/showcase/etern-labs.mdx +++ b/src/content/showcase/etern-labs.mdx @@ -1,29 +1,121 @@ --- -title: 'ETERN Labs' + +title: '이턴랩스(ETERN Labs)' version: 'v1' -description: 'ETERN Labs는 공개 프로젝트 사례로, REPL Works를 통해 아키텍처 일관성과 실행 연속성을 유지합니다.' +description: '이턴랩스(ETERN Labs)는 새로운 아이디어와 제품을 실험하고 검증하기 위한 ReplWorks 호환 프로젝트다.' publishedAt: '2026-06-07T00:00:00Z' --- -## 웹사이트 / 저장소 +## Overview + +ETERN Labs는 새로운 아이디어와 제품을 실험하고 검증하기 위한 프로젝트다. + +빠르게 시도하고, 학습하고, 반복하는 과정에서 프로젝트의 의도와 구조를 잃지 않는 것을 목표로 한다. + +--- + +## Why REPL Works + +실험 프로젝트는 빠르게 변화한다. + +기능은 자주 바뀌고 방향도 수정된다. + +하지만 프로젝트가 왜 존재하는지, 무엇을 검증하고 있는지는 유지되어야 한다. + +REPL Works는 이러한 프로젝트 기억(Project Memory)을 문서와 Git에 저장하여 실험 과정에서도 연속성을 유지할 수 있도록 돕는다. + +--- + +## Website / Repository + +Website + +[https://www.etern.co.kr/labs](https://www.etern.co.kr/labs) + +Repository + +```text +Private +``` + +--- + +## Documents Used + +이 프로젝트는 REPL Works 핵심 문서 구조를 사용한다. + +```text +IDEAS.md + +PITCHING_SCRIPT.md + +PRODUCT_SPEC.md + +ARCHITECTURE.md + +FRAMEWORK.md + +TASKS.md + +AGENTS.md +``` + +--- + +문서는 단순한 기록이 아니라 프로젝트의 기억으로 사용된다. + +--- + +## Lessons Learned + +### Architecture Creates Stability + +실험은 자유롭게 진행될 수 있다. + +하지만 구조는 안정적으로 유지되어야 한다. -- Website: [https://www.etern.co.kr/labs](https://www.etern.co.kr/labs) -- Repository: private +ARCHITECTURE.md는 프로젝트가 성장하더라도 일관된 방향을 유지할 수 있도록 도와준다. -## 아키텍처 일관성 +--- + +### Tasks Reduce Ambiguity + +큰 목표는 실행하기 어렵다. + +작업을 명확한 태스크로 분해하면 AI와 사람이 같은 목표를 공유할 수 있다. + +작은 단위의 작업은 더 빠른 검증과 더 명확한 진척도를 제공한다. + +--- -- 아키텍처는 `ARCHITECTURE.md`에 사전 정의되고 모든 변경에서 보존됩니다. -- 콘텐츠 컬렉션과 문서 구조는 프로젝트 전반에서 동일한 개념 모델을 따릅니다. -- 의사 결정은 대화에 묻히지 않고 명시적으로 기록됩니다. +### Model Independence Matters -## 태스크 중심 개발 +프로젝트는 특정 AI 모델에 의존해서는 안 된다. + +문서와 Git에 저장된 프로젝트 기억은 모델이 바뀌어도 유지된다. + +중요한 것은 어떤 모델을 사용하는지가 아니라, 프로젝트를 복원할 수 있는가이다. + +--- + +### Decisions Should Survive Conversations + +좋은 결정은 채팅 기록에 묻혀서는 안 된다. + +중요한 의사결정은 문서에 남아야 하며, 이후의 작업은 그 문서를 기준으로 진행되어야 한다. + +--- + +## Current Status + +운영 중. + +새로운 아이디어와 제품을 지속적으로 실험하며 REPL Works 워크플로를 검증하고 있다. + +--- -- 작업은 `TASKS.md`의 명확한 태스크로 분해됩니다. -- 각 태스크는 하나의 프롬프트와 하나의 커밋 단위로 진행되어 진척도를 측정할 수 있습니다. -- 태스크 산출물은 일시적인 메모가 아니라 정적 문서입니다. +## What This Project Proves -## 모델 독립성 +ETERN Labs는 REPL Works가 완성된 제품뿐만 아니라, -- 이 프로젝트는 연속성을 위해 특정 AI 모델에 의존하지 않습니다. -- 기억은 Git과 파일 기반 문서에 보관되어 모델이 변경되어도 워크플로가 유효합니다. -- 이 시스템은 문서를 읽고 업데이트할 수 있는 모든 모델로 동작하도록 설계되었습니다. +불확실성이 높은 실험 단계의 프로젝트에서도 효과적으로 작동할 수 있음을 보여준다. diff --git a/src/content/showcase/eternops.mdx b/src/content/showcase/eternops.mdx index 3581f98..e138154 100644 --- a/src/content/showcase/eternops.mdx +++ b/src/content/showcase/eternops.mdx @@ -1,23 +1,107 @@ --- -title: 'ETERNOps' + +title: '이터놉스(ETERNOps)' version: 'v1' -description: 'Etern은 공개 프로젝트 사례로, REPL Works를 통해 프로젝트 기억과 의도를 보존합니다.' +description: '장기간 운영에 포커스를 맞춘 ReplWorks 호환 프로젝트.' publishedAt: '2026-06-07T00:00:00Z' --- -## 웹사이트 / 저장소 +## Overview + +이터놉스는 장기간 운영되는 비즈니스를 위한 웹사이트 제작 및 운영 프로젝트다. + +프로젝트의 목표는 단순히 웹사이트를 만드는 것이 아니라, 시간이 지나도 유지 가능한 운영 시스템을 구축하는 것이다. + +--- + +## Why REPL Works + +이터놉스는 AI와 사람이 함께 장기간 프로젝트를 운영하는 환경을 전제로 한다. + +프로젝트가 성장할수록 대화 기록만으로는 의도와 구조를 유지하기 어렵다. + +REPL Works는 프로젝트 기억(Project Memory)을 문서와 Git에 저장함으로써 이러한 문제를 해결한다. + +--- + +## Website / Repository + +Website + +[https://www.etern.co.kr](https://www.etern.co.kr) + +Repository + +```text +Private +``` + +--- + +## Documents Used + +이 프로젝트는 REPL Works 핵심 문서 구조를 사용한다. + +```text +IDEAS.md + +PITCHING_SCRIPT.md + +PRODUCT_SPEC.md + +ARCHITECTURE.md + +FRAMEWORK.md + +TASKS.md + +AGENTS.md +``` + +--- + +프로젝트 의도, 구조, 작업 상태는 문서를 통해 관리된다. + +--- + +## Lessons Learned + +### Project Memory Is More Important Than Session Memory + +대화는 종료될 수 있다. + +프로젝트는 계속 운영되어야 한다. + +문서는 프로젝트 기억을 유지하는 가장 안정적인 방법이었다. + +--- + +### Git Becomes The Source Of Truth + +프로젝트 상태는 채팅이 아니라 Git 저장소에 남아야 한다. + +Git은 변경 이력과 의사결정을 함께 보존한다. + +--- + +### Content First Scales Better + +프로젝트가 커질수록 콘텐츠와 문서가 중요해진다. -- Website: [https://www.etern.co.kr](https://www.etern.co.kr) -- Repository: private +문서가 명확할수록 AI와 사람 모두 더 빠르게 프로젝트를 이해할 수 있다. -## 메모리 시스템 적용 +--- + +## Current Status + +운영 중. + +REPL Works 워크플로를 기반으로 지속적으로 개선되고 있다. + +--- -- 프로젝트 지식은 버전 관리 파일인 `ARCHITECTURE.md`, `TASKS.md`, 콘텐츠 컬렉션에 저장됩니다. -- 콘텐츠 우선 구조를 사용하여 상태를 명시적으로 표현하고 복구 가능하게 만듭니다. -- 변경 사항은 Git에 기록되어 향후 세션에 대한 역사와 맥락을 제공합니다. +## What This Project Proves -## Git 기반 워크플로 사용 +이터놉스는 REPL Works가 단순한 문서화 방식이 아니라, -- 새로운 작업은 `TASKS.md`의 개별 태스크로 도입됩니다. -- 각 태스크는 문서화된 커밋으로 구현됩니다. -- 리포지토리는 프로젝트 기억의 출처로 사용되어 세션 기억에 의존하지 않고 작업을 재개할 수 있습니다. +실제 비즈니스 프로젝트를 장기간 운영하기 위한 프레임워크임을 보여준다. diff --git a/src/content/showcase/index.mdx b/src/content/showcase/index.mdx index b7fd1e8..c014e65 100644 --- a/src/content/showcase/index.mdx +++ b/src/content/showcase/index.mdx @@ -1,23 +1,67 @@ --- -title: 'Showcase' +title: '쇼케이스' version: 'v1' -description: 'REPL Works Compatible Projects.' +description: 'ReplWorks 호환(Compatible) 프로젝트 리스트.' publishedAt: '2026-06-12T00:00:00Z' --- -## Purpose +ReplWorks는 이론이 아니라 실전에서 검증되는 프레임워크다. -Show compatible projects that use the REPL Works framework in practice. +이 페이지는 실제로 ReplWorks를 적용하고 있는 프로젝트를 소개한다. + +--- + +## What Is A ReplWorks Compatible Project? + +ReplWorks 호환(Compatible) 프로젝트는 ReplWorks 워크플로와 문서 구조를 사용하는 프로젝트다. + +일반적으로 다음 문서를 사용한다. + +```text +PRODUCT_SPEC.md + +ARCHITECTURE.md + +FRAMEWORK.md + +TASKS.md + +AGENTS.md +``` + +--- + +프로젝트 규모나 기술 스택은 중요하지 않다. + +중요한 것은 프로젝트 기억(Project Memory)을 Git에 저장하고, AI와 사람이 같은 문서를 기반으로 협업할 수 있는가이다. + +--- ## Compatible Projects -- [REPL Works Website](/showcase/repl-works-website) -- [ETERNOps](/showcase/eternops) -- [ETERN Labs](/showcase/etern-labs) -- [ClayTube](/showcase/claytube) +- [ReplWorks 공식 웹사이트](/showcase/repl-works-website) +- [AI 이슈 퍼블리셔(AI Issue Publisher)](/showcase/ai-issue) +- [이터놉스(ETERNOps)](/showcase/eternops) +- [이턴랩스(ETERN Labs)](/showcase/etern-labs) +- [클래이튜브(ClayTube)](/showcase/claytube) - [MMA](/showcase/mma) -- [WIFI Note](/showcase/wifi-note) +- [와이파이 노트(WIFI Note)](/showcase/wifi-note) + +--- + +## What You'll Find + +각 프로젝트는 다음 내용을 설명한다. + +- 프로젝트 개요 +- ReplWorks를 사용한 이유 +- 사용한 문서 구조 +- 운영 과정에서 얻은 교훈 + +--- + +## Learn By Example -## Entry Structure +ReplWorks는 실제 프로젝트를 통해 가장 쉽게 이해할 수 있다. -Showcase entries should support overview, why REPL Works, documents used, and lessons learned. +문서만 읽지 말고 실제 사례를 살펴보자. diff --git a/src/content/showcase/mma.mdx b/src/content/showcase/mma.mdx index d03d0ad..83ca6a5 100644 --- a/src/content/showcase/mma.mdx +++ b/src/content/showcase/mma.mdx @@ -1,29 +1,120 @@ --- title: 'MMA' version: 'v1' -description: 'MMA는 비공개 프로젝트 사례로, 프로젝트명만 공개되어 있습니다.' -publishedAt: '2026-06-07T00:00:00Z' +description: '인간과 AI 간의 구조화된 협업을 보여주는 비공개 REPL Works 호환 프로젝트.' +publishedAt: '2026-06-12T00:00:00Z' --- -## 공개 정보 +## Overview -- Website: 제공되지 않음 -- Repository: 비공개 +MMA는 비공개로 운영되는 프로젝트다. -## 협업 워크플로 +프로젝트 자체에 대한 상세 정보는 공개되지 않지만, REPL Works 워크플로를 실제로 적용하고 검증하는 사례 중 하나이다. -- 여러 AI 모델과 사람이 동일한 문서화된 기억을 공유합니다. -- 리포지토리는 프로젝트 상태를 저장하여 연속성을 유지합니다. -- 산출물은 단일 모델 세션이 아니라 파일과 문서에 기록됩니다. +--- + +## Why REPL Works + +복잡한 프로젝트일수록 프로젝트 기억(Project Memory)은 특정 사람이나 특정 AI에 의존해서는 안 된다. + +MMA는 의도, 구조, 작업 상태를 문서와 Git에 저장함으로써 여러 사람과 여러 AI가 동일한 프로젝트를 지속적으로 운영할 수 있도록 설계되었다. + +--- + +## Website / Repository + +Website + +```text +Not Public +``` + +Repository + +```text +Private +``` + +--- + +## Documents Used + +이 프로젝트는 REPL Works 핵심 문서 구조를 사용한다. + +```text +IDEAS.md + +PITCHING_SCRIPT.md + +PRODUCT_SPEC.md + +ARCHITECTURE.md + +FRAMEWORK.md + +TASKS.md + +AGENTS.md +``` + +--- + +프로젝트 상태는 대화가 아니라 문서를 통해 공유된다. + +--- + +## Lessons Learned -## 의사 결정 루프 +### Shared Memory Matters + +협업에서 가장 중요한 것은 동일한 기억을 공유하는 것이다. + +사람과 AI는 같은 문서를 읽고 같은 기준으로 작업해야 한다. + +--- + +### Decisions Should Be Explicit + +중요한 결정은 채팅 기록에 남아서는 안 된다. + +프로젝트의 방향과 구조에 영향을 주는 결정은 문서에 기록되어야 한다. + +문서화된 결정은 검토 가능하고 추적 가능하다. + +--- + +### Planning And Execution Are Different Activities + +계획과 구현은 서로 다른 작업이다. + +계획은 무엇을 해야 하는지를 정의하고, + +구현은 정의된 작업을 수행한다. + +이 둘을 분리할수록 프로젝트는 더 안정적으로 운영된다. + +--- + +### Repository Becomes The Coordination Layer + +프로젝트 참여자는 같은 세션을 공유하지 않는다. + +하지만 같은 저장소는 공유할 수 있다. + +Git 저장소는 프로젝트 상태를 전달하고 협업을 조정하는 중심 역할을 수행한다. + +--- + +## Current Status + +비공개 운영 중. + +REPL Works 기반 협업 방식과 프로젝트 기억 관리 방식을 지속적으로 검증하고 있다. + +--- -- 인간은 `ARCHITECTURE.md`와 `TASKS.md`에 기록된 결정을 검토하고 승인합니다. -- AI가 생성한 제안은 콘텐츠로 기록된 후 팀에서 검증됩니다. -- 이 루프는 Git 기록을 통해 명시적이고 추적 가능하게 유지됩니다. +## What This Project Proves -## 계획과 실행 분리 +MMA는 REPL Works가 개인 프로젝트뿐만 아니라, -- 계획 산출물은 실행 산출물과 분리되어 유지됩니다. -- `TASKS.md`는 계획을 정의하고, 콘텐츠 컬렉션은 결과 문서를 보관합니다. -- 이 분리는 전략이 구현 세부 사항과 혼합되지 않도록 합니다. +사람과 AI가 함께 참여하는 협업 환경에서도 효과적으로 작동할 수 있음을 보여준다. diff --git a/src/content/showcase/repl-works-website.mdx b/src/content/showcase/repl-works-website.mdx index b2e7a82..45db764 100644 --- a/src/content/showcase/repl-works-website.mdx +++ b/src/content/showcase/repl-works-website.mdx @@ -1,29 +1,114 @@ --- -title: 'REPL Works 웹사이트' +title: 'ReplWorks 웹사이트' version: 'v1' -description: 'REPL Works itself as a compatible project and reference implementation.' +description: 'ReplWorks 웹사이트는 ReplWorks를 실제로 적용한 첫 번째 ReplWorks Compatible 프로젝트이기도 하다.' publishedAt: '2026-06-12T00:00:00Z' --- ## Overview -The REPL Works website is the reference implementation for the framework. +ReplWorks 웹사이트는 ReplWorks 프레임워크의 공식 웹사이트다. -## Why REPL Works +동시에 ReplWorks를 실제로 적용한 첫 번째 ReplWorks Compatible 프로젝트이기도 하다. -It demonstrates how content-first, Git-native documentation can preserve product memory across sessions and model changes. +이 프로젝트의 목적은 프레임워크를 설명하는 것뿐만 아니라, 실제로 프레임워크가 어떻게 사용되는지 보여주는 것이다. + +--- + +## Why ReplWorks + +ReplWorks는 AI 도구가 아니다. + +AI와 사람이 장기간 프로젝트를 함께 운영하기 위한 AI-Native Product Development Framework이다. + +이 웹사이트는 다음 질문에 답하기 위해 만들어졌다. + +```text +ReplWorks는 무엇인가? + +왜 필요한가? + +어떻게 사용하는가? + +실제 프로젝트에서는 어떻게 적용되는가? +``` + +--- ## Documents Used -- `IDEAS.md` -- `PITCHING_SCRIPT.md` -- `PRODUCT_SPEC.md` -- `ARCHITECTURE.md` -- `TASKS.md` -- `AGENTS.md` +이 프로젝트는 ReplWorks의 핵심 문서 구조를 사용한다. + +```text +IDEAS.md + +PITCHING_SCRIPT.md + +PRODUCT_SPEC.md + +ARCHITECTURE.md + +FRAMEWORK.md + +TASKS.md + +AGENTS.md +``` + +--- + +각 문서는 서로 다른 책임을 가지며, 프로젝트 기억(Project Memory)의 일부로 관리된다. + +--- ## Lessons Learned -- The website must stay content-first. -- Planning and execution work better when separated. -- Markdown documents reduce context overhead and make continuity explicit. +### Content First Wins + +웹사이트는 기능보다 콘텐츠가 먼저다. + +좋은 문서는 시간이 지나도 남지만, 구현은 언제든지 변경될 수 있다. + +--- + +### Planning And Execution Should Be Separate + +Planning AI와 Execution AI를 분리하면 결과 품질이 높아진다. + +문서가 계획을 담당하고, 구현은 문서를 따른다. + +--- + +### Git Is Better Than Chat History + +대화는 사라질 수 있다. + +문서는 Git에 남는다. + +프로젝트는 특정 세션이 아니라 저장소를 기준으로 복원 가능해야 한다. + +--- + +### Project Memory Matters + +장기 프로젝트에서는 기억이 가장 중요하다. + +ReplWorks 문서는 프로젝트 기억을 압축하고 유지하는 역할을 수행한다. + +--- + +## Current Status + +운영 중. + +ReplWorks 문서, 워크플로, 프롬프트, 도구, 그리고 실제 적용 사례를 지속적으로 확장하고 있다. + +--- + +## What This Project Proves + +ReplWorks는 이론이 아니다. + +실제 프로젝트에서 사용 가능한 워크플로이며, + +이 웹사이트는 그 첫 번째 레퍼런스 구현이다. diff --git a/src/content/showcase/wifi-note.mdx b/src/content/showcase/wifi-note.mdx index f3ccf36..0cd0cbd 100644 --- a/src/content/showcase/wifi-note.mdx +++ b/src/content/showcase/wifi-note.mdx @@ -1,27 +1,121 @@ --- -title: '와이파이 노트' + +title: '와이파이 노트(WIFI Note)' version: 'v1' -description: 'WIFI Note는 비공개 프로젝트 사례로, 프로젝트명과 도입 패턴만 공개합니다.' -publishedAt: '2026-06-07T00:00:00Z' +description: '구조화된 프로젝트 기억을 통한 제품 개발을 보여주는 비공개 REPL Works 호환 프로젝트.' +publishedAt: '2026-06-12T00:00:00Z' +----------------------------------- + +## Overview + +WIFI Note는 매장을 위한 WiFi 안내 및 고객 경험 개선 서비스를 구축하기 위한 프로젝트다. + +프로젝트의 세부 구현은 비공개지만, REPL Works를 실제 제품 개발 과정에 적용하는 사례로 운영되고 있다. + +--- + +## Why REPL Works + +제품 개발은 기능을 만드는 것보다 의도를 유지하는 것이 더 어렵다. + +시간이 지나고 기능이 추가될수록 프로젝트는 원래 목표를 잃기 쉽다. + +WIFI Note는 프로젝트 기억(Project Memory)을 문서와 Git에 저장함으로써 제품의 방향성과 의도를 지속적으로 유지하고자 한다. + +--- + +## Website / Repository + +Website + +```text +Not Public +``` + +Repository + +```text +Private +``` + +--- + +## Documents Used + +이 프로젝트는 REPL Works 핵심 문서 구조를 사용한다. + +```text +IDEAS.md + +PITCHING_SCRIPT.md + +PRODUCT_SPEC.md + +ARCHITECTURE.md + +FRAMEWORK.md + +TASKS.md + +AGENTS.md +``` + +--- + +프로젝트의 의도, 구조, 작업 상태는 문서를 통해 관리된다. + +--- + +## Lessons Learned + +### Product Intent Must Survive Development + +제품은 개발 과정에서 계속 변한다. + +하지만 왜 이 제품을 만드는지는 변하면 안 된다. + +문서는 제품의 원래 의도를 유지하는 역할을 한다. + +--- + +### Documentation Reduces Context Cost + +같은 내용을 반복 설명하는 것은 비용이 크다. + +중요한 의도와 구조를 문서로 정리하면 AI는 반복적으로 긴 맥락을 재구성할 필요가 없다. + +문서는 프로젝트 기억을 압축하는 역할을 한다. + +--- + +### Session Recovery Should Be Fast + +프로젝트는 언제든지 중단될 수 있다. + +중요한 것은 얼마나 빨리 다시 시작할 수 있는가이다. + +문서화된 프로젝트 기억은 새로운 세션과 새로운 모델이 빠르게 프로젝트를 이해하도록 돕는다. + --- -## 공개 정보 +### Private Projects Need Process Too -- Website: 제공되지 않음 -- Repository: 비공개 +비공개 프로젝트라고 해서 워크플로가 덜 중요해지는 것은 아니다. -## 문서 중심 메모리 +오히려 장기간 운영되는 프로젝트일수록 명확한 문서 구조와 작업 절차가 필요하다. + +--- -- 도메인 지식과 설계 의도는 문서화된 프로젝트 기억에 기록됩니다. -- `ARCHITECTURE.md`와 `TASKS.md`는 프로젝트 구조와 실행 계획을 명확히 합니다. -- 세션 간 연속성은 Git과 문서에 저장된 기억으로 유지됩니다. +## Current Status -## 세션 복구 +개발 진행 중. + +REPL Works 기반 제품 개발 워크플로를 실제 서비스에 적용하며 지속적으로 개선하고 있다. + +--- -- 세션 복구가 필요할 때는 `AI_MEMORY.md`를 통해 핵심 상태를 복원합니다. -- 이 접근 방식은 모델 상태에 의존하지 않고 프로젝트를 이어가는 데 도움이 됩니다. +## What This Project Proves -## 비공개 사례의 목적 +WIFI Note는 REPL Works가 단순한 문서 관리 방식이 아니라, -- 프로젝트명만 공개하면서도 도입 패턴을 공유합니다. -- 개인 정보와 내부 저장소는 공개하지 않지만, 프로세스는 재현 가능합니다. +실제 제품 개발 과정에서 프로젝트 기억을 유지하고 실행 비용을 줄이는 프레임워크임을 보여준다.