Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
68 changes: 2 additions & 66 deletions .replworks/ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -211,6 +211,8 @@ AGENTS.md

PRODUCT_SPEC.md

TECH_STACK.md

ARCHITECTURE.md

TASKS.md
Expand Down Expand Up @@ -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:
Expand Down
26 changes: 23 additions & 3 deletions .replworks/PRODUCT_SPEC.md
Original file line number Diff line number Diff line change
Expand Up @@ -315,19 +315,39 @@ AGENTS.md

PRODUCT_SPEC.md

TECH_STACK.md

ARCHITECTURE.md

TASKS.md
```

---

Optional Documents
Human-Created Documents

```text
IDEAS.md
docs/IDEAS.md

docs/PITCHING_SCRIPT.md
```

PITCHING_SCRIPT.md
---

## 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
```

---
Expand Down
11 changes: 10 additions & 1 deletion .replworks/TASKS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

---

Expand Down Expand Up @@ -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

---

Expand All @@ -230,6 +231,14 @@ Propose TASK update

---

# PHASE 8

## DOCUMENTATION ALIGNMENT

- [x] T801 Align document naming and structure

---

## COMPLETION

```text
Expand Down
21 changes: 18 additions & 3 deletions .replworks/TECH_STACK.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
# ASTRO.md
# TECH_STACK.md

## STACK

REQUIRED

- Astro 7.x
- JavaScript
- TypeScript 6.x
- Node.js 24.x

OPTIONAL

Expand All @@ -23,7 +24,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

Expand All @@ -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
Expand Down
6 changes: 3 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/**/*`.

---

Expand Down
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 생성
↓
Expand Down Expand Up @@ -103,22 +103,22 @@ 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` 템플릿

src/
└── ... # Astro가 실제로 빌드하고 웹사이트에 렌더링하는 파일
```

따라서 `content/`는 Astro content collection이나 public asset으로 등록하지 않는다. `content/`의 파일을 웹사이트에 그대로 노출하거나 raw endpoint로 제공하지 않는다.
따라서 `templates/`는 Astro content collection이나 public asset으로 등록하지 않는다. `templates/`의 파일을 웹사이트에 그대로 노출하거나 raw endpoint로 제공하지 않는다.

## 이 저장소

Expand Down
2 changes: 1 addition & 1 deletion package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
Loading