@kood/claude-code 0.5.9 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +127 -135
- package/package.json +1 -1
- package/templates/.claude/agents/build-fixer.md +371 -0
- package/templates/.claude/agents/critic.md +223 -0
- package/templates/.claude/agents/deep-executor.md +320 -0
- package/templates/.claude/agents/dependency-manager.md +0 -1
- package/templates/.claude/agents/deployment-validator.md +0 -1
- package/templates/.claude/agents/designer.md +0 -1
- package/templates/.claude/agents/document-writer.md +0 -1
- package/templates/.claude/agents/git-operator.md +15 -0
- package/templates/.claude/agents/implementation-executor.md +0 -1
- package/templates/.claude/agents/ko-to-en-translator.md +0 -1
- package/templates/.claude/agents/lint-fixer.md +0 -1
- package/templates/.claude/agents/planner.md +11 -7
- package/templates/.claude/agents/qa-tester.md +488 -0
- package/templates/.claude/agents/researcher.md +189 -0
- package/templates/.claude/agents/scientist.md +544 -0
- package/templates/.claude/agents/security-reviewer.md +549 -0
- package/templates/.claude/agents/tdd-guide.md +413 -0
- package/templates/.claude/agents/vision.md +165 -0
- package/templates/.claude/commands/pre-deploy.md +79 -2
- package/templates/.claude/instructions/agent-patterns/model-routing.md +2 -2
- package/templates/.claude/skills/brainstorm/SKILL.md +889 -0
- package/templates/.claude/skills/bug-fix/SKILL.md +69 -0
- package/templates/.claude/skills/crawler/SKILL.md +156 -0
- package/templates/.claude/skills/crawler/references/anti-bot-checklist.md +162 -0
- package/templates/.claude/skills/crawler/references/code-templates.md +119 -0
- package/templates/.claude/skills/crawler/references/crawling-patterns.md +167 -0
- package/templates/.claude/skills/crawler/references/document-templates.md +147 -0
- package/templates/.claude/skills/crawler/references/network-crawling.md +141 -0
- package/templates/.claude/skills/crawler/references/playwriter-commands.md +172 -0
- package/templates/.claude/skills/crawler/references/pre-crawl-checklist.md +221 -0
- package/templates/.claude/skills/crawler/references/selector-strategies.md +140 -0
- package/templates/.claude/skills/execute/SKILL.md +5 -0
- package/templates/.claude/skills/feedback/SKILL.md +570 -0
- package/templates/.claude/skills/figma-to-code/SKILL.md +1 -0
- package/templates/.claude/skills/global-uiux-design/SKILL.md +1 -0
- package/templates/.claude/skills/korea-uiux-design/SKILL.md +1 -0
- package/templates/.claude/skills/nextjs-react-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/plan/SKILL.md +44 -0
- package/templates/.claude/skills/ralph/SKILL.md +16 -18
- package/templates/.claude/skills/refactor/SKILL.md +19 -0
- package/templates/.claude/skills/tanstack-start-react-best-practices/SKILL.md +1 -0
- package/templates/.claude/skills/stitch-design/README.md +0 -34
- package/templates/.claude/skills/stitch-design/SKILL.md +0 -213
- package/templates/.claude/skills/stitch-design/examples/DESIGN.md +0 -154
- package/templates/.claude/skills/stitch-loop/README.md +0 -54
- package/templates/.claude/skills/stitch-loop/SKILL.md +0 -316
- package/templates/.claude/skills/stitch-loop/examples/SITE.md +0 -73
- package/templates/.claude/skills/stitch-loop/examples/next-prompt.md +0 -25
- package/templates/.claude/skills/stitch-loop/resources/baton-schema.md +0 -61
- package/templates/.claude/skills/stitch-loop/resources/site-template.md +0 -104
- package/templates/.claude/skills/stitch-react/README.md +0 -36
- package/templates/.claude/skills/stitch-react/SKILL.md +0 -323
- package/templates/.claude/skills/stitch-react/examples/gold-standard-card.tsx +0 -88
- package/templates/.claude/skills/stitch-react/package-lock.json +0 -231
- package/templates/.claude/skills/stitch-react/package.json +0 -16
- package/templates/.claude/skills/stitch-react/resources/architecture-checklist.md +0 -15
- package/templates/.claude/skills/stitch-react/resources/component-template.tsx +0 -37
- package/templates/.claude/skills/stitch-react/resources/stitch-api-reference.md +0 -14
- package/templates/.claude/skills/stitch-react/resources/style-guide.json +0 -24
- package/templates/.claude/skills/stitch-react/scripts/fetch-stitch.sh +0 -30
- package/templates/.claude/skills/stitch-react/scripts/validate.js +0 -77
|
@@ -66,7 +66,7 @@ while (true) {
|
|
|
66
66
|
|
|
67
67
|
**하나라도 실패 → ITERATION++ → Phase 1로 복귀**
|
|
68
68
|
|
|
69
|
-
### 상태 문서 (`.claude/ralph/
|
|
69
|
+
### 상태 문서 (`.claude/ralph/00.[작업명]/`)
|
|
70
70
|
|
|
71
71
|
| 파일 | 역할 | 업데이트 시점 |
|
|
72
72
|
|------|------|--------------|
|
|
@@ -114,7 +114,7 @@ while (true) {
|
|
|
114
114
|
| 2 | 코드 검증 | **새로 실행한** `/pre-deploy` 결과 | typecheck/lint/build 모두 통과 |
|
|
115
115
|
| 3 | TODO 확인 | **새로 실행한** TaskList 조회 | pending/in_progress = 0 |
|
|
116
116
|
| 4 | 플래너 검증 | **새로 생성한** Planner 에이전트 호출 | "승인" 응답 |
|
|
117
|
-
| 5 | 상태 정리 | `.claude/ralph/` 상태 문서 최종 업데이트 | 완료 시각 기록 |
|
|
117
|
+
| 5 | 상태 정리 | `.claude/ralph/00.[작업명]/` 상태 문서 최종 업데이트 | 완료 시각 기록 |
|
|
118
118
|
|
|
119
119
|
**모든 5단계 통과 후에만 `<promise>` 출력. 하나라도 실패 시 루프 재개.**
|
|
120
120
|
|
|
@@ -157,7 +157,7 @@ Task(subagent_type="planner", model="opus", ...) // 새로 검증
|
|
|
157
157
|
|
|
158
158
|
### 상태 문서 정리
|
|
159
159
|
|
|
160
|
-
완료 직전 `.claude/ralph/
|
|
160
|
+
완료 직전 `.claude/ralph/00.[작업명]/` 최종 업데이트:
|
|
161
161
|
- TASKS.md: 모든 체크박스 완료
|
|
162
162
|
- PROCESS.md: 완료 시각, 총 소요 시간
|
|
163
163
|
- VERIFICATION.md: 최종 검증 결과
|
|
@@ -725,10 +725,10 @@ Task(subagent_type="ko-to-en-translator", model="haiku",
|
|
|
725
725
|
|
|
726
726
|
### 문서화 폴더 구조
|
|
727
727
|
|
|
728
|
-
**필수:** 세션 시작 시 `.claude/ralph/
|
|
728
|
+
**필수:** 세션 시작 시 `.claude/ralph/00.[작업명]/` 폴더 생성
|
|
729
729
|
|
|
730
730
|
```
|
|
731
|
-
.claude/ralph/
|
|
731
|
+
.claude/ralph/00.사용자_인증_구현/
|
|
732
732
|
├── TASKS.md # 작업 체크리스트
|
|
733
733
|
├── PROCESS.md # 진행 단계 및 의사결정
|
|
734
734
|
├── VERIFICATION.md # 검증 결과 기록 (매 반복마다 업데이트)
|
|
@@ -736,10 +736,8 @@ Task(subagent_type="ko-to-en-translator", model="haiku",
|
|
|
736
736
|
└── NOTES.md # 추가 메모
|
|
737
737
|
```
|
|
738
738
|
|
|
739
|
-
**폴더명 형식:** `
|
|
740
|
-
|
|
741
|
-
- 시퀀스: 같은 날 여러 세션 시 증가 (01, 02, 03...)
|
|
742
|
-
- 작업명: 한글 설명 (언더스코어로 구분)
|
|
739
|
+
**폴더명 형식:** `00.[작업명]` (넘버링 + 한글 설명, 언더스코어로 구분)
|
|
740
|
+
**넘버링:** 기존 ralph 폴더 목록 조회 → 다음 번호 자동 부여 (00, 01, 02...)
|
|
743
741
|
|
|
744
742
|
**생성 시점:** Ralph 루프 진입 즉시 (첫 반복 시작 전)
|
|
745
743
|
|
|
@@ -908,7 +906,7 @@ Context compaction 후 세션 재개 시:
|
|
|
908
906
|
|
|
909
907
|
```text
|
|
910
908
|
1. pwd 실행 → 작업 디렉토리 확인
|
|
911
|
-
2. ls .claude/ralph/ → 최신 세션 폴더 식별 (가장 큰
|
|
909
|
+
2. ls .claude/ralph/ → 최신 세션 폴더 식별 (가장 큰 넘버링)
|
|
912
910
|
3. TASKS.md 읽기 → 요구사항 및 진행 상태 파악
|
|
913
911
|
4. PROCESS.md 읽기 → 현재 Phase 및 다음 단계 확인
|
|
914
912
|
5. VERIFICATION.md 읽기 → 검증 결과 확인
|
|
@@ -928,7 +926,7 @@ Context compaction 후 세션 재개 시:
|
|
|
928
926
|
|
|
929
927
|
```text
|
|
930
928
|
1. 원본 작업 요구사항 분석
|
|
931
|
-
2. 넘버링 결정 (ls .claude/ralph/)
|
|
929
|
+
2. 넘버링 결정 (ls .claude/ralph/ → 다음 번호 자동 부여)
|
|
932
930
|
3. .claude/ralph/00.[작업명]/ 폴더 생성 (한글 설명)
|
|
933
931
|
4. TASKS.md 작성 (체크리스트)
|
|
934
932
|
5. PROCESS.md 작성 (Phase 1 시작 기록)
|
|
@@ -1275,8 +1273,8 @@ Task(subagent_type="code-reviewer", model="opus", ...)
|
|
|
1275
1273
|
|
|
1276
1274
|
**즉시 실행 (순차):**
|
|
1277
1275
|
1. 원본 작업(`{{PROMPT}}`) 읽기
|
|
1278
|
-
2. 세션 폴더 생성: `.claude/ralph/
|
|
1279
|
-
- `ls .claude/ralph/` →
|
|
1276
|
+
2. 세션 폴더 생성: `.claude/ralph/00.[작업명]/`
|
|
1277
|
+
- `ls .claude/ralph/` → 기존 폴더 조회 → 다음 넘버링 결정
|
|
1280
1278
|
3. 상태 문서 초기화 (병렬):
|
|
1281
1279
|
```typescript
|
|
1282
1280
|
Task(subagent_type="document-writer", model="haiku",
|
|
@@ -1312,10 +1310,10 @@ Task(subagent_type="code-reviewer", model="opus", ...)
|
|
|
1312
1310
|
|
|
1313
1311
|
**복구 프로토콜 (순차):**
|
|
1314
1312
|
1. `pwd` → 작업 디렉토리 확인
|
|
1315
|
-
2. `ls
|
|
1316
|
-
3. `cat .claude/ralph/
|
|
1317
|
-
4. `cat .claude/ralph/
|
|
1318
|
-
5. `cat .claude/ralph/
|
|
1313
|
+
2. `ls .claude/ralph/` → 최신 세션 폴더 찾기 (가장 큰 넘버링)
|
|
1314
|
+
3. `cat .claude/ralph/00.[작업명]/ITERATION.md` → 반복 히스토리 확인
|
|
1315
|
+
4. `cat .claude/ralph/00.[작업명]/VERIFICATION.md` → 마지막 검증 결과
|
|
1316
|
+
5. `cat .claude/ralph/00.[작업명]/TASKS.md` → 미완료 항목
|
|
1319
1317
|
6. `git log --oneline -10` → 최근 커밋
|
|
1320
1318
|
7. 현재 Iteration 번호 식별 후 루프 재개
|
|
1321
1319
|
|
|
@@ -1440,7 +1438,7 @@ Task(subagent_type="planner", ...) // Iteration N에서 새로 생성
|
|
|
1440
1438
|
|
|
1441
1439
|
### 6. 문서 = 루프 지속성
|
|
1442
1440
|
|
|
1443
|
-
`.claude/ralph/
|
|
1441
|
+
`.claude/ralph/00.[작업명]/` 상태 문서:
|
|
1444
1442
|
- TASKS.md: 요구사항 체크리스트
|
|
1445
1443
|
- PROCESS.md: Phase 진행 상황
|
|
1446
1444
|
- VERIFICATION.md: 매 반복 검증 결과
|
|
@@ -161,6 +161,8 @@ $ARGUMENTS 있음 → 다음 단계 진행
|
|
|
161
161
|
| **@analyst** | sonnet | 코드 메트릭 분석, 엣지 케이스 검증 |
|
|
162
162
|
| **@explore** | haiku | 코드베이스 탐색, 의존성 파악 |
|
|
163
163
|
| **@document-writer** | haiku/sonnet | 리팩토링 계획 및 결과 문서화 |
|
|
164
|
+
| **@security-reviewer** | opus | 리팩토링 후 보안 취약점 검증 |
|
|
165
|
+
| **@build-fixer** | sonnet | 리팩토링 후 빌드/타입 오류 수정 |
|
|
164
166
|
|
|
165
167
|
### 병렬 실행 패턴
|
|
166
168
|
|
|
@@ -314,6 +316,23 @@ Task({
|
|
|
314
316
|
})
|
|
315
317
|
```
|
|
316
318
|
|
|
319
|
+
#### 5-1. 리팩토링 후 보안 + 빌드 검증 병렬
|
|
320
|
+
|
|
321
|
+
```typescript
|
|
322
|
+
// ✅ 리팩토링 후 보안 + 빌드 검증 병렬
|
|
323
|
+
Task({
|
|
324
|
+
subagent_type: "security-reviewer",
|
|
325
|
+
model: "opus",
|
|
326
|
+
prompt: "리팩토링 후 보안 취약점 검토"
|
|
327
|
+
})
|
|
328
|
+
|
|
329
|
+
Task({
|
|
330
|
+
subagent_type: "build-fixer",
|
|
331
|
+
model: "sonnet",
|
|
332
|
+
prompt: "리팩토링으로 발생한 빌드/타입 오류 수정"
|
|
333
|
+
})
|
|
334
|
+
```
|
|
335
|
+
|
|
317
336
|
#### 6. 점진적 마이그레이션 병렬화
|
|
318
337
|
|
|
319
338
|
```typescript
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
name: tanstack-start-react-best-practices
|
|
3
3
|
description: TanStack Start와 React 성능 최적화 가이드. React 컴포넌트, TanStack Start 페이지 작성/리뷰/리팩토링 시 최적 성능 패턴 보장. React 컴포넌트, TanStack Router 라우트, 데이터 페칭, 번들 최적화, 성능 개선 작업에 트리거.
|
|
4
4
|
license: MIT
|
|
5
|
+
framework: tanstack-start
|
|
5
6
|
metadata:
|
|
6
7
|
author: vercel
|
|
7
8
|
version: "1.0.0"
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
# Stitch Design System Documentation Skill
|
|
2
|
-
|
|
3
|
-
## Install
|
|
4
|
-
|
|
5
|
-
```bash
|
|
6
|
-
npx add-skill google-labs-code/stitch-skills --skill design-md --global
|
|
7
|
-
```
|
|
8
|
-
|
|
9
|
-
## Example Prompt
|
|
10
|
-
|
|
11
|
-
```text
|
|
12
|
-
Analyze my Furniture Collection project's Home screen and generate a comprehensive DESIGN.md file documenting the design system.
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
## Skill Structure
|
|
16
|
-
|
|
17
|
-
This repository follows the **Agent Skills** open standard. Each skill is self-contained with its own logic, workflow, and reference materials.
|
|
18
|
-
|
|
19
|
-
```text
|
|
20
|
-
design-md/
|
|
21
|
-
├── SKILL.md — Core instructions & workflow
|
|
22
|
-
├── examples/ — Sample DESIGN.md outputs
|
|
23
|
-
└── README.md — This file
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## How it Works
|
|
27
|
-
|
|
28
|
-
When activated, the agent follows a structured design analysis pipeline:
|
|
29
|
-
|
|
30
|
-
1. **Retrieval**: Uses the Stitch MCP Server to fetch project screens, HTML code, and design metadata.
|
|
31
|
-
2. **Extraction**: Identifies design tokens including colors, typography, spacing, and component patterns.
|
|
32
|
-
3. **Translation**: Converts technical CSS/Tailwind values into descriptive, natural design language.
|
|
33
|
-
4. **Synthesis**: Generates a comprehensive DESIGN.md following the semantic design system format.
|
|
34
|
-
5. **Alignment**: Ensures output follows Stitch Effective Prompting Guide principles for optimal screen generation.
|
|
@@ -1,213 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: stitch:design
|
|
3
|
-
description: 프로젝트 디자인 시스템 분석 후 DESIGN.md 생성
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
<purpose>
|
|
7
|
-
프로젝트의 디자인 자산(UI 컴포넌트, 스타일)을 분석하여 디자인 시스템 문서(DESIGN.md) 생성
|
|
8
|
-
</purpose>
|
|
9
|
-
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
<trigger_conditions>
|
|
13
|
-
|
|
14
|
-
| 트리거 | 반응 |
|
|
15
|
-
|--------|------|
|
|
16
|
-
| "디자인 시스템 문서화" | 즉시 실행 |
|
|
17
|
-
| "DESIGN.md 생성" | 즉시 실행 |
|
|
18
|
-
| "디자인 가이드 작성" | 즉시 실행 |
|
|
19
|
-
|
|
20
|
-
</trigger_conditions>
|
|
21
|
-
|
|
22
|
-
---
|
|
23
|
-
|
|
24
|
-
<workflow>
|
|
25
|
-
|
|
26
|
-
<step number="1">
|
|
27
|
-
<action>프로젝트 구조 탐색</action>
|
|
28
|
-
<tools>Glob, Grep</tools>
|
|
29
|
-
<details>
|
|
30
|
-
- UI 컴포넌트 파일 찾기 (`components/**/*.tsx`)
|
|
31
|
-
- 스타일 파일 찾기 (`**/*.css`, `tailwind.config.*`)
|
|
32
|
-
- 디자인 토큰 파일 찾기
|
|
33
|
-
</details>
|
|
34
|
-
</step>
|
|
35
|
-
|
|
36
|
-
<step number="2">
|
|
37
|
-
<action>디자인 자산 분석</action>
|
|
38
|
-
<tools>Read</tools>
|
|
39
|
-
<details>
|
|
40
|
-
- Tailwind 설정에서 색상/타이포/간격 추출
|
|
41
|
-
- 컴포넌트에서 공통 스타일 패턴 파악
|
|
42
|
-
- CSS 변수에서 테마 정보 수집
|
|
43
|
-
</details>
|
|
44
|
-
</step>
|
|
45
|
-
|
|
46
|
-
<step number="3">
|
|
47
|
-
<action>디자인 언어로 변환</action>
|
|
48
|
-
<tools>-</tools>
|
|
49
|
-
<details>
|
|
50
|
-
| 기술적 표현 | 디자인 언어 |
|
|
51
|
-
|------------|------------|
|
|
52
|
-
| `rounded-full` | "완전한 원형" |
|
|
53
|
-
| `border-radius: 12px` | "부드러운 모서리" |
|
|
54
|
-
| `shadow-lg` | "깊은 그림자" |
|
|
55
|
-
| `#3B82F6` | "생동감 있는 파란색" |
|
|
56
|
-
</details>
|
|
57
|
-
</step>
|
|
58
|
-
|
|
59
|
-
<step number="4">
|
|
60
|
-
<action>DESIGN.md 작성</action>
|
|
61
|
-
<tools>Write</tools>
|
|
62
|
-
<details>
|
|
63
|
-
구조:
|
|
64
|
-
1. 비주얼 테마 (분위기, 느낌)
|
|
65
|
-
2. 색상 팔레트 (hex + 기능)
|
|
66
|
-
3. 타이포그래피 (폰트, 크기, 용도)
|
|
67
|
-
4. 컴포넌트 스타일링
|
|
68
|
-
5. 레이아웃/간격 원칙
|
|
69
|
-
</details>
|
|
70
|
-
</step>
|
|
71
|
-
|
|
72
|
-
</workflow>
|
|
73
|
-
|
|
74
|
-
---
|
|
75
|
-
|
|
76
|
-
<output_format>
|
|
77
|
-
|
|
78
|
-
```markdown
|
|
79
|
-
# Design System
|
|
80
|
-
|
|
81
|
-
## Visual Theme
|
|
82
|
-
[프로젝트의 전반적인 분위기와 느낌 서술]
|
|
83
|
-
|
|
84
|
-
## Color Palette
|
|
85
|
-
|
|
86
|
-
| 색상 | Hex | 기능 |
|
|
87
|
-
|------|-----|------|
|
|
88
|
-
| Primary | #3B82F6 | 주요 액션, CTA 버튼 |
|
|
89
|
-
| Secondary | #64748B | 보조 텍스트, 아이콘 |
|
|
90
|
-
| Background | #FFFFFF | 배경 |
|
|
91
|
-
|
|
92
|
-
## Typography
|
|
93
|
-
|
|
94
|
-
| 용도 | 폰트 | 크기 | 무게 |
|
|
95
|
-
|------|------|------|------|
|
|
96
|
-
| Heading | Inter | 32px | 700 |
|
|
97
|
-
| Body | Inter | 16px | 400 |
|
|
98
|
-
|
|
99
|
-
## Component Patterns
|
|
100
|
-
|
|
101
|
-
### 버튼
|
|
102
|
-
- 기본: 부드러운 모서리(8px), 생동감 있는 파란색
|
|
103
|
-
- Hover: 약간 어두운 파란색
|
|
104
|
-
- 패딩: 상하 12px, 좌우 24px
|
|
105
|
-
|
|
106
|
-
### 카드
|
|
107
|
-
- 배경: 흰색
|
|
108
|
-
- 테두리: 연한 회색(1px)
|
|
109
|
-
- 그림자: 부드러운 그림자
|
|
110
|
-
- 모서리: 부드러운(12px)
|
|
111
|
-
|
|
112
|
-
## Layout & Spacing
|
|
113
|
-
|
|
114
|
-
- 기본 그리드: 8px
|
|
115
|
-
- 컨테이너 최대 너비: 1280px
|
|
116
|
-
- 섹션 간격: 64px
|
|
117
|
-
```
|
|
118
|
-
|
|
119
|
-
</output_format>
|
|
120
|
-
|
|
121
|
-
---
|
|
122
|
-
|
|
123
|
-
<examples>
|
|
124
|
-
|
|
125
|
-
## Tailwind 프로젝트
|
|
126
|
-
|
|
127
|
-
**입력:**
|
|
128
|
-
```typescript
|
|
129
|
-
// tailwind.config.ts
|
|
130
|
-
export default {
|
|
131
|
-
theme: {
|
|
132
|
-
extend: {
|
|
133
|
-
colors: {
|
|
134
|
-
primary: '#3B82F6',
|
|
135
|
-
secondary: '#64748B',
|
|
136
|
-
},
|
|
137
|
-
borderRadius: {
|
|
138
|
-
card: '12px',
|
|
139
|
-
},
|
|
140
|
-
},
|
|
141
|
-
},
|
|
142
|
-
}
|
|
143
|
-
```
|
|
144
|
-
|
|
145
|
-
**출력:**
|
|
146
|
-
```markdown
|
|
147
|
-
## Color Palette
|
|
148
|
-
|
|
149
|
-
| 색상 | Hex | 기능 |
|
|
150
|
-
|------|-----|------|
|
|
151
|
-
| Primary Blue | #3B82F6 | 주요 액션 버튼, 링크, 강조 |
|
|
152
|
-
| Secondary Gray | #64748B | 보조 텍스트, 비활성 요소 |
|
|
153
|
-
|
|
154
|
-
## Component Patterns
|
|
155
|
-
|
|
156
|
-
### 카드
|
|
157
|
-
- 모서리: 부드러운 곡선(12px)
|
|
158
|
-
- 느낌: 현대적이고 깔끔한 외관
|
|
159
|
-
```
|
|
160
|
-
|
|
161
|
-
---
|
|
162
|
-
|
|
163
|
-
## CSS Variables 프로젝트
|
|
164
|
-
|
|
165
|
-
**입력:**
|
|
166
|
-
```css
|
|
167
|
-
:root {
|
|
168
|
-
--color-brand: hsl(221, 83%, 53%);
|
|
169
|
-
--font-heading: 'Poppins', sans-serif;
|
|
170
|
-
--spacing-unit: 8px;
|
|
171
|
-
}
|
|
172
|
-
```
|
|
173
|
-
|
|
174
|
-
**출력:**
|
|
175
|
-
```markdown
|
|
176
|
-
## Visual Theme
|
|
177
|
-
밝고 신뢰감 있는 파란색 브랜드 컬러를 중심으로 한 현대적 디자인
|
|
178
|
-
|
|
179
|
-
## Typography
|
|
180
|
-
- Heading: Poppins (기하학적이고 친근한 느낌)
|
|
181
|
-
|
|
182
|
-
## Layout & Spacing
|
|
183
|
-
- 8px 그리드 시스템 사용
|
|
184
|
-
- 요소 간 일관된 간격 유지
|
|
185
|
-
```
|
|
186
|
-
|
|
187
|
-
</examples>
|
|
188
|
-
|
|
189
|
-
---
|
|
190
|
-
|
|
191
|
-
<validation>
|
|
192
|
-
|
|
193
|
-
**체크리스트:**
|
|
194
|
-
- [ ] 모든 색상에 hex 코드 포함
|
|
195
|
-
- [ ] 기술 용어 → 디자인 언어 변환
|
|
196
|
-
- [ ] 각 요소의 기능적 목적 설명
|
|
197
|
-
- [ ] 일관된 용어 사용
|
|
198
|
-
- [ ] 실제 사용 예시 포함
|
|
199
|
-
|
|
200
|
-
</validation>
|
|
201
|
-
|
|
202
|
-
---
|
|
203
|
-
|
|
204
|
-
<best_practices>
|
|
205
|
-
|
|
206
|
-
| 원칙 | 방법 |
|
|
207
|
-
|------|------|
|
|
208
|
-
| **서술적 표현** | "rounded-lg" → "부드럽게 둥근 모서리" |
|
|
209
|
-
| **기능 명시** | 색상 설명 시 "주요 액션 버튼에 사용" 추가 |
|
|
210
|
-
| **일관성** | 동일 개념은 동일 용어 사용 |
|
|
211
|
-
| **구체성** | "큰 그림자" < "깊이감 있는 그림자(16px blur)" |
|
|
212
|
-
|
|
213
|
-
</best_practices>
|
|
@@ -1,154 +0,0 @@
|
|
|
1
|
-
# Design System: Furniture Collections List
|
|
2
|
-
**Project ID:** 13534454087919359824
|
|
3
|
-
|
|
4
|
-
## 1. Visual Theme & Atmosphere
|
|
5
|
-
|
|
6
|
-
The Furniture Collections List embodies a **sophisticated, minimalist sanctuary** that marries the pristine simplicity of Scandinavian design with the refined visual language of luxury editorial presentation. The interface feels **spacious and tranquil**, prioritizing breathing room and visual clarity above all else. The design philosophy is gallery-like and photography-first, allowing each furniture piece to command attention as an individual art object.
|
|
7
|
-
|
|
8
|
-
The overall mood is **airy yet grounded**, creating an aspirational aesthetic that remains approachable and welcoming. The interface feels **utilitarian in its restraint** but elegant in its execution, with every element serving a clear purpose while maintaining visual sophistication. The atmosphere evokes the serene ambiance of a high-end furniture showroom where customers can browse thoughtfully without visual overwhelm.
|
|
9
|
-
|
|
10
|
-
**Key Characteristics:**
|
|
11
|
-
- Expansive whitespace creating generous breathing room between elements
|
|
12
|
-
- Clean, architectural grid system with structured content blocks
|
|
13
|
-
- Photography-first presentation with minimal UI interference
|
|
14
|
-
- Whisper-soft visual hierarchy that guides without shouting
|
|
15
|
-
- Refined, understated interactive elements
|
|
16
|
-
- Professional yet inviting editorial tone
|
|
17
|
-
|
|
18
|
-
## 2. Color Palette & Roles
|
|
19
|
-
|
|
20
|
-
### Primary Foundation
|
|
21
|
-
- **Warm Barely-There Cream** (#FCFAFA) – Primary background color. Creates an almost imperceptible warmth that feels more inviting than pure white, serving as the serene canvas for the entire experience.
|
|
22
|
-
- **Crisp Very Light Gray** (#F5F5F5) – Secondary surface color used for card backgrounds and content areas. Provides subtle visual separation while maintaining the airy, ethereal quality.
|
|
23
|
-
|
|
24
|
-
### Accent & Interactive
|
|
25
|
-
- **Deep Muted Teal-Navy** (#294056) – The sole vibrant accent in the palette. Used exclusively for primary call-to-action buttons (e.g., "Shop Now", "View all products"), active navigation links, selected filter states, and subtle interaction highlights. This sophisticated anchor color creates visual focus points without disrupting the serene neutral foundation.
|
|
26
|
-
|
|
27
|
-
### Typography & Text Hierarchy
|
|
28
|
-
- **Charcoal Near-Black** (#2C2C2C) – Primary text color for headlines and product names. Provides strong readable contrast while being softer and more refined than pure black.
|
|
29
|
-
- **Soft Warm Gray** (#6B6B6B) – Secondary text used for body copy, product descriptions, and supporting metadata. Creates clear typographic hierarchy without harsh contrast.
|
|
30
|
-
- **Ultra-Soft Silver Gray** (#E0E0E0) – Tertiary color for borders, dividers, and subtle structural elements. Creates separation so gentle it's almost imperceptible.
|
|
31
|
-
|
|
32
|
-
### Functional States (Reserved for system feedback)
|
|
33
|
-
- **Success Moss** (#10B981) – Stock availability, confirmation states, positive indicators
|
|
34
|
-
- **Alert Terracotta** (#EF4444) – Low stock warnings, error states, critical alerts
|
|
35
|
-
- **Informational Slate** (#64748B) – Neutral system messages, informational callouts
|
|
36
|
-
|
|
37
|
-
## 3. Typography Rules
|
|
38
|
-
|
|
39
|
-
**Primary Font Family:** Manrope
|
|
40
|
-
**Character:** Modern, geometric sans-serif with gentle humanist warmth. Slightly rounded letterforms that feel contemporary yet approachable.
|
|
41
|
-
|
|
42
|
-
### Hierarchy & Weights
|
|
43
|
-
- **Display Headlines (H1):** Semi-bold weight (600), generous letter-spacing (0.02em for elegance), 2.75-3.5rem size. Used sparingly for hero sections and major page titles.
|
|
44
|
-
- **Section Headers (H2):** Semi-bold weight (600), subtle letter-spacing (0.01em), 2-2.5rem size. Establishes clear content zones and featured collections.
|
|
45
|
-
- **Subsection Headers (H3):** Medium weight (500), normal letter-spacing, 1.5-1.75rem size. Product names and category labels.
|
|
46
|
-
- **Body Text:** Regular weight (400), relaxed line-height (1.7), 1rem size. Descriptions and supporting content prioritize comfortable readability.
|
|
47
|
-
- **Small Text/Meta:** Regular weight (400), slightly tighter line-height (1.5), 0.875rem size. Prices, availability, and metadata remain legible but visually recessive.
|
|
48
|
-
- **CTA Buttons:** Medium weight (500), subtle letter-spacing (0.01em), 1rem size. Balanced presence without visual aggression.
|
|
49
|
-
|
|
50
|
-
### Spacing Principles
|
|
51
|
-
- Headers use slightly expanded letter-spacing for refined elegance
|
|
52
|
-
- Body text maintains generous line-height (1.7) for effortless reading
|
|
53
|
-
- Consistent vertical rhythm with 2-3rem between related text blocks
|
|
54
|
-
- Large margins (4-6rem) between major sections to reinforce spaciousness
|
|
55
|
-
|
|
56
|
-
## 4. Component Stylings
|
|
57
|
-
|
|
58
|
-
### Buttons
|
|
59
|
-
- **Shape:** Subtly rounded corners (8px/0.5rem radius) – approachable and modern without appearing playful or childish
|
|
60
|
-
- **Primary CTA:** Deep Muted Teal-Navy (#294056) background with pure white text, comfortable padding (0.875rem vertical, 2rem horizontal)
|
|
61
|
-
- **Hover State:** Subtle darkening to deeper navy, smooth 250ms ease-in-out transition
|
|
62
|
-
- **Focus State:** Soft outer glow in the primary color for keyboard navigation accessibility
|
|
63
|
-
- **Secondary CTA (if needed):** Outlined style with Deep Muted Teal-Navy border, transparent background, hover fills with whisper-soft teal tint
|
|
64
|
-
|
|
65
|
-
### Cards & Product Containers
|
|
66
|
-
- **Corner Style:** Gently rounded corners (12px/0.75rem radius) creating soft, refined edges
|
|
67
|
-
- **Background:** Alternates between Warm Barely-There Cream and Crisp Very Light Gray based on layering needs
|
|
68
|
-
- **Shadow Strategy:** Flat by default. On hover, whisper-soft diffused shadow appears (`0 2px 8px rgba(0,0,0,0.06)`) creating subtle depth
|
|
69
|
-
- **Border:** Optional hairline border (1px) in Ultra-Soft Silver Gray for delicate definition when shadows aren't present
|
|
70
|
-
- **Internal Padding:** Generous 2-2.5rem creating comfortable breathing room for content
|
|
71
|
-
- **Image Treatment:** Full-bleed at the top of cards, square or 4:3 ratio, seamless edge-to-edge presentation
|
|
72
|
-
|
|
73
|
-
### Navigation
|
|
74
|
-
- **Style:** Clean horizontal layout with generous spacing (2-3rem) between menu items
|
|
75
|
-
- **Typography:** Medium weight (500), subtle uppercase, expanded letter-spacing (0.06em) for refined sophistication
|
|
76
|
-
- **Default State:** Charcoal Near-Black text
|
|
77
|
-
- **Active/Hover State:** Smooth 200ms color transition to Deep Muted Teal-Navy
|
|
78
|
-
- **Active Indicator:** Thin underline (2px) in Deep Muted Teal-Navy appearing below current section
|
|
79
|
-
- **Mobile:** Converts to elegant hamburger menu with sliding drawer
|
|
80
|
-
|
|
81
|
-
### Inputs & Forms
|
|
82
|
-
- **Stroke Style:** Refined 1px border in Soft Warm Gray
|
|
83
|
-
- **Background:** Warm Barely-There Cream with transition to Crisp Very Light Gray on focus
|
|
84
|
-
- **Corner Style:** Matching button roundness (8px/0.5rem) for visual consistency
|
|
85
|
-
- **Focus State:** Border color shifts to Deep Muted Teal-Navy with subtle outer glow
|
|
86
|
-
- **Padding:** Comfortable 0.875rem vertical, 1.25rem horizontal for touch-friendly targets
|
|
87
|
-
- **Placeholder Text:** Ultra-Soft Silver Gray, elegant and unobtrusive
|
|
88
|
-
|
|
89
|
-
### Product Cards (Specific Pattern)
|
|
90
|
-
- **Image Area:** Square (1:1) or landscape (4:3) ratio filling card width completely
|
|
91
|
-
- **Content Stack:** Product name (H3), brief descriptor, material/finish, price
|
|
92
|
-
- **Price Display:** Emphasized with semi-bold weight (600) in Charcoal Near-Black
|
|
93
|
-
- **Hover Behavior:** Gentle lift effect (translateY -4px) combined with enhanced shadow
|
|
94
|
-
- **Spacing:** Consistent 1.5rem internal padding below image
|
|
95
|
-
|
|
96
|
-
## 5. Layout Principles
|
|
97
|
-
|
|
98
|
-
### Grid & Structure
|
|
99
|
-
- **Max Content Width:** 1440px for optimal readability and visual balance on large displays
|
|
100
|
-
- **Grid System:** Responsive 12-column grid with fluid gutters (24px mobile, 32px desktop)
|
|
101
|
-
- **Product Grid:** 4 columns on large desktop, 3 on desktop, 2 on tablet, 1 on mobile
|
|
102
|
-
- **Breakpoints:**
|
|
103
|
-
- Mobile: <768px
|
|
104
|
-
- Tablet: 768-1024px
|
|
105
|
-
- Desktop: 1024-1440px
|
|
106
|
-
- Large Desktop: >1440px
|
|
107
|
-
|
|
108
|
-
### Whitespace Strategy (Critical to the Design)
|
|
109
|
-
- **Base Unit:** 8px for micro-spacing, 16px for component spacing
|
|
110
|
-
- **Vertical Rhythm:** Consistent 2rem (32px) base unit between related elements
|
|
111
|
-
- **Section Margins:** Generous 5-8rem (80-128px) between major sections creating dramatic breathing room
|
|
112
|
-
- **Edge Padding:** 1.5rem (24px) mobile, 3rem (48px) tablet/desktop for comfortable framing
|
|
113
|
-
- **Hero Sections:** Extra-generous top/bottom padding (8-12rem) for impactful presentation
|
|
114
|
-
|
|
115
|
-
### Alignment & Visual Balance
|
|
116
|
-
- **Text Alignment:** Left-aligned for body and navigation (optimal readability), centered for hero headlines and featured content
|
|
117
|
-
- **Image to Text Ratio:** Heavily weighted toward imagery (70-30 split) reinforcing photography-first philosophy
|
|
118
|
-
- **Asymmetric Balance:** Large hero images offset by compact, refined text blocks
|
|
119
|
-
- **Visual Weight Distribution:** Strategic use of whitespace to draw eyes to hero products and primary CTAs
|
|
120
|
-
- **Reading Flow:** Clear top-to-bottom, left-to-right pattern with intentional focal points
|
|
121
|
-
|
|
122
|
-
### Responsive Behavior & Touch
|
|
123
|
-
- **Mobile-First Foundation:** Core experience designed and perfected for smallest screens first
|
|
124
|
-
- **Progressive Enhancement:** Additional columns, imagery, and details added gracefully at larger breakpoints
|
|
125
|
-
- **Touch Targets:** Minimum 44x44px for all interactive elements (WCAG AAA compliant)
|
|
126
|
-
- **Image Optimization:** Responsive images with appropriate resolutions for each breakpoint, lazy-loading for performance
|
|
127
|
-
- **Collapsing Strategy:** Navigation collapses to hamburger, grid reduces columns, padding scales proportionally
|
|
128
|
-
|
|
129
|
-
## 6. Design System Notes for Stitch Generation
|
|
130
|
-
|
|
131
|
-
When creating new screens for this project using Stitch, reference these specific instructions:
|
|
132
|
-
|
|
133
|
-
### Language to Use
|
|
134
|
-
- **Atmosphere:** "Sophisticated minimalist sanctuary with gallery-like spaciousness"
|
|
135
|
-
- **Button Shapes:** "Subtly rounded corners" (not "rounded-md" or "8px")
|
|
136
|
-
- **Shadows:** "Whisper-soft diffused shadows on hover" (not "shadow-sm")
|
|
137
|
-
- **Spacing:** "Generous breathing room" and "expansive whitespace"
|
|
138
|
-
|
|
139
|
-
### Color References
|
|
140
|
-
Always use the descriptive names with hex codes:
|
|
141
|
-
- Primary CTA: "Deep Muted Teal-Navy (#294056)"
|
|
142
|
-
- Backgrounds: "Warm Barely-There Cream (#FCFAFA)" or "Crisp Very Light Gray (#F5F5F5)"
|
|
143
|
-
- Text: "Charcoal Near-Black (#2C2C2C)" or "Soft Warm Gray (#6B6B6B)"
|
|
144
|
-
|
|
145
|
-
### Component Prompts
|
|
146
|
-
- "Create a product card with gently rounded corners, full-bleed square product image, and whisper-soft shadow on hover"
|
|
147
|
-
- "Design a primary call-to-action button in Deep Muted Teal-Navy (#294056) with subtle rounded corners and comfortable padding"
|
|
148
|
-
- "Add a navigation bar with generous spacing between items, using medium-weight Manrope with subtle uppercase and expanded letter-spacing"
|
|
149
|
-
|
|
150
|
-
### Incremental Iteration
|
|
151
|
-
When refining existing screens:
|
|
152
|
-
1. Focus on ONE component at a time (e.g., "Update the product grid cards")
|
|
153
|
-
2. Be specific about what to change (e.g., "Increase the internal padding of product cards from 1.5rem to 2rem")
|
|
154
|
-
3. Reference this design system language consistently
|
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
# Stitch Build Loop Skill
|
|
2
|
-
|
|
3
|
-
Teaches agents to iteratively build websites using Stitch with an autonomous baton-passing loop pattern.
|
|
4
|
-
|
|
5
|
-
## Install
|
|
6
|
-
|
|
7
|
-
```bash
|
|
8
|
-
npx add-skill google-labs-code/stitch-skills --skill stitch-loop --global
|
|
9
|
-
```
|
|
10
|
-
|
|
11
|
-
## What It Does
|
|
12
|
-
|
|
13
|
-
Enables continuous, autonomous website development through a "baton" system:
|
|
14
|
-
|
|
15
|
-
1. Agent reads task from `next-prompt.md`
|
|
16
|
-
2. Generates page via Stitch MCP tools
|
|
17
|
-
3. Integrates into site structure
|
|
18
|
-
4. Writes next task to continue the loop
|
|
19
|
-
|
|
20
|
-
## Prerequisites
|
|
21
|
-
|
|
22
|
-
- Stitch MCP Server access
|
|
23
|
-
- A `DESIGN.md` file (generate with the `design-md` skill)
|
|
24
|
-
- A `SITE.md` file for project context
|
|
25
|
-
|
|
26
|
-
## Example Prompt
|
|
27
|
-
|
|
28
|
-
```text
|
|
29
|
-
Read my next-prompt.md and generate the page using Stitch, then prepare the next iteration.
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
## Skill Structure
|
|
33
|
-
|
|
34
|
-
```
|
|
35
|
-
stitch-loop/
|
|
36
|
-
├── SKILL.md — Core pattern instructions
|
|
37
|
-
├── README.md — This file
|
|
38
|
-
├── resources/
|
|
39
|
-
│ ├── baton-schema.md — Baton file format spec
|
|
40
|
-
│ └── site-template.md — SITE.md/DESIGN.md templates
|
|
41
|
-
└── examples/
|
|
42
|
-
├── next-prompt.md — Example baton
|
|
43
|
-
└── SITE.md — Example site constitution
|
|
44
|
-
```
|
|
45
|
-
|
|
46
|
-
## Works With
|
|
47
|
-
|
|
48
|
-
- **`design-md` skill**: Generate `DESIGN.md` from existing Stitch screens
|
|
49
|
-
- **CI/CD**: GitHub Actions can trigger new iterations on push
|
|
50
|
-
- **Agent chains**: Dispatch to other agents (Jules, etc.)
|
|
51
|
-
|
|
52
|
-
## Learn More
|
|
53
|
-
|
|
54
|
-
See [SKILL.md](./SKILL.md) for complete instructions.
|