From 2e39fbee7b4ff9c1e67a8a9fe520e896551245db Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Sun, 7 Jun 2026 18:38:04 +0900 Subject: [PATCH 1/2] feat: review contents --- src/content/resources/example-documents.mdx | 978 +++++++++++++++++- src/content/resources/faq.mdx | 37 +- src/content/resources/index.mdx | 16 +- .../resources/long-context-examples.mdx | 608 ++++++++++- src/content/resources/planning-examples.mdx | 26 +- src/content/resources/repository-examples.mdx | 8 +- src/content/resources/templates.mdx | 8 +- src/content/showcase/claytube.mdx | 35 + src/content/showcase/etern-labs.mdx | 35 + src/content/showcase/eternops.mdx | 29 + src/content/showcase/index.mdx | 23 +- src/content/showcase/mma.mdx | 35 + src/content/showcase/project-a.mdx | 24 - src/content/showcase/project-b.mdx | 30 - src/content/showcase/project-c.mdx | 30 - src/content/showcase/project-d.mdx | 30 - src/content/showcase/repl-works-website.mdx | 26 +- src/content/showcase/wifi-note.mdx | 33 + src/content/specification/v1.mdx | 36 +- src/content/workflow/v1.md | 103 +- src/pages/index.astro | 55 +- src/pages/why.astro | 64 +- 22 files changed, 1908 insertions(+), 361 deletions(-) create mode 100644 src/content/showcase/claytube.mdx create mode 100644 src/content/showcase/etern-labs.mdx create mode 100644 src/content/showcase/eternops.mdx create mode 100644 src/content/showcase/mma.mdx delete mode 100644 src/content/showcase/project-a.mdx delete mode 100644 src/content/showcase/project-b.mdx delete mode 100644 src/content/showcase/project-c.mdx delete mode 100644 src/content/showcase/project-d.mdx create mode 100644 src/content/showcase/wifi-note.mdx diff --git a/src/content/resources/example-documents.mdx b/src/content/resources/example-documents.mdx index 74ec597..7fd5f11 100644 --- a/src/content/resources/example-documents.mdx +++ b/src/content/resources/example-documents.mdx @@ -7,74 +7,986 @@ publishedAt: '2026-06-07T00:00:00Z' # Example Documents -## Sample IDEAS.md +## 샘플 IDEAS.md -# IDEAS +다음은 REPL Works 프로젝트에서 아이디어를 정리하는 문서 예시입니다. -## Idea Summary +````markdown +# IDEAS.md -- Build a project memory system for AI development. +Version 2.0 -## Problem +--- + +# Project + +REPL Works + +--- + +# Vision + +REPL Works는 AI 시대를 위한 Project Memory System이다. + +AI는 점점 더 똑똑해지고 있다. + +더 긴 Context Window. + +더 강력한 Agent. + +더 높은 코드 생성 능력. + +그러나 장기 프로젝트는 여전히 같은 문제를 겪는다. + +프로젝트 의도가 사라진다. + +아키텍처가 붕괴한다. + +동일한 실수를 반복한다. -- Teams lose context between sessions. -- Architecture drifts when knowledge is only in conversation. +모델을 교체하면 생산성이 초기화된다. -## Key Benefits +세션이 종료되면 중요한 컨텍스트가 사라진다. -- Durable project memory. -- Reusable documentation. +--- + +REPL Works는 이 문제의 원인이 AI의 지능 부족이 아니라고 믿는다. + +문제는 기억(Memory)이다. + +--- + +# Problem + +현재 대부분의 AI 개발은 Session 중심으로 이루어진다. + +프로젝트 지식은 다음 위치에 흩어진다. + +- Chat History +- Prompt +- Context Window +- Agent Runtime +- 개인 메모 + +--- + +프로젝트는 수개월 또는 수년 동안 존재할 수 있다. + +그러나 AI의 기억은 몇 시간 또는 몇 주를 넘기 어렵다. + +--- -## Next Steps +결과적으로 다음 문제가 발생한다. -- Define content collections. -- Create the first manifesto and workflow. +- 모델이 바뀌면 기억이 사라진다. +- 장기 프로젝트를 유지하기 어렵다. +- 동일한 실수를 반복한다. +- 아키텍처가 드리프트한다. +- 중요한 의사결정이 소실된다. +- 프로젝트가 Session에 종속된다. + +--- + +우리는 이 문제를 + +Project Amnesia + +라고 부른다. + +--- + +# Core Insight + +AI Development has a memory problem. + +--- + +AI는 Session Memory를 가진다. + +프로젝트는 Project Memory를 필요로 한다. + +--- + +현재 대부분의 AI 개발은 + +Project Memory를 Session 안에 저장한다. + +--- + +Session이 종료되면 기억도 사라진다. + +--- + +REPL Works는 Project Memory와 Session Memory를 구분한다. + +--- + +Project Memory는 Repository에 저장된다. + +Session Memory는 필요할 때 복구된다. + +--- -## Sample ARCHITECTURE.md +프로젝트는 Session보다 오래 살아야 한다. + +--- + +# Solution + +프로젝트 기억을 Runtime 밖으로 이동시킨다. + +--- + +Project Memory + +```text +Constitution + +Architecture + +Tasks + +Git History +``` + +--- + +Session Memory + +```text +Long Context +``` + +--- + +REPL Works v1 Reference Implementation + +```text +AGENTS.md + +ARCHITECTURE.md + +TASKS.md + +LONG_CONTEXT.md + +Git History +``` + +--- + +프로젝트는 Project Memory만으로 복원 가능해야 한다. + +세션은 Session Memory로 복원 가능해야 한다. + +--- + +# Key Principles + +## Git First + +모든 프로젝트는 Git으로 시작한다. + +--- + +## Architecture First + +모든 구현은 Architecture를 따른다. + +--- + +## Tasks Drive Development + +개발은 현재 작업 범위를 명확하게 정의해야 한다. + +--- + +## Model Independence + +모델은 교체 가능해야 한다. + +--- + +## Planning ≠ Execution + +설계와 구현은 분리되어야 한다. + +--- + +## Project Memory ≠ Session Memory + +프로젝트 기억과 세션 기억은 서로 다른 문제다. + +--- + +# Target Audience + +### Solo Founder + +--- -# ARCHITECTURE +### Indie Hacker + +--- + +### Small Team + +--- + +### AI-Native Builder + +--- + +# Long-Term Goal + +REPL Works를 AI 시대의 Project Memory Standard로 만든다. + +--- + +예를 들어 + +```text +Built with REPL Works +``` + +가 + +```text +Conventional Commits +``` + +처럼 자연스럽게 사용되는 상태를 목표로 한다. + +--- + +# Success Metrics + +### Phase 1 + +REPL Works 자체를 REPL Works로 개발 + +--- + +### Phase 2 + +실제 서비스 5개 이상 운영 + +--- + +### Phase 3 + +외부 사용자가 REPL Works를 사용 + +--- + +### Phase 4 + +REPL Works Compatible 프로젝트 등장 + +--- + +# Final Statement + +AI는 계속 바뀐다. + +프로젝트는 계속 살아남아야 한다. + +--- + +AI memory is temporary. + +Project memory must be externalized. + +--- + +Models forget. + +Projects must not. +```` + +--- + +## 샘플 ARCHITECTURE.md + +다음은 기본적인 아키텍처 문서 구조 예시입니다. + +````markdown +# ARCHITECTURE.md + +Version 2.0 ## PROJECT REPL Works Website +--- + ## PURPOSE -Documentation platform for REPL Works. +Documentation Platform for REPL Works. + +Goal: + +```text +Establish REPL Works +as a Project Memory Standard +for AI Development +``` + +--- ## PRODUCT TYPE +```text Documentation Platform +``` + +Not: + +```text +SaaS +Dashboard +Community Platform +Social Network +AI Tool +``` + +--- ## USER ACTIONS -- Read -- Navigate -- Learn -- Apply +```text +Read +Navigate +Learn +Apply +``` + +--- ## PRIMARY JOURNEY -Home → Why → Manifesto → Specification → Workflow → Resources → Showcase → GitHub +```text +Home +↓ +Why +↓ +Manifesto +↓ +Specification +↓ +Workflow +↓ +Resources +↓ +Showcase +↓ +GitHub +``` + +--- + +## NAVIGATION + +```text +Home + +Why + +Manifesto + +Specification + +Workflow + +Resources + +Showcase +``` + +--- + +### Resources + +```text +Templates + +Example Documents + +Long Context Examples + +Repository Examples + +Planning Examples + +FAQ +``` + +--- + +## CONTENT MODEL + +Content First + +Design Second + +--- + +Content Source + +```text +MDX +``` + +--- + +Collections + +```text +manifesto + +specification + +workflow + +resources + +showcase +``` + +--- + +## VERSIONING + +Required + +--- + +Versioned Content + +```text +Manifesto + +Specification + +Workflow +``` + +--- + +Example + +```text +src/content/ + +manifesto/ + v1.mdx -## Sample TASKS.md +specification/ + v1.mdx -# TASKS +workflow/ + v1.mdx +``` + +--- + +Never delete previous versions. + +--- + +## SHOWCASE + +Purpose + +```text +Proof of Adoption +``` + +--- + +Initial Entries + +```text +REPL Works Website + +Project A + +Project B + +Project C + +Project D +``` + +--- + +## GITHUB + +GitHub is the primary external asset. + +Website explains GitHub. + +Website does not replace GitHub. + +--- + +## STACK + +Required + +```text +Node.js >= 24 + +npm >= 11 + +Astro >= 6 + +TypeScript >= 5 + +Tailwind CSS >= 4 +``` + +--- + +Current + +```text +Node.js 24.x + +Astro 6.4.4 + +TypeScript 5.x + +Tailwind CSS 4.x +``` + +--- + +Package Manager + +```text +npm +``` + +--- + +Framework + +```text +Astro +``` + +--- + +Language + +```text +TypeScript +``` + +--- + +Content + +```text +MDX +``` + +--- + +Content Management + +```text +Astro Content Collections +``` + +--- + +Search + +```text +Pagefind +``` + +--- + +Hosting + +```text +GitHub Pages +``` + +--- + +CI/CD + +```text +GitHub Actions +``` + +--- + +Analytics (Optional) + +```text +Plausible + +Umami +``` + +--- + +## PROJECT INITIALIZATION + +Required Command + +```bash +npm create astro@latest +``` + +--- + +Template + +```text +Minimal +``` + +--- + +TypeScript + +```text +Strict +``` + +--- + +Package Manager + +```text +npm +``` + +--- + +## REPOSITORY STRUCTURE + +```text +/ +├── public/ +│ └── favicon.svg +├── src/ +│ ├── assets +│ │ └── astro.svg +│ ├── components +│ │ └── Welcome.astro +│ ├── layouts +│ │ └── Layout.astro +│ └── pages +│ ├── index.astro +│ ├── manifesto/ +│ ├── specification/ +│ ├── workflow/ +│ ├── resources/ +│ └── showcase/ +├── tests/ +├── AGENTS.md +├── ARCHITECTURE.md +├── TASKS.md +└── package.json +``` + +--- + +## IN SCOPE + +```text +Documentation Pages + +Versioned Documents + +Static Search + +GitHub Links + +Showcase Pages + +Resource Pages +``` + +--- + +## OUT OF SCOPE + +```text +Database + +Backend API + +Authentication + +User Accounts + +Comments + +CMS + +Realtime Features + +Payments + +Discussion Board +``` + +--- + +## CONSTRAINTS + +All pages must support: + +```text +Static Export +``` + +--- + +Server dependency: + +```text +Not Allowed +``` + +--- + +Dynamic user state: + +```text +Not Allowed +``` + +--- + +## SUCCESS CRITERIA + +```text +Manifesto published + +Specification published + +Workflow published + +Resources published + +Showcase published + +GitHub Pages deployment works + +New versions can be added + +Old versions remain accessible +``` + +--- + +## FINAL + +REPL Works Website is a Documentation Platform. + +Every implementation must support: + +```text +Documentation + +Versioning + +Static Deployment + +Long-Term Maintainability +``` +```` + +--- + +## 샘플 TASKS.md + +다음은 REPL Works 태스크 문서 예시입니다. + +````markdown +# TASKS.md + +Version 3.0 + +## PURPOSE + +Current Work Scope + +--- + +ARCHITECTURE.md + +```text +Destination +``` + +TASKS.md + +```text +Current Position +``` + +--- + +Only incomplete tasks may be implemented. + +--- + +Work outside TASKS.md is prohibited. + +--- + +## EXECUTION RULES + +```text +One Prompt += +One Task +``` + +--- + +```text +One Task += +One Commit +``` + +--- + +Do not: + +```text +Combine Tasks + +Implement Future Tasks + +Expand Scope + +Add Unplanned Features +``` + +--- + +If required work is missing: + +```text +STOP + +Propose TASK update +``` + +--- + +# PHASE 1 ## FOUNDATION -- Initialize Astro project. -- Configure Tailwind. -- Enable content collections. +- [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 + +--- + +# PHASE 2 + +## LAYOUT SYSTEM + +- [x] T106 Create Site Shell + +--- + +# PHASE 3 ## CORE CONTENT -- Publish Manifesto v1. -- Publish Specification v1. -- Publish Workflow v1. +- [x] T211 Create Home Page +- [x] T212 Create Why Page +- [x] T213 Publish Manifesto v1 +- [x] T214 Publish Specification v1 +- [x] T215 Publish Workflow v1 + +--- + +# PHASE 4 + +## RESOURCES + +- [x] T316 Create Resources Index +- [x] T317 Publish Templates +- [x] T318 Publish Example Documents +- [x] T319 Publish Long Context Examples +- [x] T320 Publish Repository Examples +- [x] T321 Publish Planning Examples +- [x] T322 Publish FAQ + +--- + +# PHASE 5 + +## SHOWCASE + +- [x] T423 Create Showcase Index +- [x] T424 Publish REPL Works Website Showcase +- [x] T425 Publish Project A Showcase +- [x] T426 Publish Project B Showcase +- [x] T427 Publish Project C Showcase +- [x] T428 Publish Project D Showcase + +--- + +# PHASE 6 + +## SEARCH + +- [x] T529 Integrate Pagefind +- [x] T530 Create Search UI + +--- + +# PHASE 7 + +## RELEASE + +- [ ] T631 Content Review +- [ ] T632 Responsive Review +- [ ] T633 Accessibility Review +- [ ] T634 Deployment Verification +- [ ] T635 Release v1 + +--- + +## COMPLETION + +```text +[ ] +↓ +[x] +``` + +--- + +After task completion: + +Review ARCHITECTURE.md + +--- -## NEXT STEPS +If architecture changed: -- Create Resources index. -- Publish templates. -- Publish example documents. +Update ARCHITECTURE.md +```` diff --git a/src/content/resources/faq.mdx b/src/content/resources/faq.mdx index 099a565..8daa42b 100644 --- a/src/content/resources/faq.mdx +++ b/src/content/resources/faq.mdx @@ -7,26 +7,37 @@ publishedAt: '2026-06-07T00:00:00Z' # FAQ -## What is REPL Works? +## REPL Works는 무엇인가? -REPL Works is a project memory standard for AI development. It organizes documentation, tasks, and architecture so projects survive sessions and model changes. +REPL Works는 AI Development를 위한 Project Memory System이자 Project Memory Standard입니다. +이 시스템은 프로젝트 기억을 Git 기반 문서로 외부화하고, 세션과 모델 교체에도 프로젝트의 연속성을 유지하도록 설계되었습니다. -## Why Git as memory? +## 왜 Git이 필요한가? -Git provides durable history, clear change context, and a shared source of truth. It makes project memory explicit and versioned outside the model. +Git은 변경 내역을 기록하고 프로젝트 기억을 버전별로 보존하는 가장 명확한 방법입니다. +Git은 프로젝트 상태를 추적하고, 의도와 결정을 공유하며, 모델 내부에 의존하지 않는 기억 공간을 제공합니다. -## Why separate AGENTS / ARCHITECTURE / TASKS? +## 왜 AGENTS.md가 필요한가? -Separation keeps responsibility clear: +`AGENTS.md`는 프로젝트의 작동 규칙과 AI 상호작용 방식을 문서화하는 헌법입니다. +이 문서는 누가 무엇을 할지, 어느 문서를 참조할지, 어떤 규칙을 따라야 할지를 명확히 정의합니다. -- AGENTS define interaction and automation, -- ARCHITECTURE defines project intent, -- TASKS define execution steps. +## 왜 LONG_CONTEXT.md가 필요한가? -## Why LONG_CONTEXT.md exists? +`LONG_CONTEXT.md`는 세션 복구를 위한 문서입니다. +새로운 세션이나 다른 모델이 프로젝트를 재개할 때 필요한 핵심 상태를 요약하여 빠르게 부트스트랩할 수 있게 합니다. -LONG_CONTEXT.md captures the essential state needed to resume a project. It lets a new session bootstrap the model without losing history. +## Agent Framework와 무엇이 다른가? -## Why models are replaceable? +Agent Framework는 AI 에이전트 실행 환경에 초점을 둡니다. +REPL Works는 에이전트를 실행하는 프레임워크가 아니라, 프로젝트 기억과 문서 중심의 시스템입니다. -Models should be tools, not project owners. REPL Works stores project memory externally so the project is not locked to any single model. +## REPL Works는 오픈소스인가? + +REPL Works는 오픈소스 철학을 지향하며, 문서와 정책을 공개적으로 검증 가능한 형태로 제공합니다. +이 사이트는 오픈소스 개발 방식에 맞춘 프로젝트 기억 예시를 보여줍니다. + +## REPL Works는 개발에만 사용할 수 있는가? + +REPL Works는 주로 AI Development를 위한 Project Memory System이지만, +문서 중심의 기억 저장과 계획-실행 분리를 필요로 하는 다른 지식 집약 프로젝트에도 적용할 수 있습니다. diff --git a/src/content/resources/index.mdx b/src/content/resources/index.mdx index 6ec3cdf..ce402bd 100644 --- a/src/content/resources/index.mdx +++ b/src/content/resources/index.mdx @@ -7,16 +7,16 @@ publishedAt: '2026-06-07T00:00:00Z' # Resources -The REPL Works Resources section organizes practical support materials for project memory. +REPL Works Resources 섹션은 프로젝트 기억을 지원하는 실용 자료를 정리합니다. -- **Templates** — reusable document structures for consistent project artifacts. -- **Example Documents** — concrete sample files for common REPL Works outputs. -- **Long Context Examples** — session recovery summaries for different project sizes. -- **Repository Examples** — Git-first repository layouts aligned to REPL Works. -- **Planning Examples** — planning runtime outputs that separate strategy from work. -- **FAQ** — concise answers to core REPL Works concepts. +- **Templates** — 일관된 프로젝트 문서를 위한 재사용 가능한 템플릿. +- **Example Documents** — REPL Works에 맞춘 실제 문서 예시. +- **Long Context Examples** — 세션 복구를 위한 문맥 요약 예시. +- **Repository Examples** — Git 중심 리포지토리 구조 예시. +- **Planning Examples** — 전략과 실행을 분리하는 계획 문서 예시. +- **FAQ** — REPL Works 핵심 개념에 대한 간결한 답변. -## Navigate +## 이동 - [Templates](/resources/templates) - [Example Documents](/resources/example-documents) diff --git a/src/content/resources/long-context-examples.mdx b/src/content/resources/long-context-examples.mdx index ce988e3..7e65fed 100644 --- a/src/content/resources/long-context-examples.mdx +++ b/src/content/resources/long-context-examples.mdx @@ -7,35 +7,599 @@ publishedAt: '2026-06-07T00:00:00Z' # Long Context Examples -## Small Project Recovery +````markdown +# LONG_CONTEXT.md -When resuming a small project, provide a concise summary of intent, recent decisions, and next actions. +Version 1.0 -- Project: launch a documentation site. -- Current state: Astro site scaffolded, manifesto published. -- Goal: publish Resources and Showcase sections. -- Next actions: add resources content and verify build. +--- + +# Current Project + +REPL Works + +Project Memory System for AI Development + +--- + +# Current Status + +REPL Works는 구현 단계가 아니라 정의 단계에 있다. + +현재 논의의 중심은 다음 두 가지다. + +1. REPL Works 자체의 방법론 정립 +2. REPL Works 웹사이트 구성 + +--- + +현재까지 정의되었거나 초안이 존재하는 문서 + +```text +MANIFESTO.md +WHY.md +ORIGIN.md +SPECIFICATION.md +WORKFLOW.md +IDEAS.md +PITCHING_SCRIPT.md +``` + +--- + +웹사이트는 아직 구현되지 않았으며, + +문서 구조와 메시지 정리가 우선이다. + +--- + +# Key Decisions + +## REPL Works는 Workflow가 아니다 + +초기에는 AI Development Workflow처럼 보였다. + +그러나 논의를 통해 더 정확한 정의에 도달했다. + +REPL Works의 본질은 Workflow가 아니다. + +REPL Works는 + +Project Memory System + +이다. + +--- + +## 핵심 문제는 지능이 아니라 기억이다 + +AI 기반 개발의 실패 원인은 + +모델 성능 부족보다 + +프로젝트 기억의 부재에 가깝다고 판단했다. + +--- + +프로젝트는 수년간 유지된다. + +모델은 교체된다. + +세션은 종료된다. + +채팅 기록은 사라진다. + +--- + +따라서 프로젝트 기억은 + +Runtime이 아니라 Repository에 존재해야 한다. + +--- + +## Repository가 기억의 중심이다 + +프로젝트를 복원할 수 있는 기억은 + +Repository 안에 존재해야 한다. + +--- + +Git은 단순 버전 관리 도구가 아니다. + +프로젝트 기억 저장소다. + +--- + +## 장기적으로 중요한 문서 + +논의를 거치며 다음 결론에 도달했다. + +프로젝트를 장기간 유지하기 위해 가장 중요한 자산은 + +```text +AGENTS.md +ARCHITECTURE.md +TASKS.md +Git History +``` + +이다. + +--- + +특히 + +Architecture + Tasks + +조합이 핵심이라고 판단했다. + +--- + +## IDEAS.md의 역할 + +IDEAS.md는 사업적 사고를 정리하기 위한 문서다. + +--- + +사용자는 IDEAS.md 작성 시 다음 질문을 중요하게 생각한다. + +- 사업 관점에서 충분히 매력적인가 +- 2년 비용을 감당 가능한가 +- BEP는 언제 달성되는가 +- 사용자 성장 예상은 어떠한가 + +--- + +IDEAS.md는 정확한 예측 문서가 아니다. + +아이디어를 현실적인 프로젝트로 정제하는 과정이다. + +--- + +## PITCHING_SCRIPT.md의 역할 + +IDEAS.md 확정 후 생성한다. + +--- + +목적은 두 가지다. + +1. 사람이 프로젝트 의도를 빠르게 이해 +2. 새로운 LLM이 프로젝트 의도를 빠르게 이해 + +--- -> Use this summary at the start of a new session to bootstrap the model. +다만 장기적으로는 -## Mid-Scale Project Recovery +ARCHITECTURE.md만으로도 프로젝트 이해가 가능해야 한다는 철학이 존재한다. -Capture context across several documents and progress checkpoints. +--- + +## Planning Runtime과 Execution Runtime 분리 + +중요한 결정 중 하나. + +--- + +문서 생성 및 수정은 기본적으로 채팅창에서 수행한다. + +--- + +코딩창은 구현을 수행한다. + +--- + +이유는 Context 오염 방지와 Diff 최소화다. + +--- + +문서 수정이 코딩창에서 이루어지면 + +불필요한 변경사항이 증가하는 경향이 있다. + +--- + +예외적으로 + +개발 도중 + +ARCHITECTURE.md + +TASKS.md -- Project scope: documentation platform with content collections and publishing workflow. -- Completed: home, why, manifesto, specification, workflow. -- In progress: resources layer and showcase examples. -- Constraints: static MDX only, no runtime logic. -- Key decisions: Git-first memory, content-first model, modular task phases. +수정은 허용된다. + +--- + +그러나 가능하면 채팅창에서 다시 정리한다. + +--- + +## Validation 단계 제거 + +초기 Workflow에는 Validation 단계가 존재했다. + +--- + +그러나 논의 결과 제거되었다. + +--- + +대신 + +Test + +Lint + +Build + +성공이 AGENTS.md 수준의 기본 규칙으로 승격된다. + +--- + +모든 코드에는 Unit Test가 존재해야 한다. + +--- -## Large-Scale Compressed Context Format +Unit Test는 AI 환각 방지 장치로 간주된다. + +--- + +## LONG_CONTEXT는 프로젝트 문서가 아니다 + +매우 중요한 결정. + +--- + +LONG_CONTEXT는 + +Project Memory가 아니다. + +--- + +Session Memory다. + +--- + +따라서 + +AGENTS.md + +ARCHITECTURE.md + +TASKS.md + +어디에서도 자동 참조하면 안 된다. + +--- + +LLM의 규칙 시스템에 포함되면 안 된다. + +--- + +사용자가 새로운 Session 시작 시 수동으로 제공하는 문서다. + +--- + +# Important Insights + +## Agent Framework 실험이 출발점이었다 + +사용자는 LangGraph, CrewAI 등의 Agent Framework를 실제로 검토했다. + +--- + +왜 Agent가 필요한지 이해했다. + +--- + +그러나 실제 적용 과정에서 + +복잡성이 빠르게 증가한다고 판단했다. + +--- + +결론은 + +더 많은 Agent가 아니라 + +더 좋은 Project Memory였다. + +--- -Provide a compressed, high-level snapshot for large projects. +## 프로젝트는 대화보다 오래 살아남는다 + +현재 REPL Works 철학의 핵심. + +--- + +대화는 사라진다. + +모델은 교체된다. + +프로젝트는 남는다. + +--- + +따라서 + +프로젝트 기억은 외부화되어야 한다. + +--- + +## Memory Ownership + +가장 중요한 통찰 중 하나. + +--- + +프로젝트는 자신의 기억을 소유해야 한다. + +--- + +Chat History가 기억이 되어서는 안 된다. + +--- + +Repository가 기억이 되어야 한다. + +--- + +## Long Context의 필요성 + +반면 Session도 완전히 무시할 수는 없다. + +--- + +프로젝트 문서만으로는 + +최근 논의 + +결정 배경 + +현재 고민 + +미해결 질문 + +을 모두 복원하기 어렵다. + +--- + +그래서 LONG_CONTEXT 개념이 탄생했다. + +--- + +LONG_CONTEXT는 + +Project Memory가 아니라 + +Session Bootstrap이다. + +--- + +# Open Questions + +## LONG_CONTEXT의 최적 구조 + +현재 버전은 존재한다. + +--- + +그러나 장기적으로 어떤 정보를 남겨야 하는지 + +아직 표준화되지 않았다. + +--- + +## Prompt History 저장 여부 + +현재는 미정. + +--- + +TASK 수행 시 사용한 Prompt를 + +저장할 필요가 있는지 + +아직 결론이 없다. + +--- + +## REPL Works Compatible + +향후 + +Built with REPL Works + +또는 + +REPL Works Compatible + +개념이 필요할 가능성이 있다. + +--- + +정의는 아직 확정되지 않았다. + +--- + +## Architecture Synchronization Rule + +TASKS 변경 시 + +ARCHITECTURE 변경이 필요한 경우 + +자동 규칙으로 강제할 수 있는지 + +실험이 필요하다. + +--- + +# Current Direction + +현재 목표는 + +REPL Works 웹사이트 구축이다. + +--- + +웹사이트는 제품이면서 + +동시에 첫 번째 Showcase가 된다. + +--- + +즉 + +REPL Works를 이용하여 + +REPL Works를 만드는 구조를 목표로 한다. + +--- + +현재 메시지 + +```text +Models forget. + +Projects must not. +``` + +--- + +현재 정의 + +```text +Project Memory System for AI Development +``` + +--- + +# Website Direction + +현재 합의된 메뉴 + +```text +Home +Why +Manifesto +Specification +Workflow +Showcase +Resources +``` + +--- + +추가 후보 + +```text +Getting Started +FAQ +``` + +--- + +Resources는 + +실전 자료 저장소 역할을 수행한다. + +--- + +특히 중요하다고 판단한 항목 + +```text +Templates +Example Documents +Repository Examples +Prompt Examples +Long Context Examples +``` + +--- + +# Next Discussion Topics + +## REPL Works Website Architecture + +실제 구현 구조 정의 + +--- + +## REPL Works Compatible Definition + +표준 적합성 정의 + +--- + +## First Showcase Project + +REPL Works Website 자체 + +--- + +## Template Repository + +Starter Template 설계 + +--- + +## Long Context Standardization + +LONG_CONTEXT 생성 규칙 정교화 + +--- + +## Adoption Strategy + +개발자들이 실제로 사용할 수 있도록 + +어떤 방식으로 확산할 것인지 + +--- + +# Current Founder Philosophy + +AI를 더 똑똑하게 만드는 것이 목표가 아니다. + +--- + +AI가 바뀌어도 프로젝트가 유지되는 것이 목표다. + +--- + +Agent를 만드는 것이 목표가 아니다. + +--- + +프로젝트 기억을 소유하는 것이 목표다. + +--- + +최종적으로 REPL Works는 + +AI 시대의 Agile Manifesto + +또는 + +Conventional Commits + +같은 위치를 지향한다. + +--- + +# Most Important Statement + +Projects outlive sessions. + +Projects outlive models. + +Therefore project memory must live outside the model. + +--- -- Project: REPL Works website. -- Status: core content published, resources publishing phase active. -- Architecture: content collections, MDX, static site. -- Policies: one prompt one task, task-per-commit. -- Immediate next task: create resources index and resource documents. +Models forget. -> This format is designed for fast AI session bootstrapping and recovery. +Projects must not. +```` diff --git a/src/content/resources/planning-examples.mdx b/src/content/resources/planning-examples.mdx index 78962c8..ab2be87 100644 --- a/src/content/resources/planning-examples.mdx +++ b/src/content/resources/planning-examples.mdx @@ -7,22 +7,22 @@ publishedAt: '2026-06-07T00:00:00Z' # Planning Examples -## Idea Refinement Flow +## 아이디어 정제 흐름 -1. Input: broad concept or problem statement. -2. Output: clarified idea summary and benefits. -3. Next step: convert idea into architecture or tasks. +1. 입력: 광범위한 개념 또는 문제 진술. +2. 출력: 명확해진 아이디어 요약과 이점. +3. 다음 단계: 아이디어를 아키텍처 또는 태스크로 전환. -## Architecture Decision Flow +## 아키텍처 결정 흐름 -1. Input: project purpose and user actions. -2. Output: architecture sections and product boundaries. -3. Next step: publish ARCHITECTURE.md and align content collections. +1. 입력: 프로젝트 목적과 사용자 행동. +2. 출력: 아키텍처 섹션과 제품 경계. +3. 다음 단계: ARCHITECTURE.md를 게시하고 콘텐츠 컬렉션을 정렬. -## Task Breakdown Flow +## 태스크 분해 흐름 -1. Input: defined project goal. -2. Output: ordered tasks with completion rules. -3. Next step: execute the next task and keep tasks granular. +1. 입력: 정의된 프로젝트 목표. +2. 출력: 완료 규칙이 있는 순서화된 태스크. +3. 다음 단계: 다음 태스크를 실행하고 태스크를 세분화. -This separation keeps planning distinct from implementation. +이 분리는 계획과 구현을 명확하게 구분합니다. diff --git a/src/content/resources/repository-examples.mdx b/src/content/resources/repository-examples.mdx index 4532f5a..a257386 100644 --- a/src/content/resources/repository-examples.mdx +++ b/src/content/resources/repository-examples.mdx @@ -7,7 +7,7 @@ publishedAt: '2026-06-07T00:00:00Z' # Repository Examples -## Minimal Repo +## 최소 구성 리포지토리 ```text src/ @@ -21,7 +21,7 @@ TASKS.md ARCHITECTURE.md ``` -## Full Production Repo +## 전체 프로덕션 리포지토리 ```text src/ @@ -44,7 +44,7 @@ TASKS.md ARCHITECTURE.md ``` -## Multi-Service Repo (Conceptual) +## 다중 서비스 리포지토리 (개념적) ```text services/ @@ -65,4 +65,4 @@ TASKS.md ARCHITECTURE.md ``` -This structure keeps documentation and code aligned under Git-first project memory. +이 구조는 Git-first 프로젝트 기억 아래에서 문서와 코드를 정렬합니다. diff --git a/src/content/resources/templates.mdx b/src/content/resources/templates.mdx index 57edda6..65833be 100644 --- a/src/content/resources/templates.mdx +++ b/src/content/resources/templates.mdx @@ -7,7 +7,7 @@ publishedAt: '2026-06-07T00:00:00Z' # Templates -## IDEAS.md Template +## IDEAS.md 템플릿 ```md # IDEAS @@ -31,7 +31,7 @@ publishedAt: '2026-06-07T00:00:00Z' - Action 2 ``` -## ARCHITECTURE.md Template +## ARCHITECTURE.md 템플릿 ```md # ARCHITECTURE @@ -53,7 +53,7 @@ publishedAt: '2026-06-07T00:00:00Z' - User flow through the product. ``` -## TASKS.md Template +## TASKS.md 템플릿 ```md # TASKS @@ -73,7 +73,7 @@ publishedAt: '2026-06-07T00:00:00Z' - One Task = One Commit ``` -## PITCHING_SCRIPT.md Template +## PITCHING_SCRIPT.md 템플릿 ```md # PITCHING SCRIPT diff --git a/src/content/showcase/claytube.mdx b/src/content/showcase/claytube.mdx new file mode 100644 index 0000000..9c92b0f --- /dev/null +++ b/src/content/showcase/claytube.mdx @@ -0,0 +1,35 @@ +--- +title: 'ClayTube' +version: 'v1' +description: 'Public adoption example emphasizing long-term continuity and session recovery.' +publishedAt: '2026-06-07T00:00:00Z' +--- + +# ClayTube + +## 프로젝트 설명 + +ClayTube는 다중 세션에 걸쳐 연속성을 보존하는 공개 프로젝트 사례입니다. + +## 웹사이트 / 저장소 + +- Website: https://www.etern.co.kr/claytube +- Repository: https://github.com/eternops/claytube + +## 장기 프로젝트 연속성 + +- 프로젝트는 Git과 구조화된 문서에 내구성 있는 기억을 유지합니다. +- 구현 세부 사항이 진화해도 아키텍처와 태스크는 안정적으로 유지됩니다. +- 이 프로젝트는 몇 달 동안 중단을 견디도록 설계되었습니다. + +## LONG_CONTEXT.md를 통한 세션 복구 + +- 복구 요약은 `LONG_CONTEXT.md`에 저장되어 새로운 세션을 부트스트랩합니다. +- 긴 컨텍스트 형식은 의도, 진행 상황, 다음 행동을 캡처합니다. +- 이를 통해 새로운 세션은 전체 맥락을 다시 구성하지 않고도 빠르게 재개할 수 있습니다. + +## AI 모델 전환 + +- 이 프로젝트는 단일 AI 모델에 의존하지 않습니다. +- 모델이 바뀌어도 문서화된 프로젝트 기억이 연속성을 제공합니다. +- 모델 전환은 세션 상태가 아니라 리포지토리와 문서를 통해 관리됩니다. diff --git a/src/content/showcase/etern-labs.mdx b/src/content/showcase/etern-labs.mdx new file mode 100644 index 0000000..a2c4e4c --- /dev/null +++ b/src/content/showcase/etern-labs.mdx @@ -0,0 +1,35 @@ +--- +title: 'ETERN Labs' +version: 'v1' +description: 'Public adoption example emphasizing architecture consistency and model independence.' +publishedAt: '2026-06-07T00:00:00Z' +--- + +# ETERN Labs + +## 프로젝트 설명 + +Labs는 공개 프로젝트 사례로, REPL Works를 통해 아키텍처 일관성과 실행 연속성을 유지합니다. + +## 웹사이트 / 저장소 + +- Website: https://www.etern.co.kr/labs +- Repository: https://github.com/eternops/labs + +## 아키텍처 일관성 + +- 아키텍처는 `ARCHITECTURE.md`에 사전 정의되고 모든 변경에서 보존됩니다. +- 콘텐츠 컬렉션과 문서 구조는 프로젝트 전반에서 동일한 개념 모델을 따릅니다. +- 의사 결정은 대화에 묻히지 않고 명시적으로 기록됩니다. + +## 태스크 중심 개발 + +- 작업은 `TASKS.md`의 명확한 태스크로 분해됩니다. +- 각 태스크는 하나의 프롬프트와 하나의 커밋 단위로 진행되어 진척도를 측정할 수 있습니다. +- 태스크 산출물은 일시적인 메모가 아니라 정적 문서입니다. + +## 모델 독립성 + +- 이 프로젝트는 연속성을 위해 특정 AI 모델에 의존하지 않습니다. +- 기억은 Git과 파일 기반 문서에 보관되어 모델이 변경되어도 워크플로가 유효합니다. +- 이 시스템은 문서를 읽고 업데이트할 수 있는 모든 모델로 동작하도록 설계되었습니다. diff --git a/src/content/showcase/eternops.mdx b/src/content/showcase/eternops.mdx new file mode 100644 index 0000000..e6ce99c --- /dev/null +++ b/src/content/showcase/eternops.mdx @@ -0,0 +1,29 @@ +--- +title: 'ETERNOps' +version: 'v1' +description: 'Public adoption example demonstrating REPL Works memory and Git workflow.' +publishedAt: '2026-06-07T00:00:00Z' +--- + +# Etern + +## 프로젝트 설명 + +Etern은 공개 프로젝트 사례로, REPL Works를 통해 프로젝트 기억과 의도를 보존합니다. + +## 웹사이트 / 저장소 + +- Website: https://www.etern.co.kr +- Repository: https://github.com/eternops/eternops.github.io + +## 메모리 시스템 적용 + +- 프로젝트 지식은 버전 관리 파일인 `ARCHITECTURE.md`, `TASKS.md`, 콘텐츠 컬렉션에 저장됩니다. +- 콘텐츠 우선 구조를 사용하여 상태를 명시적으로 표현하고 복구 가능하게 만듭니다. +- 변경 사항은 Git에 기록되어 향후 세션에 대한 역사와 맥락을 제공합니다. + +## Git 기반 워크플로 사용 + +- 새로운 작업은 `TASKS.md`의 개별 태스크로 도입됩니다. +- 각 태스크는 문서화된 커밋으로 구현됩니다. +- 리포지토리는 프로젝트 기억의 출처로 사용되어 세션 기억에 의존하지 않고 작업을 재개할 수 있습니다. diff --git a/src/content/showcase/index.mdx b/src/content/showcase/index.mdx index cf5367d..f18a4ff 100644 --- a/src/content/showcase/index.mdx +++ b/src/content/showcase/index.mdx @@ -7,20 +7,23 @@ publishedAt: '2026-06-07T00:00:00Z' # Showcase -Showcase is proof of adoption, not marketing. It documents real usage patterns and conceptual examples that demonstrate how REPL Works is applied. +Showcase는 마케팅이 아니라 Proof of Adoption입니다. +실제 프로젝트 사례와 도입 패턴을 통해 REPL Works가 어떻게 적용되는지 보여줍니다. ## Projects -- **REPL Works Website** — reference implementation built with REPL Works. -- **Project A** — abstract example showing Git-based memory and workflow. -- **Project B** — example emphasizing architecture consistency and model independence. -- **Project C** — example demonstrating long-term continuity and session recovery. -- **Project D** — example showing multi-model collaboration and planning separation. +- **REPL Works Website** — REPL Works 자체의 레퍼런스 구현입니다. +- **Etern** — 공개 프로젝트 사례로서 Git-first 기억 체계를 보여줍니다. +- **Labs** — 아키텍처 일관성과 모델 독립성을 강조하는 공개 사례입니다. +- **ClayTube** — 장기 지속성과 세션 복구를 중심으로 적용된 공개 사례입니다. +- **MMA** — 비공개 프로젝트 사례로, 웹사이트 정보만 제공되고 저장소는 공개되지 않습니다. +- **MMA Scrapers** — 비공개 프로젝트 사례로, 프로젝트명만 공유합니다. ## Navigation - [REPL Works Website](/showcase/repl-works-website) -- [Project A](/showcase/project-a) -- [Project B](/showcase/project-b) -- [Project C](/showcase/project-c) -- [Project D](/showcase/project-d) +- [ETERNOps ](/showcase/eternops) +- [ETERN Labs](/showcase/etern-labs) +- [ClayTube](/showcase/claytube) +- [MMA](/showcase/mma) +- [WIFI Note](/showcase/wifi-note) diff --git a/src/content/showcase/mma.mdx b/src/content/showcase/mma.mdx new file mode 100644 index 0000000..5e6ead6 --- /dev/null +++ b/src/content/showcase/mma.mdx @@ -0,0 +1,35 @@ +--- +title: 'MMA' +version: 'v1' +description: 'Private project example showing REPL Works collaboration and planning separation.' +publishedAt: '2026-06-07T00:00:00Z' +--- + +# MMA + +## 프로젝트 설명 + +MMA는 비공개 프로젝트 사례로, 프로젝트명만 공개되어 있습니다. + +## 공개 정보 + +- Website: 제공되지 않음 +- Repository: 비공개 + +## 협업 워크플로 + +- 여러 AI 모델과 사람이 동일한 문서화된 기억을 공유합니다. +- 리포지토리는 프로젝트 상태를 저장하여 연속성을 유지합니다. +- 산출물은 단일 모델 세션이 아니라 파일과 문서에 기록됩니다. + +## 의사 결정 루프 + +- 인간은 `ARCHITECTURE.md`와 `TASKS.md`에 기록된 결정을 검토하고 승인합니다. +- AI가 생성한 제안은 콘텐츠로 기록된 후 팀에서 검증됩니다. +- 이 루프는 Git 기록을 통해 명시적이고 추적 가능하게 유지됩니다. + +## 계획과 실행 분리 + +- 계획 산출물은 실행 산출물과 분리되어 유지됩니다. +- `TASKS.md`는 계획을 정의하고, 콘텐츠 컬렉션은 결과 문서를 보관합니다. +- 이 분리는 전략이 구현 세부 사항과 혼합되지 않도록 합니다. diff --git a/src/content/showcase/project-a.mdx b/src/content/showcase/project-a.mdx deleted file mode 100644 index 3c55742..0000000 --- a/src/content/showcase/project-a.mdx +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 'Project A Showcase' -version: 'v1' -description: 'Conceptual example showing REPL Works memory and Git workflow.' -publishedAt: '2026-06-07T00:00:00Z' ---- - -# Project A Showcase - -## Project Description - -Project A is an abstract documentation project that uses REPL Works to preserve project intent and decisions. - -## Memory System Applied - -- Project knowledge is stored in versioned files: `ARCHITECTURE.md`, `TASKS.md`, and content collections. -- The project uses a content-first structure so state is explicit and recoverable. -- Changes are documented in Git, providing history and context for future sessions. - -## Git-based Workflow Usage - -- New work is introduced through discrete tasks in `TASKS.md`. -- Each task is implemented as a documented commit. -- The repository serves as the project memory source, enabling the team to resume work without relying on in-session memory. diff --git a/src/content/showcase/project-b.mdx b/src/content/showcase/project-b.mdx deleted file mode 100644 index 4b32b04..0000000 --- a/src/content/showcase/project-b.mdx +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: 'Project B Showcase' -version: 'v1' -description: 'Conceptual example with architecture consistency and task-driven development.' -publishedAt: '2026-06-07T00:00:00Z' ---- - -# Project B Showcase - -## Project Description - -Project B is a conceptual initiative that applies REPL Works to maintain consistent architecture and execution. - -## Architecture Consistency - -- Architecture is defined up front in `ARCHITECTURE.md` and preserved with every change. -- Content collections and document structure follow the same conceptual model across the project. -- Decisions are made explicit rather than buried in conversation. - -## Task-driven Development - -- Work is broken into clear tasks in `TASKS.md`. -- Each task is scoped to one prompt and one commit, making progress measurable. -- Task outputs are static documents, not ephemeral notes. - -## Model Independence - -- The project does not rely on a specific AI model for continuity. -- Memory is kept in Git and file-based documents, so the workflow remains valid if the model changes. -- The system is designed to work with any model that can read and update the documented content. diff --git a/src/content/showcase/project-c.mdx b/src/content/showcase/project-c.mdx deleted file mode 100644 index a1273e3..0000000 --- a/src/content/showcase/project-c.mdx +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: 'Project C Showcase' -version: 'v1' -description: 'Conceptual example emphasizing long-term continuity and session recovery.' -publishedAt: '2026-06-07T00:00:00Z' ---- - -# Project C Showcase - -## Project Description - -Project C is a long-lived initiative that uses REPL Works to preserve continuity across many sessions. - -## Long-term Project Continuity - -- The project maintains durable memory in Git and structured documents. -- Architecture and tasks remain stable even as implementation details evolve. -- The project is designed to survive months of interruption. - -## Session Recovery via LONG_CONTEXT.md - -- Recovery summaries are stored in `LONG_CONTEXT.md` to bootstrap new sessions. -- The long-context format captures intent, progress, and next actions. -- This allows new sessions to resume quickly without rebuilding context from scratch. - -## AI Model Switching - -- The project does not depend on a single AI model. -- If the model changes, the documented project memory still provides continuity. -- Model switching is managed through the repository and files, not through session state. diff --git a/src/content/showcase/project-d.mdx b/src/content/showcase/project-d.mdx deleted file mode 100644 index 6b11917..0000000 --- a/src/content/showcase/project-d.mdx +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: 'Project D Showcase' -version: 'v1' -description: 'Conceptual example of multi-model collaboration and human + AI decision loops.' -publishedAt: '2026-06-07T00:00:00Z' ---- - -# Project D Showcase - -## Project Description - -Project D is a conceptual example of a collaborative workflow where AI and humans work together using REPL Works. - -## Multi-model Collaboration - -- Multiple AI models can contribute to the project, each reading the same documented memory. -- The repository stores the project state, allowing different models to participate without disrupting continuity. -- Output is captured in files, not in a single model session. - -## AI + Human Decision Loop - -- Humans review and approve decisions documented in `ARCHITECTURE.md` and `TASKS.md`. -- AI-generated suggestions are recorded as content and then validated by the team. -- The loop remains explicit and traceable through Git history. - -## Planning vs Execution Separation - -- Planning artifacts are kept separate from execution outputs. -- `TASKS.md` defines the plan, while content collections hold the resulting documentation. -- This separation ensures that strategy is not mixed with implementation details. diff --git a/src/content/showcase/repl-works-website.mdx b/src/content/showcase/repl-works-website.mdx index ca1b6fa..53f417a 100644 --- a/src/content/showcase/repl-works-website.mdx +++ b/src/content/showcase/repl-works-website.mdx @@ -7,22 +7,22 @@ publishedAt: '2026-06-07T00:00:00Z' # REPL Works Website Showcase -This website is the reference implementation for REPL Works. +이 웹사이트는 REPL Works의 레퍼런스 구현입니다. -## Built with REPL Works +## REPL Works 적용 방식 -- The site is organized as content collections in `src/content`. -- Core sections are published as MDX documents: Manifesto, Specification, Workflow, Resources, and Showcase. -- The site shell and routing are driven by static documentation content. +- 사이트는 `src/content`의 콘텐츠 컬렉션으로 구성되어 있습니다. +- 핵심 섹션은 MDX 문서로 게시됩니다: Manifesto, Specification, Workflow, Resources, Showcase. +- 사이트 셸과 라우팅은 정적 문서 콘텐츠에 의해 구동됩니다. -## AGENTS / ARCHITECTURE / TASKS mapping +## AGENTS / ARCHITECTURE / TASKS 매핑 -- **AGENTS** are represented by the content-first process: each task is discrete and documented, and the AI interaction model is externalized in the project memory. -- **ARCHITECTURE** is captured in `ARCHITECTURE.md` and reflected in the site structure and navigation. -- **TASKS** are tracked in `TASKS.md`, with each phase and task scoped to one prompt and one commit. +- **AGENTS**는 콘텐츠 우선 프로세스를 통해 문서화된 작업 단위와 프로젝트 기억으로 표현됩니다. +- **ARCHITECTURE**는 `ARCHITECTURE.md`에 캡처되어 사이트 구조와 탐색에 반영됩니다. +- **TASKS**는 `TASKS.md`에서 추적되며, 각 단계는 하나의 프롬프트와 하나의 커밋 단위입니다. -## Workflow adoption evidence +## 워크플로 도입 증거 -- Content is published incrementally through task phases, demonstrating the workflow of publishing project documentation. -- The site uses a Git-first memory model: all decisions and outputs are stored in versioned files. -- The Resources and Showcase sections document practical usage and adoption evidence, showing the workflow in action. +- 콘텐츠는 태스크 단계별로 점진적으로 게시되어 문서화 워크플로를 입증합니다. +- 이 사이트는 Git-first 기억 모델을 사용하며 모든 결정과 출력은 버전 관리된 파일에 저장됩니다. +- Resources와 Showcase 섹션은 실용적 사용과 채택 증거를 문서화하여 워크플로가 실제로 작동함을 보여줍니다. diff --git a/src/content/showcase/wifi-note.mdx b/src/content/showcase/wifi-note.mdx new file mode 100644 index 0000000..cd51156 --- /dev/null +++ b/src/content/showcase/wifi-note.mdx @@ -0,0 +1,33 @@ +--- +title: 'WIFI Note' +version: 'v1' +description: 'Private project example for REPL Works applied to scraper development.' +publishedAt: '2026-06-07T00:00:00Z' +--- + +# WIFI Note + +## 프로젝트 설명 + +WIFI Note는 비공개 프로젝트 사례로, 프로젝트명과 도입 패턴만 공개합니다. + +## 공개 정보 + +- Website: 제공되지 않음 +- Repository: 비공개 + +## 문서 중심 메모리 + +- 도메인 지식과 설계 의도는 문서화된 프로젝트 기억에 기록됩니다. +- `ARCHITECTURE.md`와 `TASKS.md`는 프로젝트 구조와 실행 계획을 명확히 합니다. +- 세션 간 연속성은 Git과 문서에 저장된 기억으로 유지됩니다. + +## 세션 복구 + +- 세션 복구가 필요할 때는 `LONG_CONTEXT.md`를 통해 핵심 상태를 복원합니다. +- 이 접근 방식은 모델 상태에 의존하지 않고 프로젝트를 이어가는 데 도움이 됩니다. + +## 비공개 사례의 목적 + +- 프로젝트명만 공개하면서도 도입 패턴을 공유합니다. +- 개인 정보와 내부 저장소는 공개하지 않지만, 프로세스는 재현 가능합니다. diff --git a/src/content/specification/v1.mdx b/src/content/specification/v1.mdx index 9da3baf..b21229b 100644 --- a/src/content/specification/v1.mdx +++ b/src/content/specification/v1.mdx @@ -28,7 +28,7 @@ REPL Works는 AI 시대를 위한 **Project Memory System**이다. --- -# Rule 1. Git First +# 규칙 1. Git 우선 모든 프로젝트는 Git Repository로 시작해야 한다. @@ -40,7 +40,7 @@ git init --- -# Rule 2. Repository Is The Memory System +# 규칙 2. 리포지토리는 기억 시스템이다 프로젝트에 필요한 기억은 모델 내부가 아닌 Repository 내부에 존재해야 한다. @@ -48,7 +48,7 @@ git init --- -# Rule 3. AGENTS.md Is The Constitution +# 규칙 3. AGENTS.md는 헌법이다 모든 프로젝트는 `AGENTS.md`를 가져야 한다. `AGENTS.md`는 프로젝트 헌법이다. @@ -61,7 +61,7 @@ git init - 개발 규칙 - 테스트 규칙 - 문서 위치 -- 논리적 Agent 정의 위치 +- 논리적 에이전트 정의 위치 --- @@ -69,7 +69,7 @@ git init --- -# Rule 4. Architecture Is Mandatory +# 규칙 4. 아키텍처는 필수이다 모든 프로젝트는 `ARCHITECTURE.md`를 가져야 한다. @@ -101,17 +101,17 @@ architecture/ --- -# Rule 5. Tasks Are Mandatory +# 규칙 5. 태스크는 필수이다 모든 프로젝트는 `TASKS.md`를 가져야 한다. --- -`TASKS.md`는 TODO List다. +`TASKS.md`는 TODO 목록이다. --- -Task는 반드시 Phase 단위로 관리한다. +태스크는 반드시 Phase 단위로 관리한다. ```text Phase 1 @@ -131,9 +131,9 @@ Phase 2 --- -# Rule 6. Planning And Execution Must Be Separated +# 규칙 6. 계획과 실행은 분리되어야 한다 -계획 수립과 구현은 서로 다른 Runtime에서 수행한다. +계획 수립과 구현은 서로 다른 런타임에서 수행한다. --- @@ -158,7 +158,7 @@ Phase 2 --- -# Rule 7. Documentation Is AI Infrastructure +# 규칙 7. 문서는 AI 인프라다 `README.md`를 제외한 대부분 문서는 AI를 위한 문서다. @@ -169,7 +169,7 @@ Phase 2 --- -# Rule 8. Every Feature Requires Tests +# 규칙 8. 모든 기능에는 테스트가 필요하다 모든 기능은 테스트를 포함해야 한다. @@ -180,7 +180,7 @@ Phase 2 --- -# Rule 9. Architecture And Tasks Must Stay Consistent +# 규칙 9. 아키텍처와 태스크는 일관성을 유지해야 한다 `TASKS.md` 변경이 Architecture에 영향을 준다면 `ARCHITECTURE.md`도 함께 수정되어야 한다. @@ -191,7 +191,7 @@ Phase 2 --- -# Rule 10. Models Are Replaceable +# 규칙 10. 모델은 교체 가능해야 한다 REPL Works는 특정 모델에 의존하지 않는다. @@ -206,11 +206,11 @@ REPL Works는 특정 모델에 의존하지 않는다. --- 모델은 교체 가능해야 한다. -프로젝트 기억은 유지되어야 한다. +프로젝트의 가치는 Git에 저장된 지식에 있다. --- -# Rule 11. Session Memory Is Optional +# 규칙 11. 세션 기억은 선택적이다 프로젝트 기억과 세션 기억은 다르다. @@ -241,7 +241,7 @@ REPL Works는 특정 모델에 의존하지 않는다. --- -# Compliance +# 준수 프로젝트가 **REPL Works Compatible**이려면 최소한 다음을 만족해야 한다. @@ -253,4 +253,4 @@ REPL Works는 특정 모델에 의존하지 않는다. --- -이 다섯 가지가 REPL Works의 최소 요구사항이다. +이 다섯 가지는 REPL Works의 최소 요구사항이다. diff --git a/src/content/workflow/v1.md b/src/content/workflow/v1.md index 6973f44..a168a70 100644 --- a/src/content/workflow/v1.md +++ b/src/content/workflow/v1.md @@ -1,12 +1,12 @@ --- -title: 'AI-Native Product Development Workflow' +title: 'Project Memory System for AI Development' version: 'v1' type: 'workflow' description: 'AI 시대에 프로젝트의 기억을 Git 기반 문서로 외부화하여 모델에 의존하지 않고 지속 가능하게 관리하는 Project Memory System.' publishedAt: '2026-06-06T00:00:00Z' --- -# Philosophy +# 철학 AI 시대의 핵심 문제는 코드를 생성하는 능력이 아니다. @@ -21,34 +21,33 @@ AI 시대의 핵심 문제는 코드를 생성하는 능력이 아니다. --- -REPL Works는 AI Agent Framework가 아니다. - -REPL Works는 AI가 따라야 하는 Project Operating System이다. +REPL Works는 AI 에이전트 프레임워크가 아니다. +REPL Works는 AI Development를 위한 Project Memory System이다. --- -# Core Principles +# 핵심 원칙 -## AI Writes, Human Approves +## AI 작성, 인간 검수 모든 문서는 AI가 작성한다. 모든 코드는 AI가 작성한다. -Human은 방향을 결정하고 결과를 검수한다. +인간은 방향을 결정하고 결과를 검수한다. ```text AI -→ Write +→ 작성 Human -→ Review -→ Approve +→ 검토 +→ 승인 ``` --- -## Git Is The Source Of Truth +## Git은 진실의 출처 프로젝트는 Git으로 시작한다. @@ -62,7 +61,7 @@ git init --- -## Models Are Replaceable +## 모델은 교체 가능해야 한다 ```text GPT @@ -78,41 +77,41 @@ Cursor --- -# Documentation Ownership +# 문서 소유권 -## Planning Runtime +## Planning Runtime (계획 런타임) 채팅창 역할 ```text -Document Creation -Document Revision -Architecture Design -Task Planning -Prompt Creation -Project Decisions +문서 생성 +문서 수정 +아키텍처 설계 +태스크 계획 +프롬프트 작성 +프로젝트 결정 ``` --- -## Execution Runtime +## Execution Runtime (실행 런타임) 코딩창 역할 ```text -Implementation -Refactoring -Testing -Bug Fixing +구현 +리팩토링 +테스트 +버그 수정 ``` --- -## Rule +## 규칙 모든 Markdown 문서는 원칙적으로 Planning Runtime에서 생성한다. @@ -133,7 +132,7 @@ ARCHITECTURE.md --- -# Workflow Overview +# 워크플로 개요 ```text git init @@ -169,7 +168,7 @@ README.md --- -# Phase 1. Idea Refinement +# Phase 1. 아이디어 정제 ## 목적 @@ -211,7 +210,7 @@ BEP는 언제 달성 가능한가? --- -## Commit +## 커밋 두 문서는 반드시 같은 Commit으로 생성한다. @@ -221,7 +220,7 @@ git commit -m "docs: initialize product vision" --- -# Phase 2. Architecture Design +# Phase 2. 아키텍처 설계 ## 목적 @@ -239,7 +238,7 @@ IDEAS.md와 PITCHING_SCRIPT.md는 개발 단계의 필수 문서가 아니다. --- -## Architecture Structure +## 아키텍처 구조 ```text ARCHITECTURE.md @@ -265,9 +264,9 @@ ARCHITECTURE.md는 Index 역할을 수행한다. --- -# Phase 3. Product Specification +# Phase 3. 제품 스펙 -## Optional +## 선택적 ARCHITECTURE.md가 충분하지 않을 경우에만 생성한다. @@ -297,7 +296,7 @@ OS Requirements --- -# Phase 4. Constitution +# Phase 4. 헌법 ## 목적 @@ -323,7 +322,7 @@ AI는 항상 AGENTS.md부터 읽는다. 포함 항목 -### Read Order +### 읽기 순서 ```text ARCHITECTURE.md @@ -335,7 +334,7 @@ TASKS.md --- -### Agent Registry +### 에이전트 레지스트리 ```text agents/ @@ -343,7 +342,7 @@ agents/ --- -### Rules +### 규칙 ```text Never create files in repository root @@ -365,7 +364,7 @@ Only architecture-impacting changes may modify architecture documents --- -# Phase 5. Task Planning +# Phase 5. 태스크 계획 ## 목적 @@ -403,15 +402,15 @@ TASKS.md는 현재 위치다. --- -# Development Loop +# 개발 루프 -## Step 1 +## 1단계 TASKS.md에서 작업 선택 --- -## Step 2 +## 2단계 Planning Runtime에서 Prompt 생성 @@ -421,7 +420,7 @@ Planning Runtime에서 Prompt 생성 --- -## Step 3 +## 3단계 Branch 생성 @@ -431,7 +430,7 @@ git checkout -b feature/xxx --- -## Step 4 +## 4단계 Execution Runtime에서 구현 @@ -457,25 +456,25 @@ Test Success --- -## Step 5 +## 5단계 Pull Request 생성 --- -## Step 6 +## 6단계 Human Review --- -## Step 7 +## 7단계 Merge --- -## Step 8 +## 8단계 TASKS.md 업데이트 @@ -485,7 +484,7 @@ TASKS.md 업데이트 --- -## Step 9 +## 9단계 필요 시 ARCHITECTURE.md 업데이트 @@ -495,7 +494,7 @@ TASKS.md 업데이트 --- -# Long Context +# LONG_CONTEXT ## 목적 @@ -577,7 +576,7 @@ Phase 완료 시 --- -# Release +# 배포 배포 수행 @@ -593,7 +592,7 @@ Phase 완료 시 --- -# Persistent Assets +# 지속 자산 프로젝트 기억 diff --git a/src/pages/index.astro b/src/pages/index.astro index 3947d92..14f1111 100644 --- a/src/pages/index.astro +++ b/src/pages/index.astro @@ -4,7 +4,7 @@ import SiteLayout from '../layouts/SiteLayout.astro';

- AI development needs durable memory for projects. Models forget. - Projects must not. + AI Development는 프로젝트를 위한 지속 가능한 기억을 필요로 합니다. + Models forget. Projects must not.

- Why REPL Works + 왜 REPL Works인가 - Read the Manifesto + 선언문 읽기
@@ -45,51 +45,50 @@ import SiteLayout from '../layouts/SiteLayout.astro'; class="rounded-3xl border border-slate-200 bg-white p-8 shadow-sm" >

- A documentation-first approach + 문서 중심의 프로젝트 기억

- REPL Works is a framework for capturing project memory as structured - documentation, enabling teams to read, learn, and navigate AI - development with confidence. + REPL Works는 프로젝트 기억을 구조화된 문서로 포착하여 팀이 AI + Development를 신뢰할 수 있게 관리하도록 돕는 Documentation + Platform입니다.

    -
  • Read definitive guidance in one place.
    • -
  • Navigate through why, manifesto, specification, and workflow.
    • -
  • Learn with a clear, minimal information hierarchy.
    • +
  • 한곳에서 핵심 내용을 읽고 이해합니다.
    • +
  • 왜, 선언문, 스펙, 워크플로를 순서대로 탐색합니다.
    • +
  • 명확하고 최소한의 정보 계층으로 학습합니다.
@@ -99,20 +98,26 @@ import SiteLayout from '../layouts/SiteLayout.astro';

- GitHub + 깃허브

- Repository placeholder + 프로젝트 기억 공개 예정

- The GitHub link will point to the REPL Works project repository once - available. + 이 사이트와 프로젝트 문서는 Git 기반으로 관리되며, 향후 공개 저장소 + 링크를 통해 더 많은 증거를 제시할 예정입니다.

- GitHub link placeholder + + GitHub 링크 +
diff --git a/src/pages/why.astro b/src/pages/why.astro index 4e53980..7c2e357 100644 --- a/src/pages/why.astro +++ b/src/pages/why.astro @@ -4,7 +4,7 @@ import SiteLayout from '../layouts/SiteLayout.astro';
- Problem + 문제

- AI is improving, but projects still fail. + AI는 발전하고 있지만 프로젝트는 여전히 기억을 잃습니다.

- Teams build with better models every year, yet knowledge remains - fragmented across chat history, prompt notes, and scattered docs. The - moment a session ends or a model is replaced, critical context vanishes. + 매년 더 나은 모델이 등장하지만 지식은 채팅 기록, 프롬프트 메모, 산재된 + 문서 사이에 흩어집니다. 세션이 끝나거나 모델이 바뀌면 중요한 맥락이 + 사라집니다.

@@ -34,17 +34,17 @@ import SiteLayout from '../layouts/SiteLayout.astro';

- Observation + 관찰

- Projects leak memory in multiple ways. + 프로젝트는 여러 방식으로 기억을 잃습니다.

    -
  • Chat history grows long and hard to search.
    • -
  • Prompt context is reused without structure.
    • -
  • Context windows reset when agents restart.
    • -
  • Agents run independently and lose shared state.
    • -
  • Personal notes become trapped in silos.
    • +
  • 채팅 기록은 길어지고 검색하기 어려워집니다.
    • +
  • 프롬프트 맥락은 구조 없이 반복해서 재사용됩니다.
    • +
  • 에이전트가 재시작되면 컨텍스트 창이 초기화됩니다.
    • +
  • 에이전트들은 독립적으로 실행되어 공유 상태를 잃습니다.
    • +
  • 개인 메모는 실리오에 갇혀 버립니다.
@@ -54,17 +54,17 @@ import SiteLayout from '../layouts/SiteLayout.astro';

- Consequence + 결과

- The result is project amnesia. + 그 결과 프로젝트가 기억을 잃습니다.

    -
  • Repeated mistakes when context is lost.
    • -
  • Architecture drift because decisions are forgotten.
    • -
  • Lost decisions when reasoning is not captured.
    • -
  • Lost context as sessions end and models change.
    • -
  • Long-term projects lose momentum and memory.
    • +
  • 맥락이 사라지면 같은 실수를 반복합니다.
    • +
  • 결정이 잊히면 설계가 흐트러집니다.
    • +
  • 추론이 기록되지 않으면 중요한 결정이 사라집니다.
    • +
  • 세션이 끝나고 모델이 바뀌면 컨텍스트가 유실됩니다.
    • +
  • 장기 프로젝트는 모멘텀과 기억을 잃습니다.
@@ -75,19 +75,19 @@ import SiteLayout from '../layouts/SiteLayout.astro';

- Question + 질문

- Why does REPL Works exist? + REPL Works는 왜 존재하나요?

- It exists because AI alone cannot preserve project memory. Without a - durable place to record knowledge, every long-term effort becomes - vulnerable to forgotten context, lost decisions, and repeated effort. + AI만으로는 프로젝트 기억을 지킬 수 없습니다. 지식을 기록할 지속 가능한 + 장소가 없으면 장기적인 노력은 맥락을 잃고 결정이 유실되며 반복 작업이 + 발생합니다.

- This is not just a technical inconvenience—it is a real barrier to - sustained, reliable AI development. + 이것은 단순한 기술적 불편함이 아니라 신뢰할 수 있는 AI Development를 + 막는 실제 장벽입니다.

@@ -97,20 +97,20 @@ import SiteLayout from '../layouts/SiteLayout.astro';

- Next + 다음

- The manifesto explains the solution. + 선언문에서 해결 방법을 확인하세요.

- If the problem feels real, the next step is to understand the principles - that make long-term project memory possible. + 이 문제가 현실적이라면, 장기적인 프로젝트 기억을 가능하게 하는 원칙을 + 이해하는 것이 다음 단계입니다.

- Read the Manifesto + 선언문 읽기
From 4804cb26b90f5e567f5b53e3830e58671024d9f2 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Sun, 7 Jun 2026 18:43:51 +0900 Subject: [PATCH 2/2] chore: save some md files but they do not publish --- docs/LONG_CONTEXT.md | 38 +++ docs/MANIFESTO.mdx | 100 +++++++ docs/WORKFLOW_ORIGIN.md | 616 ++++++++++++++++++++++++++++++++++++++++ 3 files changed, 754 insertions(+) create mode 100644 docs/LONG_CONTEXT.md create mode 100644 docs/MANIFESTO.mdx create mode 100644 docs/WORKFLOW_ORIGIN.md diff --git a/docs/LONG_CONTEXT.md b/docs/LONG_CONTEXT.md new file mode 100644 index 0000000..1906407 --- /dev/null +++ b/docs/LONG_CONTEXT.md @@ -0,0 +1,38 @@ +# Generate LONG_CONTEXT.md + +지금까지의 대화 내용을 기반으로 LONG_CONTEXT.md를 생성해줘. + +LONG_CONTEXT.md의 목적은 새로운 Session 또는 새로운 Model이 현재 상황을 빠르게 복구할 수 있도록 하는 것이다. + +이 문서는 프로젝트 문서가 아니다. + +다음 목적을 가진 Session Bootstrap 문서다. + +- 새로운 Session 시작 +- 새로운 Model 사용 +- 장기간 중단 후 프로젝트 재개 +- 채팅 Context 소실 복구 + +작성 원칙: + +1. 대화 내용을 단순 요약하지 말 것 +2. 프로젝트의 현재 상태를 설명할 것 +3. 중요한 의사결정과 그 이유를 기록할 것 +4. 논의 과정에서 얻은 핵심 통찰을 기록할 것 +5. 앞으로 이어서 논의해야 할 사항을 기록할 것 +6. 현재 사용자가 중요하게 생각하는 철학과 원칙을 기록할 것 +7. AGENTS.md, ARCHITECTURE.md, TASKS.md에 이미 존재하는 내용을 장황하게 복사하지 말 것 +8. 새로운 모델이 "왜 이런 구조가 되었는가"를 이해할 수 있도록 작성할 것 +9. 세부 구현보다 의사결정 배경을 우선 기록할 것 + +포함 항목: + +- Current Project +- Current Status +- Key Decisions +- Important Insights +- Open Questions +- Current Direction +- Next Discussion Topics + +출력은 LONG_CONTEXT.md 전체 문서만 작성할 것. diff --git a/docs/MANIFESTO.mdx b/docs/MANIFESTO.mdx new file mode 100644 index 0000000..ca77bdb --- /dev/null +++ b/docs/MANIFESTO.mdx @@ -0,0 +1,100 @@ +--- +title: 'REPL Works Manifesto' +date: 2026-06-06 +--- + +## Introduction + +We are discovering better ways to build products with AI. + +AI models generate better code every year. + +Yet long-term projects continue to fail for familiar reasons. + +Project intent disappears. + +Architecture drifts. + +The same mistakes repeat. + +Context is lost between sessions. + +Changing models often means starting over. + +We do not believe this happens because AI lacks intelligence. + +We believe it happens because projects lack memory. + +--- + +## Core Belief + +AI memory is temporary. + +Project memory must be externalized. + +Models forget. + +Projects must not. + +--- + +## Values + +We value Project Memory over Model Memory. + +We value Architecture over Prompt Engineering. + +We value Persistent Knowledge over Long Conversations. + +We value Workflow Consistency over Agent Intelligence. + +We value Model Independence over Single Model Dependency. + +We value Sustainable Development over Fast Implementation. + +--- + +## Principles + +### Project knowledge must exist outside the model + +Projects must survive model upgrades, vendor changes, and new sessions. + +### Project memory must be persistent + +Knowledge that matters should not disappear when a conversation ends. + +### Architecture defines intent + +Implementation should follow architecture, not replace it. + +### Context is a limited resource + +Important context must be preserved, not repeatedly reconstructed. + +### Models are replaceable + +Project continuity should not depend on a specific model. + +### Long-term development requires long-term memory + +Projects live longer than sessions. + +Memory must live longer than context windows. + +--- + +## Final Statement + +We are not trying to make AI smarter. + +We are trying to make projects more durable. + +The future of AI development is not better memory inside models. + +It is better memory outside them. + +Models forget. + +Projects must not. diff --git a/docs/WORKFLOW_ORIGIN.md b/docs/WORKFLOW_ORIGIN.md new file mode 100644 index 0000000..3184c0f --- /dev/null +++ b/docs/WORKFLOW_ORIGIN.md @@ -0,0 +1,616 @@ +# AI-Native Product Development Workflow + +Version 5.0 + +--- + +# Philosophy + +AI 시대의 핵심 문제는 코드를 생성하는 능력이 아니다. + +핵심 문제는 다음과 같다. + +- 프로젝트 의도 유지 +- 아키텍처 일관성 유지 +- 작업 범위 제어 +- 반복 실수 방지 +- 컨텍스트 관리 +- 모델 교체 가능성 + +--- + +REPL Works는 AI Agent Framework가 아니다. + +REPL Works는 AI가 따라야 하는 **Project Operating System**이다. + +--- + +# Core Principles + +## AI Writes, Human Approves + +모든 문서는 AI가 작성한다. + +모든 코드는 AI가 작성한다. + +Human은 방향을 결정하고 결과를 검수한다. + +```text +AI +→ Write + +Human +→ Review +→ Approve +``` + +--- + +## Git Is The Source Of Truth + +프로젝트는 Git으로 시작한다. + +```bash +git init +``` + +모든 변경사항은 Git으로 관리한다. + +모든 구현은 Branch → PR → Merge를 통해 진행한다. + +--- + +## Models Are Replaceable + +```text +GPT +Claude +Gemini +Codex +Cursor +``` + +모두 교체 가능해야 한다. + +프로젝트의 가치는 모델이 아니라 Git에 저장된 지식에 있다. + +--- + +# Documentation Ownership + +## Planning Runtime + +채팅창 역할 + +```text +Document Creation +Document Revision +Architecture Design +Task Planning +Prompt Creation +Project Decisions +``` + +--- + +## Execution Runtime + +코딩창 역할 + +```text +Implementation +Refactoring +Testing +Bug Fixing +``` + +--- + +## Rule + +모든 Markdown 문서는 원칙적으로 Planning Runtime에서 생성한다. + +모든 Markdown 문서는 원칙적으로 Planning Runtime에서 수정한다. + +--- + +Execution Runtime은 문서의 대규모 수정(Rebuild, Rewrite, Revise)을 수행하지 않는다. + +--- + +예외적으로 다음 문서만 최소 수정 가능하다. + +```text +TASKS.md +ARCHITECTURE.md +``` + +--- + +# Workflow Overview + +```text +git init +↓ +IDEAS.md +↓ +PITCHING_SCRIPT.md +↓ +commit +↓ +ARCHITECTURE.md +↓ +commit +↓ +PRODUCT_SPEC.md (Optional) +↓ +commit +↓ +AGENTS.md +↓ +commit +↓ +TASKS.md +↓ +commit +↓ +Development Loop +↓ +Release +↓ +README.md +``` + +--- + +# Phase 1. Idea Refinement + +## 목적 + +아이디어를 사업적으로 검증한다. + +--- + +AI와 반복적으로 토론한다. + +--- + +## 검토 항목 + +```text +아이디어가 충분히 매력적인가? + +2년 동안 유지 가능한가? + +예상 비용은 감당 가능한가? + +BEP는 언제 달성 가능한가? + +사용자 증가 예측은 합리적인가? +``` + +--- + +## 산출물 + +### IDEAS.md + +프로젝트 의사결정 문서 + +--- + +### PITCHING_SCRIPT.md + +프로젝트 의도 문서 + +--- + +## Commit + +두 문서는 반드시 같은 Commit으로 생성한다. + +```bash +git commit -m "docs: initialize product vision" +``` + +--- + +# Phase 2. Architecture Design + +## 목적 + +프로젝트 전체 구조 정의 + +--- + +실제 개발 단계에서 LLM은 `ARCHITECTURE.md`만 읽어도 프로젝트를 이해할 수 있어야 한다. + +--- + +`IDEAS.md`와 `PITCHING_SCRIPT.md`는 개발 단계의 필수 문서가 아니다. + +--- + +## Architecture Structure + +```text +ARCHITECTURE.md + +architecture/ +├── frontend.md +├── backend.md +├── database.md +└── auth.md +``` + +--- + +`ARCHITECTURE.md`는 Index 역할을 수행한다. + +--- + +세부 설계는 `architecture` 폴더에 위치한다. + +--- + +문서가 충분히 상세하다면 별도 SPEC 문서는 필요하지 않다. + +--- + +# Phase 3. Product Specification + +## Optional + +`ARCHITECTURE.md`가 충분하지 않을 경우에만 생성한다. + +--- + +### 포함 항목 + +```text +Node Version + +Python Version + +Go Version + +Database Version + +Package Manager Version + +OS Requirements +``` + +--- + +## 산출물 + +### PRODUCT_SPEC.md + +--- + +# Phase 4. Constitution + +## 목적 + +프로젝트 규칙 정의 + +--- + +## 산출물 + +### AGENTS.md + +--- + +`AGENTS.md`는 프로젝트 헌법이다. + +동시에 프로젝트 진입점이다. + +--- + +AI는 항상 `AGENTS.md`부터 읽는다. + +--- + +### 포함 항목 + +#### Read Order + +```text +ARCHITECTURE.md + +PRODUCT_SPEC.md + +TASKS.md +``` + +--- + +#### Agent Registry + +```text +agents/ +``` + +--- + +#### Rules + +```text +Never create files in repository root + +Reuse existing components first + +Every feature must include unit tests + +Build must pass + +Lint must pass + +Tests must pass + +All task updates must trigger architecture review + +Only architecture-impacting changes may modify architecture documents +``` + +--- + +# Phase 5. Task Planning + +## 목적 + +현재 개발 상태 정의 + +--- + +## 산출물 + +### TASKS.md + +--- + +`TASKS.md`는 TODO List다. + +--- + +반드시 Phase로 그룹화한다. + +```text +Phase 1 + +- [ ] + +Phase 2 + +- [ ] +``` + +--- + +`ARCHITECTURE.md`는 목적지다. + +`TASKS.md`는 현재 위치다. + +--- + +# Development Loop + +## Step 1 + +`TASKS.md`에서 작업 선택 + +--- + +## Step 2 + +Planning Runtime에서 Prompt 생성 + +--- + +계획 수립과 구현은 분리한다. + +--- + +## Step 3 + +Branch 생성 + +```bash +git checkout -b feature/xxx +``` + +--- + +## Step 4 + +Execution Runtime에서 구현 + +--- + +모든 기능은 반드시 Unit Test를 포함해야 한다. + +--- + +### 필수 조건 + +```text +Build Success + +Lint Success + +Test Success +``` + +--- + +실패 시 수정 후 재실행한다. + +--- + +## Step 5 + +Pull Request 생성 + +--- + +## Step 6 + +Human Review + +--- + +## Step 7 + +Merge + +--- + +## Step 8 + +`TASKS.md` 업데이트 + +```text +- [x] +``` + +--- + +## Step 9 + +필요 시 `ARCHITECTURE.md` 업데이트 + +--- + +구조 변경이 발생한 경우에만 수행한다. + +--- + +# Long Context + +## 목적 + +LLM Session Memory 복구 + +--- + +`LONG_CONTEXT.md`는 프로젝트 문서가 아니다. + +--- + +`LONG_CONTEXT.md`는 세션 복구 문서다. + +--- + +다음 상황에서 사용한다. + +```text +새로운 모델 사용 + +새로운 채팅 시작 + +기존 채팅 Context 소멸 + +장기간 프로젝트 중단 후 재개 +``` + +--- + +## 사용 방법 + +새로운 채팅을 시작한 뒤 첫 메시지로 `LONG_CONTEXT.md`를 전달한다. + +--- + +LLM은 어떤 규칙으로도 `LONG_CONTEXT.md`를 자동 참조하지 않는다. + +--- + +`AGENTS.md`에 등록하지 않는다. + +--- + +## 생성 시점 + +### 소규모 프로젝트 + +```text +TASKS.md 완료 시 +생성 +``` + +--- + +### 대규모 프로젝트 + +```text +Phase 완료 시 +생성 +``` + +--- + +필요한 경우 수동으로 갱신할 수 있다. + +--- + +## 목적 + +대화 내용을 저장하는 것이 아니다. + +--- + +최근 프로젝트 문맥을 압축 보존하는 것이다. + +--- + +# Release + +배포 수행 + +--- + +# README.md + +유일한 Human-Oriented Document + +--- + +프로젝트가 충분히 완성된 이후 생성한다. + +--- + +# Persistent Assets + +## 프로젝트 기억 + +```text +Git + +ARCHITECTURE.md + +AGENTS.md + +TASKS.md +``` + +--- + +## 세션 기억 + +```text +LONG_CONTEXT.md +``` + +--- + +프로젝트 기억은 Git에 저장된다. + +세션 기억은 필요할 때 LLM에 주입된다. + +--- + +어떤 모델이든 프로젝트는 Git으로 복원할 수 있어야 한다. + +어떤 세션이든 `LONG_CONTEXT.md`로 이어갈 수 있어야 한다.