From 870af25e3e88a7b9084bd257b5290393dd534635 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Fri, 12 Jun 2026 12:50:44 +0900 Subject: [PATCH 1/4] docs: update `IDEAS.md` and `PITCHING_SCRIPT.md` --- docs/IDEAS.md | 362 ++++++++++++++++++++++++++++++++-------- docs/PITCHING_SCRIPT.md | 281 ++++++++++++++++++++++++------- 2 files changed, 505 insertions(+), 138 deletions(-) diff --git a/docs/IDEAS.md b/docs/IDEAS.md index 2e854a8..8667f46 100644 --- a/docs/IDEAS.md +++ b/docs/IDEAS.md @@ -1,6 +1,6 @@ # IDEAS.md -Version 2.0 +Version 4.0 --- @@ -8,13 +8,18 @@ Version 2.0 REPL Works +REPL Works is an AI-Native Product Development Framework +that separates thinking from execution, +keeps project knowledge in living documents, +and maintains project continuity across humans, sessions, and models. + --- # Vision -REPL Works는 AI 시대를 위한 Project Memory System이다. +REPL Works는 AI 시대를 위한 Product Lifecycle System이다. -AI는 점점 더 똑똑해지고 있다. +AI는 점점 더 강력해지고 있다. 더 긴 Context Window. @@ -22,23 +27,29 @@ AI는 점점 더 똑똑해지고 있다. 더 높은 코드 생성 능력. -그러나 장기 프로젝트는 여전히 같은 문제를 겪는다. +더 빠른 구현 속도. + +--- + +그러나 제품 개발은 여전히 같은 문제를 반복한다. + +좋은 아이디어가 실행으로 이어지지 않는다. 프로젝트 의도가 사라진다. -아키텍처가 붕괴한다. +아키텍처가 드리프트한다. -동일한 실수를 반복한다. +문서는 오래될수록 신뢰를 잃는다. -모델을 교체하면 생산성이 초기화된다. +운영 과정에서 발생한 학습이 축적되지 않는다. -세션이 종료되면 중요한 컨텍스트가 사라진다. +모델을 교체하면 생산성이 초기화된다. --- REPL Works는 이 문제의 원인이 AI의 지능 부족이 아니라고 믿는다. -문제는 기억(Memory)이다. +문제는 프로젝트 연속성(Project Continuity)에 있다. --- @@ -46,36 +57,43 @@ REPL Works는 이 문제의 원인이 AI의 지능 부족이 아니라고 믿는 현재 대부분의 AI 개발은 Session 중심으로 이루어진다. +--- + 프로젝트 지식은 다음 위치에 흩어진다. -- Chat History -- Prompt -- Context Window -- Agent Runtime -- 개인 메모 +* Chat History +* Prompt +* Context Window +* Agent Runtime +* 개인 메모 +* 운영 경험 --- 프로젝트는 수개월 또는 수년 동안 존재할 수 있다. -그러나 AI의 기억은 몇 시간 또는 몇 주를 넘기 어렵다. +그러나 AI 세션은 짧다. + +사람도 바뀐다. + +모델도 바뀐다. --- 결과적으로 다음 문제가 발생한다. -- 모델이 바뀌면 기억이 사라진다. -- 장기 프로젝트를 유지하기 어렵다. -- 동일한 실수를 반복한다. -- 아키텍처가 드리프트한다. -- 중요한 의사결정이 소실된다. -- 프로젝트가 Session에 종속된다. +* 프로젝트 의도가 유지되지 않는다. +* 동일한 실수를 반복한다. +* 중요한 의사결정이 소실된다. +* 아키텍처가 드리프트한다. +* 운영 경험이 축적되지 않는다. +* 프로젝트가 특정 사람 또는 특정 세션에 종속된다. --- 우리는 이 문제를 -Project Amnesia +Project Discontinuity 라고 부른다. @@ -83,95 +101,271 @@ Project Amnesia # Core Insight -AI Development has a memory problem. +Projects outlive humans, sessions, and models. --- -AI는 Session Memory를 가진다. +AI는 계속 발전한다. -프로젝트는 Project Memory를 필요로 한다. +사람은 팀을 이동한다. + +모델은 교체된다. + +세션은 종료된다. + +--- + +그러나 프로젝트는 계속 살아남아야 한다. --- -현재 대부분의 AI 개발은 +프로젝트는 특정 사람의 기억에 의존해서는 안 된다. -Project Memory를 Session 안에 저장한다. +프로젝트는 특정 AI 모델에 의존해서도 안 된다. --- -Session이 종료되면 기억도 사라진다. +프로젝트는 스스로를 설명할 수 있어야 한다. --- -REPL Works는 Project Memory와 Session Memory를 구분한다. +# Solution + +REPL Works는 프로젝트의 현재 상태를 유지하기 위한 Living Documents를 제공한다. --- -Project Memory는 Repository에 저장된다. +Idea Phase -Session Memory는 필요할 때 복구된다. +```text +IDEAS.md + +PITCHING_SCRIPT.md +``` --- -프로젝트는 Session보다 오래 살아야 한다. +Specification Phase + +```text +PRODUCT_SPEC.md +``` --- -# Solution +Architecture Phase -프로젝트 기억을 Runtime 밖으로 이동시킨다. +```text +ARCHITECTURE.md + +FRAMEWORK.md +``` --- -Project Memory +Planning Phase ```text -Constitution +TASKS.md +``` -Architecture +--- -Tasks +Execution Phase -Git History +```text +AGENTS.md + +Implementation ``` --- -Session Memory +Review Phase ```text -Long Context +Issue + +Pull Request + +Architecture Revision + +Task Revision ``` --- -REPL Works v1 Reference Implementation +Operation Phase ```text -AGENTS.md +Customer Feedback -ARCHITECTURE.md +Product Improvement -TASKS.md +Specification Update -AI_MEMORY.md +Architecture Update -Git History +Task Update ``` --- -프로젝트는 Project Memory만으로 복원 가능해야 한다. +프로젝트는 출시로 끝나지 않는다. -세션은 Session Memory로 복원 가능해야 한다. +운영 과정에서 학습한 내용은 다시 프로젝트에 반영되어야 한다. + +--- + +# Living Documents + +REPL Works는 문서를 산출물이 아니라 현재 상태의 표현으로 본다. + +--- + +PRODUCT_SPEC.md는 현재 제품을 설명한다. + +ARCHITECTURE.md는 현재 아키텍처를 설명한다. + +TASKS.md는 현재 작업 상태를 설명한다. + +--- + +문서는 버전별로 보관하지 않는다. + +Git이 버전을 관리한다. + +문서는 현재를 설명한다. + +Git은 과거를 보존한다. + +--- + +프로젝트를 이해하기 위해 오래된 문서를 찾을 필요가 없어야 한다. + +--- + +# Development Model + +Thinking LLM + +```text +Ideas + +Product Design + +Architecture + +Planning +``` + +--- + +Execution LLM + +```text +Implementation + +Refactoring + +Testing + +Documentation +``` + +--- + +Thinking과 Execution은 분리된다. + +--- + +Execution은 설계를 검증할 수 있다. + +그러나 설계를 대체하지 않는다. + +--- + +설계 변경이 필요하면 문서를 수정한다. + +문서를 수정한 뒤 구현한다. + +--- + +# Feedback Loop + +REPL Works는 Closed Loop Development를 지향한다. + +--- + +```text +Idea + +↓ + +Specification + +↓ + +Architecture + +↓ + +Tasks + +↓ + +Execution + +↓ + +Review + +↓ + +Operation + +↓ + +Issue + +↓ + +Specification Update + +↓ + +Architecture Update + +↓ + +Tasks Update + +↓ + +Execution +``` + +--- + +모든 개선은 다시 프로젝트 지식으로 환원된다. + +--- + +운영은 개발의 종료가 아니라 다음 개발의 시작이다. --- # Key Principles -## Git First +## Thinking ≠ Execution -모든 프로젝트는 Git으로 시작한다. +설계와 구현은 분리되어야 한다. + +--- + +## Living Documents + +문서는 항상 현재 상태를 표현해야 한다. --- @@ -183,41 +377,41 @@ Git History ## Tasks Drive Development -개발은 현재 작업 범위를 명확하게 정의해야 한다. +개발은 정의된 작업 범위를 따라야 한다. --- -## Model Independence +## Git First -모델은 교체 가능해야 한다. +모든 프로젝트는 Git으로 관리된다. --- -## Planning ≠ Execution +## Closed Feedback Loop -설계와 구현은 분리되어야 한다. +모든 구현 결과와 운영 결과는 다시 설계로 돌아가야 한다. --- -## Project Memory ≠ Session Memory +## Model Independence -프로젝트 기억과 세션 기억은 서로 다른 문제다. +모델은 교체 가능해야 한다. --- -# Target Audience +## Project Continuity -### Solo Founder +프로젝트는 사람, 세션, 모델보다 오래 살아야 한다. --- -### Indie Hacker +# Target Audience ---- +### Solo Founder -### Small Team +### Indie Hacker ---- +### Small Team ### AI-Native Builder @@ -225,7 +419,7 @@ Git History # Long-Term Goal -REPL Works를 AI 시대의 Project Memory Standard로 만든다. +REPL Works를 AI 시대의 Product Lifecycle Standard로 만든다. --- @@ -235,13 +429,19 @@ REPL Works를 AI 시대의 Project Memory Standard로 만든다. Built with REPL Works ``` -가 +가 자연스럽게 사용되는 상태를 목표로 한다. -```text -Conventional Commits -``` +--- + +REPL Works 프로젝트는 + +누가 개발하더라도, + +어떤 AI를 사용하더라도, -처럼 자연스럽게 사용되는 상태를 목표로 한다. +어떤 시점에 참여하더라도, + +프로젝트를 이해하고 이어갈 수 있어야 한다. --- @@ -273,18 +473,32 @@ REPL Works Compatible 프로젝트 등장 # Final Statement -AI는 계속 바뀐다. +AI는 계속 발전한다. + +사람은 바뀐다. + +모델은 교체된다. + +세션은 종료된다. + +--- + +프로젝트는 그보다 오래 살아야 한다. + +--- + +프로젝트는 기억되는 것이 아니라 -프로젝트는 계속 살아남아야 한다. +계속 이해될 수 있어야 한다. --- AI memory is temporary. -Project memory must be externalized. +Project continuity must be preserved. --- Models forget. -Projects must not. +Projects must continue. diff --git a/docs/PITCHING_SCRIPT.md b/docs/PITCHING_SCRIPT.md index 7426def..7becad8 100644 --- a/docs/PITCHING_SCRIPT.md +++ b/docs/PITCHING_SCRIPT.md @@ -1,208 +1,361 @@ # PITCHING_SCRIPT.md -Version 2.0 +Version 3.0 --- # What Is REPL Works? -REPL Works는 AI 개발 워크플로우가 아니다. +REPL Works는 AI 시대를 위한 Product Development Framework이다. -REPL Works는 AI 시대를 위한 Project Memory System이다. +--- + +AI는 점점 더 강력해지고 있다. + +더 긴 Context Window. + +더 강력한 Agent. + +더 높은 코드 생성 능력. + +--- + +그러나 제품 개발은 여전히 어렵다. + +--- + +좋은 아이디어는 사라진다. + +설계 의도는 잊혀진다. + +문서는 오래될수록 신뢰를 잃는다. + +아키텍처는 드리프트한다. + +운영 경험은 축적되지 않는다. --- -# The Problem +AI는 발전하고 있지만 -AI development has a memory problem. +프로젝트는 여전히 연속성을 잃는다. --- -AI는 코드를 작성할 수 있다. +# The Real Problem -Agent는 작업을 수행할 수 있다. +대부분의 사람들은 AI 개발의 문제를 -모델은 점점 더 똑똑해지고 있다. +AI의 능력 부족이라고 생각한다. --- -그러나 장기 프로젝트는 여전히 실패한다. +더 좋은 모델. + +더 긴 Context. + +더 강력한 Agent. --- -왜일까? +그러나 REPL Works는 다르게 생각한다. --- -프로젝트는 수개월 또는 수년 동안 존재한다. +문제는 지능이 아니다. -그러나 AI의 기억은 몇 시간 또는 몇 주를 넘기 어렵다. +문제는 Continuity다. --- -중요한 프로젝트 지식은 다음 위치에 흩어진다. +프로젝트는 사람보다 오래 살아야 한다. -- Chat History -- Prompt -- Context Window -- Agent Runtime +프로젝트는 세션보다 오래 살아야 한다. + +프로젝트는 모델보다 오래 살아야 한다. --- -그리고 언젠가 이 기억들은 사라진다. +# Project Continuity + +프로젝트는 계속 이해될 수 있어야 한다. --- -우리는 이 문제를 +누가 참여하든 -Project Amnesia +어떤 모델을 사용하든 -라고 부른다. +언제 프로젝트에 합류하든 --- -# The Real Problem +프로젝트를 이해하고 -우리는 오랫동안 AI의 지능을 향상시키려고 노력했다. +이어서 개발할 수 있어야 한다. -더 좋은 모델. +--- -더 긴 Context. +그러나 현실은 그렇지 않다. -더 강력한 Agent. +--- + +프로젝트 지식은 다음 위치에 흩어진다. + +* Chat History +* Prompt +* Context Window +* Agent Runtime +* 개인 메모 --- -그러나 문제는 지능이 아니었다. +결국 중요한 의사결정은 사라진다. --- -문제는 기억이었다. +우리는 이 문제를 + +Project Discontinuity + +라고 부른다. --- -# Project Memory vs Session Memory +# The REPL Works Approach -REPL Works는 두 가지 기억을 구분한다. +REPL Works는 프로젝트 지식을 Living Documents로 관리한다. --- -Project Memory +Idea -프로젝트가 유지해야 하는 영속적 기억 +```text +IDEAS.md + +PITCHING_SCRIPT.md +``` --- -Session Memory +Product -현재 세션이 유지하는 임시 기억 +```text +PRODUCT_SPEC.md +``` --- -대부분의 AI 개발은 이 둘을 혼동한다. +Architecture + +```text +ARCHITECTURE.md + +FRAMEWORK.md +``` --- -프로젝트 기억을 Session 안에 저장하면 +Planning -Session이 종료될 때 프로젝트도 함께 기억을 잃는다. +```text +TASKS.md +``` --- -# The REPL Works Approach +Execution -REPL Works는 다른 질문을 한다. +```text +AGENTS.md +``` --- -기억은 왜 Runtime 안에 있어야 하는가? +이 문서들은 프로젝트의 현재 상태를 설명한다. --- -프로젝트 기억은 Repository 안에 존재해야 한다. +문서는 버전별로 관리하지 않는다. + +Git이 버전을 관리한다. + +--- + +문서는 현재를 설명한다. + +Git은 과거를 보존한다. --- -Project Memory +# Thinking ≠ Execution + +REPL Works는 설계와 구현을 분리한다. + +--- + +Thinking LLM ```text -Constitution +Ideas -Architecture +Product Design -Tasks +Architecture -Git History +Planning ``` --- -Session Memory +Execution LLM ```text -Long Context +Implementation + +Testing + +Refactoring + +Documentation ``` --- -REPL Works는 프로젝트 기억을 Repository에 저장한다. +Execution은 Thinking을 대체하지 않는다. + +--- -필요한 경우 Session Memory를 복구한다. +설계가 바뀌면 + +문서를 수정한다. --- -# What Changes? +문서를 수정한 뒤 -모델이 바뀌어도 프로젝트는 유지된다. +구현한다. --- -Session이 종료되어도 프로젝트는 유지된다. +# Development Never Ends + +대부분의 개발 프로세스는 + +출시를 목표로 한다. --- -새로운 AI를 사용해도 프로젝트를 복원할 수 있다. +REPL Works는 운영까지 포함한다. --- -프로젝트는 특정 모델에 종속되지 않는다. +```text +Idea + +↓ + +Specification + +↓ + +Architecture + +↓ + +Tasks + +↓ + +Execution + +↓ + +Release + +↓ + +Operation + +↓ + +Improvement + +↓ + +Specification Update + +↓ + +Architecture Update + +↓ + +Tasks Update +``` + +--- + +운영 결과는 다시 설계로 돌아간다. + +--- + +모든 개선은 프로젝트 지식으로 환원된다. --- # Why It Matters -AI 시대의 핵심 문제는 더 똑똑한 AI를 만드는 것이 아니다. +AI는 계속 발전할 것이다. + +사람은 팀을 이동할 것이다. + +모델은 교체될 것이다. + +세션은 종료될 것이다. --- -더 오래 살아남는 프로젝트를 만드는 것이다. +그러나 프로젝트는 계속 살아남아야 한다. --- -프로젝트는 모델보다 오래 살아야 한다. +프로젝트는 특정 사람에게 종속되어서는 안 된다. + +프로젝트는 특정 모델에 종속되어서도 안 된다. --- -프로젝트는 Session보다 오래 살아야 한다. +프로젝트는 스스로를 설명할 수 있어야 한다. --- # One Sentence -Most AI systems store memory inside the runtime. - -REPL Works stores project memory inside the repository. +REPL Works keeps projects understandable, maintainable, and improvable across humans, sessions, and AI models. --- # Closing +AI will change. + +Models will change. + +Teams will change. + +--- + +Projects must continue. + +--- + AI memory is temporary. -Project memory must be externalized. +Project continuity must be preserved. --- Models forget. -Projects must not. +Projects continue. From 38def3918bb0edc949d309fc2b485511a00d0b10 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Fri, 12 Jun 2026 13:42:49 +0900 Subject: [PATCH 2/4] docs: update `ReplWorks compatible` documents --- ARCHITECTURE.md | 477 +++++++++++++++++++++++------------- FRAMEWORK.md | 302 +++++++++++++++++++++++ PRODUCT_SPEC.md | 623 ++++++++++++++++++++++++++++++++++++++++++++++++ TASKS.md | 153 +++++++++--- 4 files changed, 1347 insertions(+), 208 deletions(-) create mode 100644 FRAMEWORK.md create mode 100644 PRODUCT_SPEC.md diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index 4ffd914..929b214 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -1,6 +1,6 @@ # ARCHITECTURE.md -Version 2.0 +Version 3.0 ## PROJECT @@ -15,9 +15,7 @@ Documentation Platform for REPL Works. Goal: ```text -Establish REPL Works -as a Project Memory Standard -for AI Development +Establish REPL Works as an AI-Native Product Development Framework. ``` --- @@ -32,39 +30,52 @@ Not: ```text SaaS + Dashboard + Community Platform + Social Network + +Developer Portal + AI Tool ``` --- -## USER ACTIONS +## PRIMARY NAVIGATION ```text -Read -Navigate -Learn -Apply +Home + +Workflow + +Prompts + +Documents + +Tools + +Showcase + +FAQ ``` --- -## PRIMARY JOURNEY +## PRIMARY USER JOURNEY ```text Home ↓ -Why -↓ -Manifesto +Workflow ↓ -Specification +Prompts ↓ -Workflow +Documents ↓ -Resources +Tools ↓ Showcase ↓ @@ -73,279 +84,410 @@ GitHub --- -## NAVIGATION +## CONTENT MODEL + +Content First + +Design Second + +--- + +Content Source ```text -Home +MDX +``` -Why +--- + +Collections -Manifesto +```text +workflow -Specification +prompts -Workflow +documents -Resources +tools -Showcase +showcase + +faq ``` --- -### Resources +## PAGE RESPONSIBILITIES + +### Home + +Purpose ```text -Templates +Introduce REPL Works -Example Documents +Explain Core Philosophy -Long Context Examples +Provide Entry Points +``` -Repository Examples +--- -Planning Examples +### Workflow -FAQ +Purpose + +```text +Explain REPL Works Methodology ``` --- -## CONTENT MODEL +Must describe: -Content First +```text +Idea Refinement -Design Second +Product Definition + +Architecture Design + +Task Planning + +AI Execution + +Review + +Release + +Continuous Improvement +``` --- -Content Source +### Prompts + +Purpose ```text -MDX +Provide Reusable Prompts ``` --- -Collections +Content Examples ```text -manifesto +IDEAS Prompt -specification +PITCHING Prompt -workflow +PRODUCT_SPEC Prompt -resources +ARCHITECTURE Prompt -showcase +TASKS Prompt + +Review Prompt ``` --- -## VERSIONING +### Documents -Required +Purpose + +```text +Provide Reusable Document Standards +``` --- -Versioned Content +Content Examples ```text -Manifesto +AGENTS.md -Specification +PRODUCT_SPEC.md -Workflow +ARCHITECTURE.md + +TASKS.md ``` --- -Example +### Tools + +Purpose ```text -src/content/ +Provide REPL Works Tooling +``` -manifesto/ - v1.mdx +--- -specification/ - v1.mdx +Initial Tools -workflow/ - v1.mdx +```text +ai-issue ``` --- -Never delete previous versions. +Future Tools + +```text +ai-prompt +``` --- -## SHOWCASE +### Showcase Purpose ```text -Proof of Adoption +Demonstrate Real Adoption ``` --- -Initial Entries +Definition ```text -REPL Works Website +REPL Works Compatible Projects +``` -Project A +--- -Project B +Initial Entries -Project C +```text +REPL Works Website -Project D +ai-issue + +Wifi Note ``` --- -## GITHUB +Each Showcase Entry Must Include -GitHub is the primary external asset. +```text +Project + +Purpose -Website explains GitHub. +Workflow Usage -Website does not replace GitHub. +Documents Used + +Tools Used +``` --- -## STACK +### FAQ -Required +Purpose ```text -Node.js >= 24 +Answer Common Questions +``` -npm >= 11 +--- -Astro >= 6 +## CONTENT ORGANIZATION -TypeScript >= 5 +```text +src/content/ -Tailwind CSS >= 4 +workflow/ + +prompts/ + +documents/ + +tools/ + +showcase/ + +faq/ ``` --- -Current +All content must be stored as: ```text -Node.js 24.x +MDX +``` -Astro 6.4.4 +--- -TypeScript 5.x +Large content blocks must not be embedded directly inside page components. -Tailwind CSS 4.x -``` +--- + +Content must remain independent from presentation. --- -Package Manager +## ROUTING STRUCTURE ```text -npm +/ + +/workflow + +/prompts + +/documents + +/tools + +/showcase + +/faq ``` --- -Framework +Content detail pages ```text -Astro +/workflow/[slug] + +/prompts/[slug] + +/documents/[slug] + +/tools/[slug] + +/showcase/[slug] + +/faq/[slug] ``` --- -Language +## GITHUB -```text -TypeScript -``` +GitHub is the primary external asset. --- -Content +Website Responsibilities ```text -MDX +Explain + +Teach + +Distribute ``` --- -Content Management +GitHub Responsibilities ```text -Astro Content Collections +Source Code + +Issues + +Pull Requests + +Releases ``` --- -Search +Website must never replace GitHub. -```text -Pagefind -``` +--- + +## SEARCH + +Required --- -Hosting +Search Scope ```text -GitHub Pages +Workflow + +Prompts + +Documents + +Tools + +Showcase + +FAQ ``` --- -CI/CD +Implementation ```text -GitHub Actions +Pagefind ``` --- -Analytics (Optional) +## SHOWCASE POLICY -```text -Plausible +Showcase is reserved for: -Umami +```text +REPL Works Compatible Projects ``` --- -## PROJECT INITIALIZATION +Do Not Include -Required Command +```text +Prompt Repositories -```bash -npm create astro@latest +Document Repositories + +Template Repositories ``` --- -Template +Those belong under: ```text -Minimal +Prompts + +Documents ``` --- -TypeScript +## STACK + +Required ```text -Strict +Node.js >= 24 + +npm >= 11 + +Astro >= 6 + +TypeScript >= 5 + +Tailwind CSS >= 4 ``` --- @@ -358,88 +500,81 @@ npm --- -## REPOSITORY STRUCTURE +Framework ```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 +Astro ``` --- -## IN SCOPE +Content ```text -Documentation Pages +MDX +``` -Versioned Documents +--- -Static Search +Search + +```text +Pagefind +``` -GitHub Links +--- -Showcase Pages +Hosting -Resource Pages +```text +GitHub Pages ``` --- -## OUT OF SCOPE +CI/CD ```text -Database - -Backend API +GitHub Actions +``` -Authentication +--- -User Accounts +## CONSTRAINTS -Comments +All pages must support: -CMS +```text +Static Export +``` -Realtime Features +--- -Payments +Server Dependency -Discussion Board +```text +Not Allowed ``` --- -## CONSTRAINTS +Database -All pages must support: +```text +Not Allowed +``` + +--- + +Authentication ```text -Static Export +Not Allowed ``` --- -Server dependency: +User Accounts ```text Not Allowed @@ -447,7 +582,7 @@ Not Allowed --- -Dynamic user state: +Dynamic User State ```text Not Allowed @@ -458,21 +593,23 @@ Not Allowed ## SUCCESS CRITERIA ```text -Manifesto published +Workflow Published + +Prompts Published -Specification published +Documents Published -Workflow published +Tools Published -Resources published +Showcase Published -Showcase published +FAQ Published -GitHub Pages deployment works +GitHub Pages Deployment Works -New versions can be added +Search Works -Old versions remain accessible +New Content Can Be Added Through MDX ``` --- @@ -486,9 +623,11 @@ Every implementation must support: ```text Documentation -Versioning +Discoverability Static Deployment Long-Term Maintainability + +REPL Works Adoption ``` diff --git a/FRAMEWORK.md b/FRAMEWORK.md new file mode 100644 index 0000000..210a2b1 --- /dev/null +++ b/FRAMEWORK.md @@ -0,0 +1,302 @@ +# ASTRO.md + +## STACK + +REQUIRED + +- Astro 6.x +- JavaScript + +OPTIONAL + +- TailwindCSS 4.x +- React 19.x +- MDX + +USE_DECLARED_STACK_ONLY + +DO_NOT_INTRODUCE_NEW_LIBRARIES_UNLESS_EXPLICITLY_REQUESTED + +--- + +## VERSION_POLICY + +PACKAGE_JSON_IS_SOURCE_OF_TRUTH + +FRAMEWORK_MD_IS_FALLBACK + +USE_DECLARED_VERSIONS_ONLY + +DO_NOT_ASSUME_LIBRARY_VERSIONS + +DO_NOT_ASSUME_ASTRO_VERSION + +DO_NOT_GENERATE_CODE_FOR_OTHER_VERSIONS + +WHEN_VERSION_CONFLICT_EXISTS + +FOLLOW_PACKAGE_JSON + +--- + +## PROJECT_STRUCTURE + +```text +src/ +├── components/ +├── layouts/ +├── pages/ +├── content/ +├── images/ +├── data/ +├── utils/ +└── styles/ + +public/ + +astro.config.mjs +content.config.ts +``` + +THIS_STRUCTURE_IS_AUTHORITATIVE + +DO_NOT_CREATE_NEW_TOP_LEVEL_DIRECTORIES + +PREFER_EXISTING_DIRECTORIES_OVER_NEW_ONES + +FOLLOW_EXISTING_STRUCTURE_BEFORE_CREATING_NEW_STRUCTURE + +--- + +## FILE_PLACEMENT + +pages -> src/pages + +layouts -> src/layouts + +components -> src/components + +content -> src/content + +images -> src/images + +data -> src/data + +utilities -> src/utils + +styles -> src/styles + +static_assets -> public + +content_configuration -> content.config.ts + +astro_configuration -> astro.config.mjs + +DO_NOT_CREATE_COMPONENTS_OUTSIDE_DEFINED_LOCATIONS + +--- + +## ROUTING_RULES + +USE_FILE_BASED_ROUTING + +ROUTES_BELONG_IN_SRC_PAGES + +DO_NOT_CREATE_CUSTOM_ROUTING_SYSTEM + +FOLLOW_ASTRO_ROUTING_CONVENTIONS + +--- + +## COMPONENT_RULES + +USE_ASTRO_COMPONENTS_BY_DEFAULT + +PREFER_ASTRO_OVER_REACT + +USE_REACT_ONLY_WHEN_REQUIRED + +ONE_COMPONENT_PER_FILE + +DO_NOT_EXPORT_MULTIPLE_COMPONENTS_FROM_SAME_FILE + +PREFER_SMALL_COMPOSABLE_COMPONENTS + +--- + +## CONTENT_RULES + +CONTENT_BELONGS_IN_SRC_CONTENT + +USE_CONTENT_COLLECTIONS + +CONTENT_CONFIG_IS_SOURCE_OF_TRUTH + +DO_NOT_STORE_CONTENT_IN_COMPONENTS + +DO_NOT_STORE_LARGE_CONTENT_BLOCKS_IN_PAGES + +SEPARATE_CONTENT_FROM_PRESENTATION + +--- + +## DATA_RULES + +STATIC_DATA_BELONGS_IN_SRC_DATA + +NAVIGATION_DATA_BELONGS_IN_SRC_DATA + +FAQ_DATA_BELONGS_IN_SRC_DATA + +CONFIGURATION_DATA_BELONGS_IN_SRC_DATA + +DO_NOT_STORE_DATA_IN_COMPONENTS + +SEPARATE_DATA_FROM_PRESENTATION + +--- + +## IMAGE_RULES + +PROJECT_IMAGES_BELONG_IN_SRC_IMAGES + +PUBLIC_ASSETS_BELONG_IN_PUBLIC + +USE_ASTRO_IMAGE_OPTIMIZATION_WHEN_AVAILABLE + +DO_NOT_STORE_IMAGES_IN_COMPONENT_DIRECTORIES + +--- + +## STYLING_RULES + +USE_PROJECT_DEFINED_STYLING_SOLUTION + +IF_TAILWIND_IS_INSTALLED + +USE_TAILWINDCSS_ONLY + +DO_NOT_MIX_MULTIPLE_STYLING_APPROACHES + +PREFER_GLOBAL_STYLES_IN_SRC_STYLES + +--- + +## PERFORMANCE_RULES + +PREFER_STATIC_GENERATION + +MINIMIZE_CLIENT_SIDE_JAVASCRIPT + +MINIMIZE_HYDRATION + +LOAD_ONLY_REQUIRED_CLIENT_CODE + +AVOID_UNNECESSARY_REACT_COMPONENTS + +--- + +## ISLAND_RULES + +USE_ISLANDS_ARCHITECTURE + +DEFAULT_TO_SERVER_RENDERED_CONTENT + +HYDRATE_ONLY_WHEN_NECESSARY + +DO_NOT_HYDRATE_STATIC_CONTENT + +USE_CLIENT_DIRECTIVES_ONLY_WHEN_REQUIRED + +--- + +## NAMING_RULES + +COMPONENT_FILES -> PascalCase + +LAYOUT_FILES -> PascalCase + +UTILITY_FILES -> camelCase + +DATA_FILES -> camelCase + +CONTENT_FILES -> kebab-case + +IMAGE_FILES -> kebab-case + +EXAMPLES + +- Header.astro + +- HeroSection.astro + +- PostLayout.astro + +- navigationData.js + +- faqData.js + +- getting-started.md + +- first-blog-post.md + +--- + +## ROOT_DIRECTORY_POLICY + +DO_NOT_CREATE_FILES_IN_REPOSITORY_ROOT + +UNLESS_REQUIRED_BY_ASTRO + +ALLOWED_ROOT_FILES + +- astro.config.mjs +- content.config.ts +- package.json +- README.md +- tsconfig.json + +--- + +## GENERATION_POLICY + +BEFORE_CREATING_ANY_FILE + +1. CHECK_EXISTING_STRUCTURE +2. CHECK_EXISTING_COMPONENTS +3. CHECK_EXISTING_CONTENT +4. CHECK_EXISTING_DATA +5. CHECK_EXISTING_PATTERNS +6. REUSE_BEFORE_CREATING + +PREFER_MODIFICATION_OVER_NEW_FILES + +PREFER_EXISTING_PATTERNS_OVER_NEW_PATTERNS + +DO_NOT_INVENT_NEW_ARCHITECTURE + +DO_NOT_DUPLICATE_EXISTING_FUNCTIONALITY + +WHEN_UNCERTAIN + +FOLLOW_EXISTING_CODEBASE + +PACKAGE_JSON_OVERRIDES_VERSION_ASSUMPTIONS + +DO_NOT_GUESS + +--- + +## ASTRO_PRINCIPLES + +STATIC_FIRST + +CONTENT_FIRST + +SERVER_FIRST + +USE_ISLANDS_ARCHITECTURE + +MINIMIZE_JAVASCRIPT + +HYDRATE_ONLY_WHEN_NECESSARY diff --git a/PRODUCT_SPEC.md b/PRODUCT_SPEC.md new file mode 100644 index 0000000..2e66067 --- /dev/null +++ b/PRODUCT_SPEC.md @@ -0,0 +1,623 @@ +# PRODUCT_SPEC.md + +Version 3.0 + +## PRODUCT + +REPL Works Website + +--- + +## PRODUCT_TYPE + +```text +Documentation Platform +``` + +Purpose: + +```text +Introduce + +Teach + +Distribute + +Standardize + +REPL Works +``` + +--- + +## PRODUCT_MISSION + +Establish REPL Works as an AI-Native Product Development Framework. + +--- + +REPL Works provides: + +```text +Workflow + +Prompts + +Documents + +Tools + +Showcase +``` + +--- + +The website exists to help visitors: + +```text +Understand REPL Works + +Adopt REPL Works + +Apply REPL Works + +Build REPL Works Compatible Products +``` + +--- + +## TARGET_AUDIENCE + +Primary + +```text +Solo Founders + +Indie Hackers + +AI-Native Builders +``` + +--- + +Secondary + +```text +Startups + +Small Teams + +Technical Product Builders +``` + +--- + +## CORE_MESSAGE + +```text +AI can generate code. + +Projects require structure. +``` + +--- + +```text +AI can execute tasks. + +Projects require continuity. +``` + +--- + +```text +Models change. + +Projects survive. +``` + +--- + +## VALUE_PROPOSITION + +REPL Works provides: + +```text +A repeatable workflow + +Reusable prompts + +Reusable documents + +Reusable tools + +Real-world examples +``` + +for AI-native product development. + +--- + +## INFORMATION_ARCHITECTURE + +```text +Home + +Workflow + +Prompts + +Documents + +Tools + +Showcase + +FAQ + +GitHub +``` + +--- + +## PRIMARY_USER_JOURNEY + +```text +Home +↓ +Workflow +↓ +Prompts +↓ +Documents +↓ +Tools +↓ +Showcase +↓ +GitHub +``` + +--- + +## HOME + +Purpose + +```text +Explain REPL Works + +Explain Why It Exists + +Drive Adoption +``` + +--- + +Must answer: + +```text +What is REPL Works? + +Why does it matter? + +How does it work? + +Where do I start? +``` + +--- + +## WORKFLOW + +Purpose + +```text +Explain the REPL Works methodology +``` + +--- + +Must describe: + +```text +Idea Validation + +Product Definition + +Architecture Design + +Task Planning + +AI Execution + +Review + +Release + +Continuous Improvement +``` + +--- + +Must explain: + +```text +Planning AI + +Execution AI + +Human Review +``` + +--- + +## PROMPTS + +Purpose + +```text +Provide reusable prompts +``` + +--- + +Prompt Categories + +```text +Idea Refinement + +Pitch Generation + +Product Specification + +Architecture Generation + +Task Generation + +Execution Validation + +Architecture Review + +Task Review +``` + +--- + +Visitors must be able to: + +```text +Read + +Copy + +Reuse +``` + +prompts directly. + +--- + +## DOCUMENTS + +Purpose + +```text +Provide reusable document standards +``` + +--- + +Required Documents + +```text +AGENTS.md + +PRODUCT_SPEC.md + +ARCHITECTURE.md + +TASKS.md +``` + +--- + +Optional Documents + +```text +IDEAS.md + +PITCHING_SCRIPT.md +``` + +--- + +Each document page must explain: + +```text +Purpose + +Responsibility + +Creation Timing + +Update Rules +``` + +--- + +## TOOLS + +Purpose + +```text +Provide tooling for REPL Works +``` + +--- + +Initial Tools + +```text +ai-issue +``` + +--- + +Future Tools + +```text +ai-prompt + +Additional REPL Works Tooling +``` + +--- + +Each tool page must include: + +```text +Purpose + +Installation + +Usage + +Repository Link +``` + +--- + +## SHOWCASE + +Purpose + +```text +Demonstrate real adoption +``` + +--- + +Showcase entries must be real projects. + +--- + +Initial Entries + +```text +REPL Works Website + +ai-issue + +Wifi Note +``` + +--- + +Each entry should explain: + +```text +Project + +Purpose + +Workflow Usage + +Documents Used + +Tools Used +``` + +--- + +## REPL_WORKS_COMPATIBLE + +Showcase entries may be designated: + +```text +REPL Works Compatible +``` + +--- + +Definition + +```text +Project follows the REPL Works workflow. + +Project uses REPL Works documents. + +Project is maintained using REPL Works principles. +``` + +--- + +Purpose + +```text +Demonstrate adoption + +Create ecosystem visibility + +Encourage standardization +``` + +--- + +## FAQ + +Purpose + +```text +Answer recurring questions +``` + +--- + +Examples + +```text +What is REPL Works? + +Why use AI and documents together? + +Why separate planning from execution? + +Why Git First? + +What makes a project compatible? +``` + +--- + +## GITHUB + +GitHub is the primary external asset. + +--- + +Website explains: + +```text +Workflow + +Prompts + +Documents + +Tools +``` + +--- + +GitHub stores: + +```text +Source Code + +Issues + +Pull Requests + +Releases +``` + +--- + +Website must never replace GitHub. + +--- + +## CONTENT_STRATEGY + +Content First + +Design Second + +--- + +Priority Order + +```text +Workflow + +Prompts + +Documents + +Tools + +Showcase +``` + +--- + +Design exists to improve content discoverability. + +--- + +## SUCCESS_CRITERIA + +Visitors can: + +```text +Understand REPL Works + +Use REPL Works + +Download Documents + +Copy Prompts + +Install Tools + +Explore Compatible Projects +``` + +--- + +## LONG_TERM_VISION + +Create an ecosystem where: + +```text +Workflow + +Prompts + +Documents + +Tools +``` + +become reusable standards for AI-native product development. + +--- + +Desired Outcome + +```text +Built with REPL Works +``` + +becomes a recognizable signal of structured AI-native development. + +--- + +## FINAL + +REPL Works is an AI-Native Product Development Framework. + +The website exists to distribute: + +```text +Workflow + +Prompts + +Documents + +Tools +``` + +and showcase real-world adoption through REPL Works Compatible projects. diff --git a/TASKS.md b/TASKS.md index c449b5e..0884e1f 100644 --- a/TASKS.md +++ b/TASKS.md @@ -1,6 +1,6 @@ # TASKS.md -Version 3.0 +Version 4.0 ## PURPOSE @@ -76,69 +76,144 @@ 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 --- # PHASE 2 -## LAYOUT SYSTEM +## PLATFORM FOUNDATION -- [x] T106 Create Site Shell +* [x] T101 Create Site Shell +* [x] T102 Configure Navigation +* [x] T103 Configure Layout System +* [x] T104 Configure Content Rendering +* [x] T105 Configure Search Infrastructure --- # PHASE 3 -## CORE CONTENT +## INITIAL WEBSITE RELEASE -- [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 +* [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 --- # PHASE 4 -## RESOURCES +## REPL WORKS REPOSITIONING -- [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 +### INFORMATION ARCHITECTURE + +* [ ] T401 Replace legacy navigation with new navigation structure +* [ ] T402 Remove Why section +* [ ] T403 Remove Manifesto section +* [ ] T404 Remove Specification section + +--- + +### HOME + +* [ ] T405 Rewrite Home page for AI-Native Product Development Framework positioning +* [ ] T406 Add workflow-first messaging +* [ ] T407 Add REPL Works Compatible positioning +* [ ] T408 Add GitHub call-to-action + +--- + +### WORKFLOW + +* [ ] T409 Rewrite Workflow documentation +* [ ] T410 Publish current REPL Works workflow +* [ ] T411 Explain Planning AI vs Execution AI +* [ ] T412 Explain continuous improvement workflow + +--- + +### PROMPTS + +* [ ] T413 Create Prompts section +* [ ] T414 Publish IDEAS prompt +* [ ] T415 Publish PITCHING_SCRIPT prompt +* [ ] T416 Publish PRODUCT_SPEC prompt +* [ ] T417 Publish ARCHITECTURE prompt +* [ ] T418 Publish TASKS prompt +* [ ] T419 Publish Review prompts + +--- + +### DOCUMENTS + +* [ ] T420 Create Documents section +* [ ] T421 Publish AGENTS.md standard +* [ ] T422 Publish PRODUCT_SPEC.md standard +* [ ] T423 Publish ARCHITECTURE.md standard +* [ ] T424 Publish TASKS.md standard + +--- + +### TOOLS + +* [ ] T425 Create Tools section +* [ ] T426 Publish ai-issue +* [ ] T427 Add installation guide +* [ ] T428 Add GitHub repository links + +--- + +### SHOWCASE + +* [ ] T429 Convert Showcase to REPL Works Compatible Projects +* [ ] T430 Publish REPL Works Website showcase +* [ ] T431 Publish ai-issue showcase +* [ ] T432 Publish Wifi Note showcase + +--- + +### FAQ + +* [ ] T433 Rewrite FAQ for framework positioning +* [ ] T434 Add compatibility questions +* [ ] T435 Add workflow questions +* [ ] T436 Add planning vs execution questions --- # PHASE 5 -## SHOWCASE +## SEARCH -- [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 +* [ ] 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 --- # PHASE 6 -## SEARCH +## CONTENT REVIEW -- [x] T529 Integrate Pagefind -- [x] T530 Create Search UI +* [ ] T601 Review Workflow content +* [ ] T602 Review Prompt content +* [ ] T603 Review Document content +* [ ] T604 Review Tool content +* [ ] T605 Review Showcase content --- @@ -146,11 +221,11 @@ Propose TASK update ## RELEASE -- [x] T631 Content Review -- [x] T632 Responsive Review -- [x] T633 Accessibility Review -- [x] T634 Deployment Verification -- [x] T635 Release v1 +* [ ] T701 Responsive Review +* [ ] T702 Accessibility Review +* [ ] T703 Search Verification +* [ ] T704 GitHub Pages Verification +* [ ] T705 Release v2 --- From 01d09d58da931f2680237548e26a8819f45864c1 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Fri, 12 Jun 2026 15:03:56 +0900 Subject: [PATCH 3/4] docs: update `AGENTS.md` and `README.md` --- AGENTS.md | 84 +++++++++++++++++++++++++---- README.md | 154 +++++++++++++++++++++++++++++++++++++----------------- 2 files changed, 180 insertions(+), 58 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index d7bfe94..6ca4f45 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -3,8 +3,9 @@ ## DOCUMENT_ORDER 1. AGENTS.md -2. ARCHITECTURE.md -3. TASKS.md +2. PRODUCT_SPEC.md +3. ARCHITECTURE.md +4. TASKS.md Only these documents are authoritative. @@ -26,6 +27,12 @@ Never implement features described only in docs/. ## SOURCE_OF_TRUTH +Product: + +```text +PRODUCT_SPEC.md +``` + Architecture: ```text @@ -38,14 +45,51 @@ Tasks: TASKS.md ``` +--- + If a conflict exists: ```text -ARCHITECTURE.md > TASKS.md > everything else +PRODUCT_SPEC.md +> +ARCHITECTURE.md +> +TASKS.md +> +everything else ``` --- +## DOCUMENT_RESPONSIBILITIES + +PRODUCT_SPEC.md defines: + +- Product +- Users +- User Journey +- UX +- Content +- Business Intent + +--- + +ARCHITECTURE.md defines: + +- System Design +- Technical Structure +- Repository Structure +- Constraints + +--- + +TASKS.md defines: + +- Current Work Scope +- Execution Order + +--- + ## IMPLEMENTATION_RULES Implement only the selected task. @@ -58,7 +102,11 @@ Do not implement: - assumptions - inferred requirements -Implement only requirements explicitly defined in TASKS.md. +Implement only requirements explicitly defined by: + +- PRODUCT_SPEC.md +- ARCHITECTURE.md +- TASKS.md --- @@ -66,16 +114,29 @@ Implement only requirements explicitly defined in TASKS.md. For every task: -1. Read ARCHITECTURE.md -2. Read task definition -3. Implement -4. Test -5. Stop +1. Read PRODUCT_SPEC.md +2. Read ARCHITECTURE.md +3. Read task definition +4. Implement +5. Test +6. Stop Do not start another task automatically. --- +## PRODUCT_CHANGES + +If implementation conflicts with PRODUCT_SPEC.md: + +STOP + +Propose PRODUCT_SPEC.md update. + +Do not silently change product behavior. + +--- + ## ARCHITECTURE_CHANGES If implementation requires architecture changes: @@ -123,8 +184,9 @@ Prefer modifying existing files. Task is complete only when: -- requirements satisfied -- acceptance criteria satisfied +- product requirements satisfied +- architecture requirements satisfied +- task requirements satisfied - code runs - tests pass diff --git a/README.md b/README.md index d0fc0cd..97e0ce5 100644 --- a/README.md +++ b/README.md @@ -4,29 +4,75 @@ Official website for REPL Works. --- -## Overview +## About -This repository contains the official REPL Works website. +REPL Works is an AI-Native Product Development Framework. + +The framework provides: + +```text +Workflow + +Prompts -REPL Works is a Project Memory System for AI Development. +Documents + +Tools +``` + +for building and maintaining AI-native products. + +This repository contains the official REPL Works website. --- -## Project Documentation +## AI AGENT NOTICE + +This repository uses document-driven development. -Project state is defined by: +Authoritative project state is defined only by: ```text AGENTS.md +PRODUCT_SPEC.md + ARCHITECTURE.md TASKS.md ``` -README.md is a human-oriented operational document. +--- + +AI agents must start from: + +```text +AGENTS.md +``` + +and follow the declared document order. -README.md is not an authoritative source for project state. +--- + +README.md is: + +```text +Human Documentation +``` + +README.md is NOT: + +```text +Project Specification + +Architecture Definition + +Task Definition + +Source of Truth +``` + +Do not use README.md to determine project requirements. --- @@ -74,25 +120,23 @@ npm run dev --- -## 🧞 Commands +## Commands -All commands are run from the root of the project, from a terminal: - -| Command | Action | -| :------------------------ | :----------------------------------------------- | -| `npm install` | Installs dependencies | -| `npm run dev` | Starts local dev server at `localhost:4321` | -| `npm run build` | Build your production site to `./dist/` | -| `npm run preview` | Preview your build locally, before deploying | -| `npm run astro ...` | Run CLI commands like `astro add`, `astro check` | -| `npm run astro -- --help` | Get help using the Astro CLI | +| Command | Purpose | +| --------------------- | ------------------------ | +| `npm install` | Install dependencies | +| `npm run dev` | Start development server | +| `npm run build` | Create production build | +| `npm run preview` | Preview production build | +| `npm run lint` | Run linting | +| `npm run astro check` | Run type checks | +| `npm run test` | Run tests | +| `npm run test:e2e` | Run end-to-end tests | --- ## Build -Generate static site. - ```bash npm run build ``` @@ -101,66 +145,82 @@ npm run build ## Preview -Preview production build locally. - ```bash npm run preview ``` --- -## Quality Checks +## Deployment -Lint +Deployment Target -```bash -npm run lint +```text +GitHub Pages ``` -Type Check +Deployment is fully automated through GitHub Actions. -```bash -npm run astro check -``` +--- -Unit Tests +## Repository Purpose -```bash -npm run test -``` +The website exists to: -End-to-End Tests +```text +Explain REPL Works -```bash -npm run test:e2e +Publish Workflow + +Publish Prompts + +Publish Documents + +Publish Tools + +Showcase REPL Works Compatible Projects ``` --- -## Deployment - -Deployment Target +## Website Structure ```text -GitHub Pages -``` +Home + +Workflow + +Prompts + +Documents -Deployment is automated through GitHub Actions. +Tools + +Showcase + +FAQ +``` --- ## REPL Works -Manifesto +```text +AI-Native Product Development Framework +``` + +--- + +Core Principle ```text -Models forget. +Models change. -Projects must not. +Projects survive. ``` --- ## License -TBD +MIT From 8f5d4ba95cf23401c54e784a92173602d3a4acc2 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Fri, 12 Jun 2026 16:04:33 +0900 Subject: [PATCH 4/4] feat: apply `auto-assign.yml` for `ai-issue` --- .github/workflows/auto-assign.yml | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 .github/workflows/auto-assign.yml diff --git a/.github/workflows/auto-assign.yml b/.github/workflows/auto-assign.yml new file mode 100644 index 0000000..c24974d --- /dev/null +++ b/.github/workflows/auto-assign.yml @@ -0,0 +1,19 @@ +name: Auto Assign +on: + issues: + types: [opened] + pull_request: + types: [opened] +jobs: + run: + runs-on: ubuntu-latest + permissions: + issues: write + pull-requests: write + steps: + - name: "Auto-assign issue" + uses: pozil/auto-assign-issue@v4 + with: + repo-token: ${{ secrets.GITHUB_TOKEN }} + assignees: cable8mm + numOfAssignee: 1