From a87ff68c72f562bd7a5eef0139b9c77439dcd7e5 Mon Sep 17 00:00:00 2001
From: Samgu Lee <cable8mm@gmail.com>
Date: Fri, 12 Jun 2026 21:25:15 +0900
Subject: [PATCH] docs: review `prompt` content

---
 src/content/prompts/architecture-design.mdx   | 103 +++++++-
 src/content/prompts/execution-validation.mdx  | 103 +++++++-
 src/content/prompts/idea-refinement.mdx       |  77 +++++-
 src/content/prompts/index.mdx                 | 249 +++++++++++++++++-
 src/content/prompts/pitch-creation.mdx        |  72 ++++-
 src/content/prompts/product-specification.mdx | 103 +++++++-
 6 files changed, 639 insertions(+), 68 deletions(-)

diff --git a/src/content/prompts/architecture-design.mdx b/src/content/prompts/architecture-design.mdx
index f7c6ebc..d3fa38a 100644
--- a/src/content/prompts/architecture-design.mdx
+++ b/src/content/prompts/architecture-design.mdx
@@ -1,19 +1,100 @@
 ---
-title: 'Architecture Design'
+title: '아키텍처 설계'
 version: 'v1'
-description: 'Prompt starter for defining the technical structure from a product specification.'
+description: 'ARCHITECTURE.md 작성을 위한 기술 구조 설계 프롬프트'
 publishedAt: '2026-06-12T00:00:00Z'
 ---
 
-```prompt
-Design the architecture for this product.
+# 목적
 
-Focus on:
-- repository structure
-- content model
-- routing
-- constraints
-- implementation boundaries
+제품 요구사항을 구현 가능한 기술 구조로 변환한다.
 
-Return architecture that supports static, content-first delivery.
+이 단계의 목적은 기능을 정의하는 것이 아니다.
+
+기능을 구현할 수 있는 구조를 정의하는 것이다.
+
+---
+
+# 산출물
+
+```text
+ARCHITECTURE.md
+```
+
+---
+
+# 사용 방법
+
+PRODUCT_SPEC.md가 완료된 이후 사용한다.
+
+AI는 제품 요구사항을 만족할 수 있는 기술 구조를 설계해야 한다.
+
+기술 선택은 제품 요구사항을 지원하기 위한 수단이어야 한다.
+
+---
+
+# 프롬프트
+
+``````prompt
+Generate ARCHITECTURE.md.
+
+Assume PRODUCT_SPEC.md already exists and is correct.
+
+The purpose of ARCHITECTURE.md is to define:
+
+```text
+How the product works internally.
+How responsibilities are separated.
+How information flows through the system.
+Which invariants must always remain true.
 ```
+
+Do not describe implementation technologies.
+
+Do not describe frameworks.
+
+Do not describe programming languages.
+
+Do not describe libraries.
+
+Do not describe deployment.
+
+Do not describe coding conventions.
+
+Architecture must remain technology-agnostic.
+
+The document must include:
+
+- Purpose
+- Core Concepts
+- System Flow
+- Components
+- Component Responsibilities
+- Responsibility Boundaries
+- Data Flow
+- Architectural Rules
+- Failure Boundaries
+- Non-Goals
+- Architectural Invariants
+
+Every component must have:
+
+- Responsibilities
+- Inputs
+- Outputs
+- Explicit ownership boundaries
+
+Identify:
+
+- missing responsibilities
+- conflicting responsibilities
+- ambiguous flows
+
+Resolve them before generating the document.
+
+Prefer clear ownership over abstraction.
+
+Optimize for implementation certainty.
+
+The document is intended for AI implementation, not human documentation.
+``````
diff --git a/src/content/prompts/execution-validation.mdx b/src/content/prompts/execution-validation.mdx
index 4bee032..d9340e6 100644
--- a/src/content/prompts/execution-validation.mdx
+++ b/src/content/prompts/execution-validation.mdx
@@ -1,19 +1,100 @@
 ---
-title: 'Execution Validation'
+title: '실행 검증'
 version: 'v1'
-description: 'Prompt starter for validating implementation against the approved plan.'
+description: '구현 결과가 승인된 계획과 일치하는지 검증하기 위한 프롬프트'
 publishedAt: '2026-06-12T00:00:00Z'
 ---
 
-```prompt
-Validate the implementation against TASKS.md, ARCHITECTURE.md, and PRODUCT_SPEC.md.
+# 목적
 
-Check:
-- required files
-- content accuracy
-- navigation
-- build correctness
-- architecture alignment
+구현 결과가 프로젝트 문서와 일치하는지 검증한다.
 
-Report only mismatches, risks, and missing coverage.
+이 단계의 목적은 새로운 기능을 제안하는 것이 아니다.
+
+승인된 범위 내에서 정확하게 구현되었는지 확인하는 것이다.
+
+---
+
+# 산출물
+
+```text
+Validation Report
+```
+
+---
+
+# 사용 방법
+
+구현이 완료된 이후 사용한다.
+
+AI는 구현 결과를 PRODUCT_SPEC.md, ARCHITECTURE.md, TASKS.md와 비교하여 검토해야 한다.
+
+새로운 요구사항을 추가하지 않는다.
+
+범위를 확장하지 않는다.
+
+이미 승인된 계획과의 일치 여부만 평가한다.
+
+---
+
+# 프롬프트
+
+``````prompt
+Review the following documents together:
+
+- PRODUCT_SPEC.md
+- ARCHITECTURE.md
+- FRAMEWORK.md
+
+Assume you are responsible for implementing the entire product.
+
+Assume no additional information will be provided.
+
+Your goal is to determine whether implementation can begin with confidence.
+
+Generate only questions.
+
+Do not answer questions.
+
+Do not suggest improvements.
+
+Do not suggest new features.
+
+Do not redesign the product.
+
+Do not modify requirements.
+
+Focus on identifying:
+
+- missing requirements
+- missing architectural responsibilities
+- missing implementation constraints
+- ambiguous behavior
+- conflicting definitions
+- undefined ownership
+- undefined flows
+- undefined inputs
+- undefined outputs
+- contradictions between documents
+
+Treat the three documents as a single implementation contract.
+
+A question is valid only if it blocks implementation certainty.
+
+Ignore:
+
+- personal preferences
+- alternative technologies
+- feature ideas
+- product strategy
+
+Output only a numbered list of questions.
+
+If no blocking questions exist, output:
+
+```text
+Implementation can begin with high confidence.
 ```
+
+Optimize for implementation certainty.
+``````
diff --git a/src/content/prompts/idea-refinement.mdx b/src/content/prompts/idea-refinement.mdx
index 10a3f4a..61b6e48 100644
--- a/src/content/prompts/idea-refinement.mdx
+++ b/src/content/prompts/idea-refinement.mdx
@@ -1,21 +1,70 @@
 ---
-title: 'Idea Refinement'
+title: '아이디어 정제'
 version: 'v1'
-description: 'Prompt starter for refining raw ideas into actionable project direction.'
+description: 'IDEAS.md 작성을 위한 아이디어 검증 및 정제 프롬프트'
 publishedAt: '2026-06-12T00:00:00Z'
 ---
 
+## 목적
+
+아이디어를 실행 가능한 제품 방향으로 정제한다.
+
+이 단계의 목적은 솔루션을 설계하는 것이 아니다.
+
+이 아이디어가 실제로 추진할 가치가 있는지 검증하는 것이다.
+
+---
+
+## 산출물
+
+```text
+IDEAS.md
+```
+
+---
+
+## 사용 방법
+
+초기 아이디어를 설명한다.
+
+AI는 아이디어를 비판적으로 검토하고, 가정과 위험 요소를 찾아내며, 사업적 가능성을 검증해야 한다.
+
+AI는 결론을 내리기 전에 질문부터 해야 한다.
+
+---
+
+## 프롬프트
+
 ```prompt
-You are a critical co-founder helping refine a raw project idea.
-
-Focus on:
-- problem clarity
-- target user
-- existing alternatives
-- differentiation
-- constraints
-- long-term viability
-
-Do not write a specification yet.
-Ask the most important questions first.
+# Ideas Prompt
+
+Generate IDEAS.md from this conversation.
+
+This document is intended for human consumption.
+
+Record only information explicitly discussed during the conversation.
+
+Do not expand the idea.
+
+Do not invent features.
+
+Do not invent business models.
+
+Do not invent technical solutions.
+
+Do not invent implementation details.
+
+Do not add assumptions.
+
+Do not add recommendations.
+
+Do not add future possibilities unless explicitly discussed.
+
+Preserve the original intent.
+
+Focus on capturing the idea exactly as discussed.
+
+If information was not mentioned in the conversation, omit it.
+
+Optimize for accurate idea preservation rather than idea improvement.
 ```
diff --git a/src/content/prompts/index.mdx b/src/content/prompts/index.mdx
index 1501e3a..d47311c 100644
--- a/src/content/prompts/index.mdx
+++ b/src/content/prompts/index.mdx
@@ -1,23 +1,248 @@
 ---
 title: 'Prompts'
 version: 'v1'
-description: 'Reusable Prompt Library for REPL Works.'
+description: 'Reusable prompt library for REPL Works.'
 publishedAt: '2026-06-12T00:00:00Z'
 ---
 
-## Purpose
+REPL Works는 Prompt Engineering Framework가 아니다.
 
-Reusable prompt library for AI-native product development.
+하지만 Prompt는 REPL Works의 중요한 구성 요소이다.
 
-## Prompt Library
+---
+
+문서는 프로젝트 기억(Project Memory)을 정의한다.
+
+Prompt는 그 기억을 활용하는 방법을 정의한다.
+
+---
+
+좋은 문서는 프로젝트를 이해하게 만든다.
+
+좋은 Prompt는 일관된 결과를 만든다.
+
+---
+
+# 왜 Prompt가 필요한가
+
+대부분의 AI 사용자는 같은 설명을 반복한다.
+
+```text
+무엇을 만들고 있는가?
+
+왜 만드는가?
+
+어떤 형식으로 답변해야 하는가?
+
+어떤 문서를 생성해야 하는가?
+```
+
+---
+
+REPL Works는 이러한 반복을 줄이기 위해 Prompt를 표준화한다.
+
+---
+
+Prompt는 프로젝트마다 새로 작성하는 것이 아니다.
+
+검증된 Prompt를 재사용하고 지속적으로 개선한다.
+
+---
+
+# Prompt Library
+
+현재 REPL Works는 다음과 같은 Prompt를 제공한다.
+
+---
+
+## Idea Refinement
+
+아이디어를 검증하고 정제한다.
+
+---
+
+생성 문서
+
+```text
+IDEAS.md
+```
+
+[Prompt 보기](/prompts/idea-refinement)
+
+---
+
+## Pitch Creation
+
+아이디어를 짧고 명확하게 설명한다.
+
+---
+
+생성 문서
+
+```text
+PITCHING_SCRIPT.md
+```
+
+[Prompt 보기](/prompts/pitch-creation)
+
+---
+
+## Product Specification
+
+제품 요구사항을 정의한다.
+
+---
+
+생성 문서
+
+```text
+PRODUCT_SPEC.md
+```
+
+[Prompt 보기](/prompts/product-specification)
+
+---
+
+## Architecture Design
+
+기술 구조를 정의한다.
+
+---
+
+생성 문서
+
+```text
+ARCHITECTURE.md
+```
+
+[Prompt 보기](/prompts/architecture-design)
+
+---
+
+## Task Generation
+
+현재 작업 계획을 생성한다.
+
+---
+
+생성 문서
+
+```text
+TASKS.md
+```
+
+[Prompt 보기](/prompts/task-generation)
+
+---
+
+## Execution Validation
+
+Execution AI가 개발 가능한 상태인지 검증한다.
+
+---
+
+검증 대상
+
+```text
+PRODUCT_SPEC.md
+
+ARCHITECTURE.md
+
+TASKS.md
+```
+
+[Prompt 보기](/prompts/execution-validation)
+
+---
 
-- [Idea Refinement](/prompts/idea-refinement)
-- [Pitch Creation](/prompts/pitch-creation)
-- [Product Specification](/prompts/product-specification)
-- [Architecture Design](/prompts/architecture-design)
-- [Task Generation](/prompts/task-generation)
-- [Execution Validation](/prompts/execution-validation)
+# Prompt Lifecycle
+
+REPL Works Prompt는 고정된 문서가 아니다.
+
+---
+
+실제 프로젝트를 통해 지속적으로 개선된다.
+
+---
+
+일반적인 흐름
+
+```text
+Project Usage
+↓
+Prompt Improvement
+↓
+Better Documents
+↓
+Better Execution
+↓
+Project Usage
+```
+
+---
+
+Prompt는 프로젝트 경험을 압축한 결과물이다.
+
+---
+
+# Prompt Repository
+
+Prompt는 Git으로 관리된다.
+
+---
+
+Prompt 변경은 버전 관리된다.
+
+Prompt 품질은 실제 프로젝트를 통해 검증된다.
+
+---
+
+REPL Works는 Prompt를 개인 자산이 아닌 공유 가능한 자산으로 본다.
+
+---
+
+# Future Direction
+
+현재 Prompt는 문서 형태로 제공된다.
+
+---
+
+장기적으로는 Prompt를 도구화하여 재사용성을 높이는 것을 목표로 한다.
+
+예시
+
+```text
+ai-prompt
+```
+
+---
+
+# 핵심 원칙
+
+## Reusable
+
+Prompt는 반복 사용을 전제로 한다.
+
+---
+
+## Versioned
+
+Prompt는 Git으로 관리된다.
+
+---
+
+## Project-Proven
+
+Prompt는 실제 프로젝트에서 검증된다.
+
+---
+
+## Continuously Improved
+
+Prompt는 프로젝트 경험과 함께 진화한다.
+
+---
 
-## How to Use
+좋은 Prompt는 더 많은 설명을 요구하지 않는다.
 
-Each prompt is designed to be copied, edited, and reused across projects.
+좋은 Prompt는 더 좋은 프로젝트를 만든다.
diff --git a/src/content/prompts/pitch-creation.mdx b/src/content/prompts/pitch-creation.mdx
index 45668bb..96df496 100644
--- a/src/content/prompts/pitch-creation.mdx
+++ b/src/content/prompts/pitch-creation.mdx
@@ -1,18 +1,72 @@
 ---
-title: 'Pitch Creation'
+title: '피치 작성'
 version: 'v1'
-description: 'Prompt starter for turning a validated idea into a clear pitch.'
+description: 'PITCHING_SCRIPT.md 작성을 위한 프로젝트 피치 생성 프롬프트'
 publishedAt: '2026-06-12T00:00:00Z'
 ---
 
+## 목적
+
+검증된 아이디어를 명확하고 설득력 있는 프로젝트 설명으로 정리한다.
+
+이 단계의 목적은 제품 요구사항을 정의하는 것이 아니다.
+
+프로젝트의 존재 이유를 설명하는 것이다.
+
+---
+
+## 산출물
+
+```text
+PITCHING_SCRIPT.md
+```
+
+---
+
+## 사용 방법
+
+IDEAS.md가 정리된 이후 사용한다.
+
+AI는 프로젝트를 처음 접하는 사람도 이해할 수 있도록 프로젝트의 핵심 메시지를 정리해야 한다.
+
+---
+
+## 프롬프트
+
 ```prompt
-Turn the refined idea into a concise pitch.
+Generate PITCHING_SCRIPT.md from:
+
+- IDEAS.md
+- this conversation
+
+Target Audience:
+
+<VC | Investor | Government Program | Co-Founder | Business Partner | Customer | Other>
+
+This document is intended for human consumption.
+
+The goal is persuasion.
+
+Use information explicitly discussed during the conversation.
+
+You may expand:
+
+- market opportunity
+- target users
+- business potential
+- revenue potential
+- competitive advantages
+- growth opportunities
+
+Only when they are supported by the conversation context.
+
+Do not invent unrealistic claims.
+
+Do not invent unsupported numbers.
+
+Clearly distinguish assumptions from established facts.
 
-Explain:
-- what the product is
-- who it is for
-- why it matters
-- what makes it different
+Optimize for credibility, persuasion, and audience relevance.
 
-Keep the output short, direct, and reusable.
+Adapt the structure and messaging for the target audience.
 ```
diff --git a/src/content/prompts/product-specification.mdx b/src/content/prompts/product-specification.mdx
index 1afddde..0237b77 100644
--- a/src/content/prompts/product-specification.mdx
+++ b/src/content/prompts/product-specification.mdx
@@ -1,19 +1,100 @@
 ---
-title: 'Product Specification'
+title: '제품 명세 작성'
 version: 'v1'
-description: 'Prompt starter for writing a product specification from a pitch.'
+description: 'PRODUCT_SPEC.md 작성을 위한 제품 명세 생성 프롬프트'
 publishedAt: '2026-06-12T00:00:00Z'
 ---
 
-```prompt
-Convert the pitch into PRODUCT_SPEC.md content.
+## 목적
 
-Include:
-- product definition
-- user journey
-- core message
-- information architecture
-- page responsibilities
+프로젝트의 제품 요구사항을 정의한다.
 
-Stay aligned with the existing framework.
+이 단계의 목적은 기술 구조를 설계하는 것이 아니다.
+
+무엇을 만들어야 하는지 명확하게 정의하는 것이다.
+
+---
+
+## 산출물
+
+```text
+PRODUCT_SPEC.md
+```
+
+---
+
+## 사용 방법
+
+PITCHING_SCRIPT.md가 완성된 이후 사용한다.
+
+AI는 프로젝트의 목적을 기반으로 제품 관점에서 요구사항을 정리해야 한다.
+
+구현 방법보다는 사용자 경험과 제품 구조를 우선한다.
+
+---
+
+## 프롬프트
+
+``````prompt
+Generate PRODUCT_SPEC.md.
+
+Assume all product discovery and idea validation are already complete.
+
+The purpose of PRODUCT_SPEC.md is to define:
+
+```text
+What the product is.
+What the product does.
+What the user can do.
+What success means.
 ```
+
+Do not describe implementation.
+
+Do not describe architecture.
+
+Do not describe technologies.
+
+Do not describe frameworks.
+
+Do not describe programming languages.
+
+Do not describe databases.
+
+Do not describe APIs.
+
+Do not describe internal components.
+
+Do not describe directory structures.
+
+Focus only on externally observable product behavior.
+
+The document should be sufficient for a product manager to approve the product scope.
+
+The document must include:
+
+- Purpose
+- Problem
+- Product Goals
+- Users
+- Inputs
+- Outputs
+- Functional Requirements
+- User Flows
+- Error Conditions
+- Non-Goals
+- Acceptance Criteria
+- Success Criteria
+
+Do not propose improvements.
+
+Do not add features that were not discussed.
+
+Do not expand the scope.
+
+Prefer explicit requirements over explanations.
+
+Optimize for implementation certainty.
+
+The document is intended for AI implementation, not human marketing.
+``````