Review Showcase Content #42

TASKS.md

@@ -209,11 +209,12 @@ Propose TASK update
 
 ## CONTENT REVIEW
 
-* [ ] T601 Review Workflow content
-* [ ] T602 Review Prompt content
-* [ ] T603 Review Document content
-* [ ] T604 Review Tool content
-* [ ] T605 Review Showcase content
+* [x] T601 Review Workflow content
+* [x] T602 Review Prompt content
+* [x] T603 Review Document content
+* [x] T604 Review Tool content
+* [x] T605 Review Showcase content
+* [ ] T605 Review FAQ content
 
 ---
 

src/content/showcase/ai-issue.mdx

@@ -0,0 +1,153 @@
+---
+
+title: 'AI 이슈 퍼블리셔(AI Issue Publisher)'
+version: 'v1'
+description: 'AI와의 토론을 바로 실행 가능한 Github Issue로 변환해 주는 REPL Works 호환 도구.'
+publishedAt: '2026-06-12T00:00:00Z'
+-----------------------------------
+
+## Overview
+
+AI 이슈 퍼블리셔(AI Issue Publisher 줄여서 `ai-issue`)는 아이디어, 토론, 작업 요청을 실행 가능한 GitHub Issue로 변환하기 위한 도구다.
+
+REPL Works 워크플로에서 Planning AI와 Execution AI 사이를 연결하는 역할을 수행한다.
+
+---
+
+## Why REPL Works
+
+많은 AI 프로젝트는 구현보다 작업 정의에서 더 많은 시간을 소비한다.
+
+무엇을 만들어야 하는지 명확하지 않으면 AI는 범위를 추측하고, 불필요한 기능을 추가하며, 의도와 다른 결과를 만들 수 있다.
+
+`ai-issue`는 이러한 문제를 줄이기 위해 만들어졌다.
+
+---
+
+## Website / Repository
+
+Website
+
+```text
+No exist
+```
+
+Repository
+
+[https://github.com/replworks/ai-issue](https://github.com/replworks/ai-issue)
+
+---
+
+## Workflow
+
+```text
+Discussion
+↓
+Issue
+↓
+Execution AI
+↓
+PR
+↓
+Review
+↓
+Merge
+```
+
+---
+
+`ai-issue`는 Discussion과 Issue 사이를 담당한다.
+
+---
+
+## Documents Used
+
+`ai-issue`는 일반적으로 다음 문서를 기반으로 작업한다.
+
+```text
+IDEAS.md
+
+PITCHING_SCRIPT.md
+
+PRODUCT_SPEC.md
+
+ARCHITECTURE.md
+
+FRAMEWORK.md
+
+TASKS.md
+
+AGENTS.md
+```
+
+---
+
+Issue는 프로젝트 문서와 일관성을 유지해야 한다.
+
+---
+
+## Lessons Learned
+
+### Good Execution Starts With Good Tasks
+
+좋은 구현은 좋은 작업 정의에서 시작된다.
+
+작업 범위가 명확할수록 AI의 결과도 안정적이다.
+
+---
+
+### Issues Become Reusable Prompts
+
+잘 작성된 Issue는 단순한 작업 요청이 아니다.
+
+Execution AI가 바로 사용할 수 있는 프롬프트 역할을 수행한다.
+
+---
+
+### Planning And Execution Should Be Separate
+
+계획과 구현을 분리하면 품질이 향상된다.
+
+Planning AI는 무엇을 해야 하는지 정의하고,
+
+Execution AI는 정의된 작업을 수행한다.
+
+---
+
+### Structure Reduces Hallucination
+
+명확한 Problem, Goal, Scope, Acceptance Criteria는 AI가 추측해야 할 영역을 줄여준다.
+
+결과적으로 구현 품질이 향상되고 리뷰 비용도 감소한다.
+
+---
+
+## Current Status
+
+운영 중.
+
+REPL Works 프로젝트에서 실제 이슈 생성과 작업 계획에 사용되고 있다.
+
+---
+
+## What This Project Proves
+
+`ai-issue`는 REPL Works가 단순한 문서 체계가 아니라,
+
+아이디어를 실행 가능한 작업으로 변환하는 실용적인 워크플로임을 보여준다.
+
+---
+
+## Key Insight
+
+```text
+Idea
+↓
+Issue
+↓
+Execution AI
+```
+
+좋은 Issue는 작업을 설명하지 않는다.
+
+좋은 Issue는 작업을 실행 가능하게 만든다.

src/content/showcase/claytube.mdx

@@ -1,29 +1,120 @@
 ---
-title: 'ClayTube'
+title: '클래이튜브(ClayTube)'
 version: 'v1'
-description: 'ClayTube는 다중 세션에 걸쳐 연속성을 보존하는 공개 프로젝트 사례입니다.'
+description: 'ClayTube는 장기간에 걸쳐 개발되고 운영되는지 검증하는데 포커스를 둔 ReplWorks 호환 프로젝트다.'
 publishedAt: '2026-06-07T00:00:00Z'
 ---
 
-## 웹사이트 / 저장소
+## Overview
 
-- Website: [https://www.etern.co.kr/claytube](https://www.etern.co.kr/claytube)
-- Repository: private
+ClayTube는 장기간에 걸쳐 개발되고 운영되는 프로젝트다.
 
-## 장기 프로젝트 연속성
+프로젝트의 목표는 기능을 만드는 것뿐만 아니라, 시간이 지나도 프로젝트의 의도와 맥락을 유지할 수 있는 개발 방식을 검증하는 것이다.
 
-- 프로젝트는 Git과 구조화된 문서에 내구성 있는 기억을 유지합니다.
-- 구현 세부 사항이 진화해도 아키텍처와 태스크는 안정적으로 유지됩니다.
-- 이 프로젝트는 몇 달 동안 중단을 견디도록 설계되었습니다.
+---
+
+## Why REPL Works
+
+대부분의 AI 프로젝트는 세션이 종료되면 기억도 함께 사라진다.
+
+ClayTube는 프로젝트 기억(Project Memory)을 문서와 Git에 저장함으로써 이러한 문제를 해결하고자 한다.
+
+프로젝트는 특정 채팅이나 특정 AI 모델에 의존하지 않아야 한다.
+
+---
+
+## Website / Repository
+
+Website
+
+[https://www.etern.co.kr/claytube](https://www.etern.co.kr/claytube)
+
+Repository
+
+```text
+Private
+```
+
+---
+
+## Documents Used
+
+이 프로젝트는 REPL Works 핵심 문서 구조를 사용한다.
+
+```text
+IDEAS.md
+
+PITCHING_SCRIPT.md
+
+PRODUCT_SPEC.md
+
+ARCHITECTURE.md
+
+FRAMEWORK.md
+
+TASKS.md
+
+AGENTS.md
+```
+
+---
+
+프로젝트 기억은 문서와 Git에 저장된다.
+
+세션은 일시적이지만 문서는 지속된다.
+
+---
 
-## AI_MEMORY.md를 통한 세션 복구
+## Lessons Learned
+
+### Long-Term Continuity Requires Durable Memory
+
+프로젝트는 수개월 또는 수년에 걸쳐 유지될 수 있다.
+
+프로젝트 기억이 채팅에만 존재한다면 연속성은 쉽게 사라진다.
+
+문서와 Git은 장기 프로젝트를 위한 더 안정적인 기억 저장소였다.
+
+---
+
+### Session Recovery Should Be Explicit
+
+프로젝트를 다시 시작할 때 가장 어려운 일은 맥락을 복원하는 것이다.
+
+중요한 의도와 결정은 문서에 남아 있어야 하며, 새로운 세션은 그 문서를 기반으로 시작되어야 한다.
+
+---
+
+### Model Changes Should Not Break Projects
+
+AI 모델은 계속 바뀐다.
+
+프로젝트가 특정 모델의 기억에 의존한다면 유지보수는 어려워진다.
+
+프로젝트 기억을 문서에 저장하면 모델이 바뀌어도 동일한 워크플로를 유지할 수 있다.
+
+---
+
+### Git Preserves More Than Code
+
+Git은 단순히 코드를 저장하는 공간이 아니다.
+
+프로젝트의 역사와 의사결정을 함께 보존하는 시스템이다.
+
+시간이 지나도 프로젝트를 이해할 수 있는 이유는 Git에 기록이 남기 때문이다.
+
+---
+
+## Current Status
+
+운영 중.
+
+장기 프로젝트에서 프로젝트 기억과 모델 독립성을 검증하는 사례로 활용되고 있다.
+
+---
 
-- 복구 요약은 `AI_MEMORY.md`에 저장되어 새로운 세션을 부트스트랩합니다.
-- 긴 컨텍스트 형식은 의도, 진행 상황, 다음 행동을 캡처합니다.
-- 이를 통해 새로운 세션은 전체 맥락을 다시 구성하지 않고도 빠르게 재개할 수 있습니다.
+## What This Project Proves
 
-## AI 모델 전환
+ClayTube는 REPL Works가 단기 생산성 향상 도구가 아니라,
 
-- 이 프로젝트는 단일 AI 모델에 의존하지 않습니다.
-- 모델이 바뀌어도 문서화된 프로젝트 기억이 연속성을 제공합니다.
-- 모델 전환은 세션 상태가 아니라 리포지토리와 문서를 통해 관리됩니다.
+장기간 프로젝트의 연속성을 유지하기 위한 프레임워크임을 보여준다.