From 3b37caf03b126200486a411d2ce46f8513356ad5 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Fri, 2 Oct 2026 00:19:42 +0900 Subject: [PATCH 1/7] docs: update fallback reference in TECH_STACK.md --- .replworks/TECH_STACK.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.replworks/TECH_STACK.md b/.replworks/TECH_STACK.md index a8a7cc1..724e6af 100644 --- a/.replworks/TECH_STACK.md +++ b/.replworks/TECH_STACK.md @@ -23,7 +23,7 @@ DO_NOT_INTRODUCE_NEW_LIBRARIES_UNLESS_EXPLICITLY_REQUESTED PACKAGE_JSON_IS_SOURCE_OF_TRUTH -FRAMEWORK_MD_IS_FALLBACK +TECH_STACK_MD_IS_FALLBACK USE_DECLARED_VERSIONS_ONLY From a22361c53e2fd2aca939e861c834da191cb1fa19 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Fri, 2 Oct 2026 00:27:36 +0900 Subject: [PATCH 2/7] docs: update PRODUCT_SPEC.md to clarify document creation order and human-created documents --- .replworks/PRODUCT_SPEC.md | 32 +++++++++++++++++++++++++++++--- 1 file changed, 29 insertions(+), 3 deletions(-) diff --git a/.replworks/PRODUCT_SPEC.md b/.replworks/PRODUCT_SPEC.md index c23fa22..32d22bb 100644 --- a/.replworks/PRODUCT_SPEC.md +++ b/.replworks/PRODUCT_SPEC.md @@ -315,6 +315,8 @@ AGENTS.md PRODUCT_SPEC.md +TECH_STACK.md + ARCHITECTURE.md TASKS.md @@ -322,14 +324,38 @@ TASKS.md --- -Optional Documents +Human-Created Documents ```text -IDEAS.md +docs/IDEAS.md -PITCHING_SCRIPT.md +docs/PITCHING_SCRIPT.md ``` +`IDEAS.md` and `PITCHING_SCRIPT.md` are created by humans and stored under +`docs/`. They are not authoritative AI documents and must not be used by AI +agents as requirements. + +--- + +## DOCUMENT_CREATION_ORDER + +```text +Human: docs/IDEAS.md + ↓ +Human: docs/PITCHING_SCRIPT.md + ↓ +AI: .replworks/PRODUCT_SPEC.md + ↓ +AI: .replworks/TECH_STACK.md + ↓ +AI: .replworks/ARCHITECTURE.md + ↓ +AI: .replworks/TASKS.md +``` + +The AI document sequence begins with `PRODUCT_SPEC.md`. The human-created documents under `docs/` provide the preceding product context but are outside the AI document loading order. + --- Each document page must explain: From 3c29a2d4df89c24fa30a391dc3c2786a3823e05a Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Fri, 2 Oct 2026 00:42:36 +0900 Subject: [PATCH 3/7] docs: update TECH_STACK.md and package.json to reflect TypeScript and Node.js versions --- .replworks/TECH_STACK.md | 19 +++++++++++++++++-- package-lock.json | 2 +- package.json | 2 +- 3 files changed, 19 insertions(+), 4 deletions(-) diff --git a/.replworks/TECH_STACK.md b/.replworks/TECH_STACK.md index 724e6af..6ba03aa 100644 --- a/.replworks/TECH_STACK.md +++ b/.replworks/TECH_STACK.md @@ -1,11 +1,12 @@ -# ASTRO.md +# TECH_STACK.md ## STACK REQUIRED - Astro 7.x -- JavaScript +- TypeScript 6.x +- Node.js 24.x OPTIONAL @@ -39,6 +40,20 @@ FOLLOW_PACKAGE_JSON --- +## DEVELOPMENT_TOOLING + +- Vite 8.x +- Vitest 5.x +- Playwright 1.x +- ESLint 10.x +- Prettier 3.x + +USE_DECLARED_TOOLING_ONLY + +RUN_PROJECT_DEFINED_VALIDATION_COMMANDS + +--- + ## PROJECT_STRUCTURE ```text diff --git a/package-lock.json b/package-lock.json index b9fc824..b4e6b35 100644 --- a/package-lock.json +++ b/package-lock.json @@ -32,7 +32,7 @@ "vitest": "^5.0.3" }, "engines": { - "node": ">=22.12.0" + "node": ">=24.0.0 <25.0.0" } }, "node_modules/@astrojs/astro2tsx": { diff --git a/package.json b/package.json index 8ed037d..d0d201b 100644 --- a/package.json +++ b/package.json @@ -3,7 +3,7 @@ "type": "module", "version": "0.0.1", "engines": { - "node": ">=22.12.0" + "node": ">=24.0.0 <25.0.0" }, "scripts": { "dev": "astro dev", From 094338c8ef097b63dd7ea44e11938a75a7108127 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Fri, 2 Oct 2026 00:45:46 +0900 Subject: [PATCH 4/7] refactor: rename `/content/` with `templates` --- AGENTS.md | 6 +++--- README.md | 12 ++++++------ {content => templates}/AGENTS.md | 0 {content => templates}/prompts/AI_MEMORY_PROMPT.txt | 0 .../prompts/ARCHITECTURE_PROMPT.txt | 0 {content => templates}/prompts/BLOG_PROMPT.txt | 0 .../prompts/DEVELOPMENT_LOG_PROMPT.txt | 0 {content => templates}/prompts/IDEAS_PROMPT.txt | 0 {content => templates}/prompts/JOURNAL_PROMPT.txt | 0 .../prompts/PITCHING_SCRIPT_PROMPT.txt | 0 .../prompts/PRODUCT_SPEC_PROMPT.txt | 0 .../REVIEW_IMPLEMENTATION_READINESS_PROMPT.txt | 0 {content => templates}/prompts/TASKS_PROMPT.txt | 0 .../prompts/TECH_STACK_DISCOVERY.txt | 0 {content => templates}/prompts/TECH_STACK_PROMPT.txt | 0 {content => templates}/tech-stacks/ASTRO.md | 0 {content => templates}/tech-stacks/FASTAPI.md | 0 {content => templates}/tech-stacks/GO_CLI.md | 0 {content => templates}/tech-stacks/NEXTJS.md | 0 {content => templates}/tech-stacks/NODE_CLI.md | 0 {content => templates}/tech-stacks/REACT_VITE.md | 0 {content => templates}/tech-stacks/VANILLA.md | 0 22 files changed, 9 insertions(+), 9 deletions(-) rename {content => templates}/AGENTS.md (100%) rename {content => templates}/prompts/AI_MEMORY_PROMPT.txt (100%) rename {content => templates}/prompts/ARCHITECTURE_PROMPT.txt (100%) rename {content => templates}/prompts/BLOG_PROMPT.txt (100%) rename {content => templates}/prompts/DEVELOPMENT_LOG_PROMPT.txt (100%) rename {content => templates}/prompts/IDEAS_PROMPT.txt (100%) rename {content => templates}/prompts/JOURNAL_PROMPT.txt (100%) rename {content => templates}/prompts/PITCHING_SCRIPT_PROMPT.txt (100%) rename {content => templates}/prompts/PRODUCT_SPEC_PROMPT.txt (100%) rename {content => templates}/prompts/REVIEW_IMPLEMENTATION_READINESS_PROMPT.txt (100%) rename {content => templates}/prompts/TASKS_PROMPT.txt (100%) rename {content => templates}/prompts/TECH_STACK_DISCOVERY.txt (100%) rename {content => templates}/prompts/TECH_STACK_PROMPT.txt (100%) rename {content => templates}/tech-stacks/ASTRO.md (100%) rename {content => templates}/tech-stacks/FASTAPI.md (100%) rename {content => templates}/tech-stacks/GO_CLI.md (100%) rename {content => templates}/tech-stacks/NEXTJS.md (100%) rename {content => templates}/tech-stacks/NODE_CLI.md (100%) rename {content => templates}/tech-stacks/REACT_VITE.md (100%) rename {content => templates}/tech-stacks/VANILLA.md (100%) diff --git a/AGENTS.md b/AGENTS.md index 77c4500..e4c303e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -16,10 +16,10 @@ Ignore all files under: - `/docs/**/*` -- `/content/**/*` +- `/templates/**/*` -Never use files in `/docs/**/*` and `/content/**/*` as requirements. -Never implement features described only in `/docs/**/*` and `/content/**/*`. +Never use files in `/docs/**/*` and `/templates/**/*` as requirements. +Never implement features described only in `/docs/**/*` and `/templates/**/*`. --- diff --git a/README.md b/README.md index 77ce736..f335f9d 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ REPLWorks는 코드를 먼저 작성하는 방식이 아니다. 먼저 제품과 ↓ 제품 정의 - .replworks/PRODUCT_SPEC.md 생성 ↓ -기술 사양 정의 - .replworks/TECH_STACK.md 생성 혹은 content/tech-stacks/ 에서 복사 +기술 사양 정의 - .replworks/TECH_STACK.md 생성 혹은 templates/tech-stacks/ 에서 복사 ↓ 아키텍처 설계 - .replworks/ARCHITECTURE.md 생성 ↓ @@ -103,14 +103,14 @@ AI agent는 먼저 `AGENTS.md`를 읽고, 그 문서가 선언한 순서에 따 5. 테스트와 빌드를 실행한다. 6. 문서와 코드가 어긋나면 다음 작업으로 넘어가지 않고 충돌을 보고한다. -## `content/`의 역할 +## `templates/`의 역할 -`content/`는 웹사이트가 직접 렌더링하는 콘텐츠 디렉터리가 아니다. +`templates/`는 웹사이트가 직접 렌더링하는 콘텐츠 디렉터리가 아니다. -`content/`에는 REPLWorks 방식으로 실무를 진행할 때 AI가 참고하는 프롬프트와 미리 만들어 놓은 예제 `TECH_STACK.md`를 둔다. 실무에서 이 파일들을 수정하면, AI는 해당 내용을 참고해 웹사이트의 실제 콘텐츠와 구현을 `src/**`에 반영한다. +`templates/`에는 REPLWorks 방식으로 실무를 진행할 때 AI가 참고하는 프롬프트와 미리 만들어 놓은 예제 `TECH_STACK.md`를 둔다. 실무에서 이 파일들을 수정하면, AI는 해당 내용을 참고해 웹사이트의 실제 콘텐츠와 구현을 `src/**`에 반영한다. ```text -content/ +templates/ ├── prompts/ # 실무에서 사용하는 재사용 프롬프트 └── tech-stacks/ # 프레임워크별 `TECH_STACK.md` 템플릿 @@ -118,7 +118,7 @@ src/ └── ... # Astro가 실제로 빌드하고 웹사이트에 렌더링하는 파일 ``` -따라서 `content/`는 Astro content collection이나 public asset으로 등록하지 않는다. `content/`의 파일을 웹사이트에 그대로 노출하거나 raw endpoint로 제공하지 않는다. +따라서 `templates/`는 Astro content collection이나 public asset으로 등록하지 않는다. `templates/`의 파일을 웹사이트에 그대로 노출하거나 raw endpoint로 제공하지 않는다. ## 이 저장소 diff --git a/content/AGENTS.md b/templates/AGENTS.md similarity index 100% rename from content/AGENTS.md rename to templates/AGENTS.md diff --git a/content/prompts/AI_MEMORY_PROMPT.txt b/templates/prompts/AI_MEMORY_PROMPT.txt similarity index 100% rename from content/prompts/AI_MEMORY_PROMPT.txt rename to templates/prompts/AI_MEMORY_PROMPT.txt diff --git a/content/prompts/ARCHITECTURE_PROMPT.txt b/templates/prompts/ARCHITECTURE_PROMPT.txt similarity index 100% rename from content/prompts/ARCHITECTURE_PROMPT.txt rename to templates/prompts/ARCHITECTURE_PROMPT.txt diff --git a/content/prompts/BLOG_PROMPT.txt b/templates/prompts/BLOG_PROMPT.txt similarity index 100% rename from content/prompts/BLOG_PROMPT.txt rename to templates/prompts/BLOG_PROMPT.txt diff --git a/content/prompts/DEVELOPMENT_LOG_PROMPT.txt b/templates/prompts/DEVELOPMENT_LOG_PROMPT.txt similarity index 100% rename from content/prompts/DEVELOPMENT_LOG_PROMPT.txt rename to templates/prompts/DEVELOPMENT_LOG_PROMPT.txt diff --git a/content/prompts/IDEAS_PROMPT.txt b/templates/prompts/IDEAS_PROMPT.txt similarity index 100% rename from content/prompts/IDEAS_PROMPT.txt rename to templates/prompts/IDEAS_PROMPT.txt diff --git a/content/prompts/JOURNAL_PROMPT.txt b/templates/prompts/JOURNAL_PROMPT.txt similarity index 100% rename from content/prompts/JOURNAL_PROMPT.txt rename to templates/prompts/JOURNAL_PROMPT.txt diff --git a/content/prompts/PITCHING_SCRIPT_PROMPT.txt b/templates/prompts/PITCHING_SCRIPT_PROMPT.txt similarity index 100% rename from content/prompts/PITCHING_SCRIPT_PROMPT.txt rename to templates/prompts/PITCHING_SCRIPT_PROMPT.txt diff --git a/content/prompts/PRODUCT_SPEC_PROMPT.txt b/templates/prompts/PRODUCT_SPEC_PROMPT.txt similarity index 100% rename from content/prompts/PRODUCT_SPEC_PROMPT.txt rename to templates/prompts/PRODUCT_SPEC_PROMPT.txt diff --git a/content/prompts/REVIEW_IMPLEMENTATION_READINESS_PROMPT.txt b/templates/prompts/REVIEW_IMPLEMENTATION_READINESS_PROMPT.txt similarity index 100% rename from content/prompts/REVIEW_IMPLEMENTATION_READINESS_PROMPT.txt rename to templates/prompts/REVIEW_IMPLEMENTATION_READINESS_PROMPT.txt diff --git a/content/prompts/TASKS_PROMPT.txt b/templates/prompts/TASKS_PROMPT.txt similarity index 100% rename from content/prompts/TASKS_PROMPT.txt rename to templates/prompts/TASKS_PROMPT.txt diff --git a/content/prompts/TECH_STACK_DISCOVERY.txt b/templates/prompts/TECH_STACK_DISCOVERY.txt similarity index 100% rename from content/prompts/TECH_STACK_DISCOVERY.txt rename to templates/prompts/TECH_STACK_DISCOVERY.txt diff --git a/content/prompts/TECH_STACK_PROMPT.txt b/templates/prompts/TECH_STACK_PROMPT.txt similarity index 100% rename from content/prompts/TECH_STACK_PROMPT.txt rename to templates/prompts/TECH_STACK_PROMPT.txt diff --git a/content/tech-stacks/ASTRO.md b/templates/tech-stacks/ASTRO.md similarity index 100% rename from content/tech-stacks/ASTRO.md rename to templates/tech-stacks/ASTRO.md diff --git a/content/tech-stacks/FASTAPI.md b/templates/tech-stacks/FASTAPI.md similarity index 100% rename from content/tech-stacks/FASTAPI.md rename to templates/tech-stacks/FASTAPI.md diff --git a/content/tech-stacks/GO_CLI.md b/templates/tech-stacks/GO_CLI.md similarity index 100% rename from content/tech-stacks/GO_CLI.md rename to templates/tech-stacks/GO_CLI.md diff --git a/content/tech-stacks/NEXTJS.md b/templates/tech-stacks/NEXTJS.md similarity index 100% rename from content/tech-stacks/NEXTJS.md rename to templates/tech-stacks/NEXTJS.md diff --git a/content/tech-stacks/NODE_CLI.md b/templates/tech-stacks/NODE_CLI.md similarity index 100% rename from content/tech-stacks/NODE_CLI.md rename to templates/tech-stacks/NODE_CLI.md diff --git a/content/tech-stacks/REACT_VITE.md b/templates/tech-stacks/REACT_VITE.md similarity index 100% rename from content/tech-stacks/REACT_VITE.md rename to templates/tech-stacks/REACT_VITE.md diff --git a/content/tech-stacks/VANILLA.md b/templates/tech-stacks/VANILLA.md similarity index 100% rename from content/tech-stacks/VANILLA.md rename to templates/tech-stacks/VANILLA.md From 6e97353384f7b13e3fbfe0249e164b6e26bfb559 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Fri, 2 Oct 2026 00:51:50 +0900 Subject: [PATCH 5/7] docs: update ARCHITECTURE.md to include TECH_STACK.md and remove outdated stack details --- .replworks/ARCHITECTURE.md | 68 ++------------------------------------ 1 file changed, 2 insertions(+), 66 deletions(-) diff --git a/.replworks/ARCHITECTURE.md b/.replworks/ARCHITECTURE.md index 929b214..5c252e0 100644 --- a/.replworks/ARCHITECTURE.md +++ b/.replworks/ARCHITECTURE.md @@ -211,6 +211,8 @@ AGENTS.md PRODUCT_SPEC.md +TECH_STACK.md + ARCHITECTURE.md TASKS.md @@ -474,72 +476,6 @@ Documents --- -## STACK - -Required - -```text -Node.js >= 24 - -npm >= 11 - -Astro >= 6 - -TypeScript >= 5 - -Tailwind CSS >= 4 -``` - ---- - -Package Manager - -```text -npm -``` - ---- - -Framework - -```text -Astro -``` - ---- - -Content - -```text -MDX -``` - ---- - -Search - -```text -Pagefind -``` - ---- - -Hosting - -```text -GitHub Pages -``` - ---- - -CI/CD - -```text -GitHub Actions -``` - ---- - ## CONSTRAINTS All pages must support: From f897925264e15f27ab5f4fdcc6e954d5148455c2 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Fri, 2 Oct 2026 01:00:45 +0900 Subject: [PATCH 6/7] docs: update TASKS.md to include TECH_STACK.md standard and add documentation alignment phase --- .replworks/TASKS.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/.replworks/TASKS.md b/.replworks/TASKS.md index 579f3aa..c1edcd0 100644 --- a/.replworks/TASKS.md +++ b/.replworks/TASKS.md @@ -163,6 +163,7 @@ Propose TASK update - [x] T422 Publish PRODUCT_SPEC.md standard - [x] T423 Publish ARCHITECTURE.md standard - [x] T424 Publish TASKS.md standard +- [x] T437 Publish TECH_STACK.md standard --- @@ -214,7 +215,7 @@ Propose TASK update - [x] T603 Review Document content - [x] T604 Review Tool content - [x] T605 Review Showcase content -- [ ] T605 Review FAQ content +- [ ] T606 Review FAQ content --- @@ -230,6 +231,14 @@ Propose TASK update --- +# PHASE 8 + +## DOCUMENTATION ALIGNMENT + +- [x] T801 Align document naming and structure + +--- + ## COMPLETION ```text From 1b937e9724a83a7f53ef2af088b387207f0c31a8 Mon Sep 17 00:00:00 2001 From: Samgu Lee Date: Fri, 2 Oct 2026 01:02:57 +0900 Subject: [PATCH 7/7] docs: remove references to human-created documents in PRODUCT_SPEC.md --- .replworks/PRODUCT_SPEC.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/.replworks/PRODUCT_SPEC.md b/.replworks/PRODUCT_SPEC.md index 32d22bb..538451a 100644 --- a/.replworks/PRODUCT_SPEC.md +++ b/.replworks/PRODUCT_SPEC.md @@ -332,10 +332,6 @@ docs/IDEAS.md docs/PITCHING_SCRIPT.md ``` -`IDEAS.md` and `PITCHING_SCRIPT.md` are created by humans and stored under -`docs/`. They are not authoritative AI documents and must not be used by AI -agents as requirements. - --- ## DOCUMENT_CREATION_ORDER @@ -354,8 +350,6 @@ AI: .replworks/ARCHITECTURE.md AI: .replworks/TASKS.md ``` -The AI document sequence begins with `PRODUCT_SPEC.md`. The human-created documents under `docs/` provide the preceding product context but are outside the AI document loading order. - --- Each document page must explain: