@kood/claude-code 0.5.4 → 0.5.6

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.
Files changed (95) hide show
  1. package/dist/index.js +6 -2
  2. package/package.json +1 -1
  3. package/templates/.claude/agents/document-writer.md +2 -2
  4. package/templates/.claude/skills/docs-creator/SKILL.md +2 -2
  5. package/templates/.claude/skills/docs-refactor/SKILL.md +1 -1
  6. package/templates/.claude/skills/plan/SKILL.md +15 -15
  7. package/templates/.claude/skills/ralph/SKILL.md +425 -72
  8. package/templates/hono/CLAUDE.md +28 -28
  9. package/templates/hono/docs/architecture.md +24 -24
  10. package/templates/hono/docs/deployment/cloudflare.md +18 -18
  11. package/templates/hono/docs/deployment/docker.md +13 -13
  12. package/templates/hono/docs/deployment/index.md +19 -19
  13. package/templates/hono/docs/deployment/railway.md +32 -32
  14. package/templates/hono/docs/deployment/vercel.md +29 -29
  15. package/templates/hono/docs/guides/conventions.md +57 -57
  16. package/templates/hono/docs/guides/env-setup.md +47 -47
  17. package/templates/hono/docs/guides/getting-started.md +27 -27
  18. package/templates/hono/docs/library/hono/error-handling.md +11 -11
  19. package/templates/hono/docs/library/hono/index.md +4 -4
  20. package/templates/hono/docs/library/hono/middleware.md +18 -18
  21. package/templates/hono/docs/library/hono/rpc.md +7 -7
  22. package/templates/hono/docs/library/hono/validation.md +6 -6
  23. package/templates/hono/docs/library/prisma/cloudflare-d1.md +29 -29
  24. package/templates/hono/docs/library/prisma/config.md +16 -16
  25. package/templates/hono/docs/library/prisma/index.md +32 -32
  26. package/templates/hono/docs/library/t3-env/index.md +22 -22
  27. package/templates/hono/docs/library/zod/index.md +31 -31
  28. package/templates/nextjs/CLAUDE.md +54 -54
  29. package/templates/nextjs/docs/architecture.md +146 -146
  30. package/templates/nextjs/docs/design.md +183 -183
  31. package/templates/nextjs/docs/guides/conventions.md +86 -86
  32. package/templates/nextjs/docs/guides/getting-started.md +28 -28
  33. package/templates/nextjs/docs/guides/routes.md +32 -32
  34. package/templates/nextjs/docs/library/better-auth/index.md +70 -70
  35. package/templates/nextjs/docs/library/nextjs/app-router.md +43 -43
  36. package/templates/nextjs/docs/library/nextjs/caching.md +73 -73
  37. package/templates/nextjs/docs/library/nextjs/index.md +51 -51
  38. package/templates/nextjs/docs/library/nextjs/middleware.md +41 -41
  39. package/templates/nextjs/docs/library/nextjs/route-handlers.md +31 -31
  40. package/templates/nextjs/docs/library/nextjs/server-actions.md +34 -34
  41. package/templates/nextjs/docs/library/prisma/cloudflare-d1.md +20 -20
  42. package/templates/nextjs/docs/library/prisma/config.md +18 -18
  43. package/templates/nextjs/docs/library/prisma/crud.md +17 -17
  44. package/templates/nextjs/docs/library/prisma/index.md +18 -18
  45. package/templates/nextjs/docs/library/prisma/relations.md +16 -16
  46. package/templates/nextjs/docs/library/prisma/schema.md +23 -23
  47. package/templates/nextjs/docs/library/prisma/setup.md +6 -6
  48. package/templates/nextjs/docs/library/prisma/transactions.md +10 -10
  49. package/templates/nextjs/docs/library/tanstack-query/index.md +6 -6
  50. package/templates/nextjs/docs/library/tanstack-query/invalidation.md +20 -20
  51. package/templates/nextjs/docs/library/tanstack-query/optimistic-updates.md +4 -4
  52. package/templates/nextjs/docs/library/tanstack-query/use-mutation.md +15 -15
  53. package/templates/nextjs/docs/library/tanstack-query/use-query.md +22 -22
  54. package/templates/nextjs/docs/library/zod/complex-types.md +11 -11
  55. package/templates/nextjs/docs/library/zod/index.md +8 -8
  56. package/templates/nextjs/docs/library/zod/transforms.md +11 -11
  57. package/templates/nextjs/docs/library/zod/validation.md +9 -9
  58. package/templates/npx/CLAUDE.md +38 -38
  59. package/templates/npx/docs/library/commander/index.md +12 -12
  60. package/templates/npx/docs/library/fs-extra/index.md +9 -9
  61. package/templates/npx/docs/library/prompts/index.md +3 -3
  62. package/templates/npx/docs/references/patterns.md +12 -12
  63. package/templates/tanstack-start/CLAUDE.md +54 -54
  64. package/templates/tanstack-start/docs/architecture.md +128 -128
  65. package/templates/tanstack-start/docs/design.md +169 -169
  66. package/templates/tanstack-start/docs/guides/conventions.md +43 -43
  67. package/templates/tanstack-start/docs/guides/env-setup.md +35 -35
  68. package/templates/tanstack-start/docs/guides/getting-started.md +19 -19
  69. package/templates/tanstack-start/docs/guides/hooks.md +45 -45
  70. package/templates/tanstack-start/docs/guides/routes.md +54 -54
  71. package/templates/tanstack-start/docs/guides/services.md +45 -45
  72. package/templates/tanstack-start/docs/library/prisma/cloudflare-d1.md +19 -19
  73. package/templates/tanstack-start/docs/library/prisma/config.md +16 -16
  74. package/templates/tanstack-start/docs/library/prisma/crud.md +17 -17
  75. package/templates/tanstack-start/docs/library/prisma/relations.md +16 -16
  76. package/templates/tanstack-start/docs/library/prisma/schema.md +23 -23
  77. package/templates/tanstack-start/docs/library/prisma/setup.md +6 -6
  78. package/templates/tanstack-start/docs/library/prisma/transactions.md +10 -10
  79. package/templates/tanstack-start/docs/library/tanstack-query/invalidation.md +19 -19
  80. package/templates/tanstack-start/docs/library/tanstack-query/optimistic-updates.md +4 -4
  81. package/templates/tanstack-start/docs/library/tanstack-query/use-mutation.md +14 -14
  82. package/templates/tanstack-start/docs/library/tanstack-query/use-query.md +21 -21
  83. package/templates/tanstack-start/docs/library/tanstack-router/error-handling.md +9 -9
  84. package/templates/tanstack-start/docs/library/tanstack-router/hooks.md +11 -11
  85. package/templates/tanstack-start/docs/library/tanstack-router/navigation.md +17 -17
  86. package/templates/tanstack-start/docs/library/tanstack-router/route-context.md +5 -5
  87. package/templates/tanstack-start/docs/library/tanstack-router/search-params.md +10 -10
  88. package/templates/tanstack-start/docs/library/tanstack-start/auth-patterns.md +8 -8
  89. package/templates/tanstack-start/docs/library/tanstack-start/middleware.md +9 -9
  90. package/templates/tanstack-start/docs/library/tanstack-start/routing.md +6 -6
  91. package/templates/tanstack-start/docs/library/tanstack-start/server-functions.md +18 -18
  92. package/templates/tanstack-start/docs/library/tanstack-start/setup.md +4 -4
  93. package/templates/tanstack-start/docs/library/zod/complex-types.md +11 -11
  94. package/templates/tanstack-start/docs/library/zod/transforms.md +11 -11
  95. package/templates/tanstack-start/docs/library/zod/validation.md +9 -9
package/dist/index.js CHANGED
@@ -629,7 +629,11 @@ async function installExtras(templates, targetDir, flags, availability, force) {
629
629
  // src/shared/gitignore-manager.ts
630
630
  import fs6 from "fs-extra";
631
631
  import path8 from "path";
632
- var CLAUDE_GENERATED_FOLDERS = ["CLAUDE.md", "docs/", ".claude/"];
632
+ var CLAUDE_GENERATED_FOLDERS = [
633
+ ".claude/plan/",
634
+ ".claude/ralph/",
635
+ ".claude/refactor/"
636
+ ];
633
637
  async function updateGitignore(targetDir) {
634
638
  const gitignorePath = path8.join(targetDir, ".gitignore");
635
639
  const sectionComment = "# Claude Code generated files";
@@ -835,7 +839,7 @@ var init = async (options) => {
835
839
 
836
840
  // src/index.ts
837
841
  var program = new Command();
838
- program.name("claude-code").description("Claude Code documentation installer for projects").version("0.5.4");
842
+ program.name("claude-code").description("Claude Code documentation installer for projects").version("0.5.6");
839
843
  program.option(
840
844
  "-t, --template <names>",
841
845
  "template names (comma-separated: tanstack-start,hono)"
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kood/claude-code",
3
- "version": "0.5.4",
3
+ "version": "0.5.6",
4
4
  "description": "Claude Code documentation installer for projects",
5
5
  "type": "module",
6
6
  "bin": "./dist/index.js",
@@ -52,7 +52,7 @@ model: haiku
52
52
 
53
53
  <instructions>
54
54
  @path/to/common-rules.md
55
- @docs/library/[library]/index.md
55
+ @.claude/docs/library/[library]/index.md
56
56
  </instructions>
57
57
 
58
58
  <forbidden>
@@ -155,7 +155,7 @@ description: 한 줄 설명
155
155
 
156
156
  <instructions>
157
157
  @.claude/instructions/git-rules.md
158
- @docs/library/tanstack-start/index.md
158
+ @.claude/docs/library/tanstack-start/index.md
159
159
  </instructions>
160
160
 
161
161
  <forbidden>
@@ -151,7 +151,7 @@ Edit("docs/library/react-query/index.md", ...)
151
151
 
152
152
  <instructions>
153
153
  @path/to/common.md
154
- @docs/library/[lib]/index.md
154
+ @.claude/docs/library/[lib]/index.md
155
155
  </instructions>
156
156
 
157
157
  ---
@@ -276,7 +276,7 @@ argument-hint: <인자>
276
276
 
277
277
  <instructions>
278
278
  @.claude/instructions/git-rules.md
279
- @docs/library/tanstack-start/index.md
279
+ @.claude/docs/library/tanstack-start/index.md
280
280
  </instructions>
281
281
 
282
282
  ---
@@ -156,7 +156,7 @@ Git 커밋 시에는 반드시 다음 규칙을 따라야 합니다:
156
156
 
157
157
  <instructions>
158
158
  @.claude/instructions/git-rules.md
159
- @docs/library/tanstack-start/index.md
159
+ @.claude/docs/library/tanstack-start/index.md
160
160
  </instructions>
161
161
 
162
162
  ---
@@ -47,7 +47,7 @@ Task({
47
47
 
48
48
  - 2-3개 옵션 제시 (장단점, 영향 범위)
49
49
  - 추천안 및 근거
50
- - 선택 후 `.claude/plans/00.[기능명]/` 폴더에 여러 문서 자동 생성
50
+ - 선택 후 `.claude/plan/00.[기능명]/` 폴더에 여러 문서 자동 생성
51
51
  - OVERVIEW.md, OPTIONS.md, IMPLEMENTATION.md, RISKS.md, REFERENCES.md
52
52
 
53
53
  </when_to_use>
@@ -634,7 +634,7 @@ Task({
634
634
  `
635
635
  })
636
636
 
637
- // → 각 모듈별 .claude/plans/00.User_모듈/, 01.Payment_모듈/ 문서 생성
637
+ // → 각 모듈별 .claude/plan/00.User_모듈/, 01.Payment_모듈/ 문서 생성
638
638
  ```
639
639
 
640
640
  **예시 3: 실시간 기능 기술 조사 (조사 병렬)**
@@ -1047,10 +1047,10 @@ Task({
1047
1047
 
1048
1048
  ### 폴더 구조
1049
1049
 
1050
- 옵션 선택 후 `.claude/plans/00.[기능명]/` 폴더 생성:
1050
+ 옵션 선택 후 `.claude/plan/00.[기능명]/` 폴더 생성:
1051
1051
 
1052
1052
  ```
1053
- .claude/plans/00.실시간_알림/
1053
+ .claude/plan/00.실시간_알림/
1054
1054
  ├── OVERVIEW.md # 개요, 현재 상태, 선택된 옵션
1055
1055
  ├── OPTIONS.md # 모든 옵션 비교 분석 (장단점, 영향 범위)
1056
1056
  ├── IMPLEMENTATION.md # 구현 단계 상세 계획
@@ -1373,13 +1373,13 @@ Write({ file_path: "OPTIONS.md", ... }) // 대기...
1373
1373
 
1374
1374
  ## 계획 문서 병렬 생성
1375
1375
 
1376
- 사용자가 옵션을 선택하면 `.claude/plans/[기능명]-{timestamp}/` 폴더에 여러 문서를 **병렬로** 생성합니다.
1376
+ 사용자가 옵션을 선택하면 `.claude/plan/[기능명]-{timestamp}/` 폴더에 여러 문서를 **병렬로** 생성합니다.
1377
1377
 
1378
1378
  ### 병렬 생성 워크플로우
1379
1379
 
1380
1380
  ```text
1381
- 1. 넘버링 결정: ls .claude/plans/ → 다음 번호 자동 부여
1382
- 2. 폴더 생성: .claude/plans/00.[기능명]/
1381
+ 1. 넘버링 결정: ls .claude/plan/ → 다음 번호 자동 부여
1382
+ 2. 폴더 생성: .claude/plan/00.[기능명]/
1383
1383
  3. document-writer 에이전트 5개 병렬 호출
1384
1384
  - OVERVIEW.md (haiku)
1385
1385
  - OPTIONS.md (haiku)
@@ -1397,10 +1397,10 @@ Write({ file_path: "OPTIONS.md", ... }) // 대기...
1397
1397
  ```typescript
1398
1398
  // 옵션 선택 후 실행
1399
1399
  // 1. 넘버링 결정
1400
- Bash("ls .claude/plans/ | grep -E '^[0-9]+' | wc -l")
1400
+ Bash("ls .claude/plan/ | grep -E '^[0-9]+' | wc -l")
1401
1401
  const nextNumber = "00" // 결과 기반 계산
1402
1402
  const projectName = "실시간_알림"
1403
- const basePath = `.claude/plans/${nextNumber}.${projectName}`
1403
+ const basePath = `.claude/plan/${nextNumber}.${projectName}`
1404
1404
 
1405
1405
  // 2. 폴더 생성
1406
1406
  Bash(`mkdir -p ${basePath}`)
@@ -1498,7 +1498,7 @@ Task({
1498
1498
  // 문서 생성 완료 후 즉시 실행
1499
1499
  Skill({
1500
1500
  skill: 'execute',
1501
- args: `@.claude/plans/${nextNumber}.${projectName}/IMPLEMENTATION.md 1단계부터 구현`
1501
+ args: `@.claude/plan/${nextNumber}.${projectName}/IMPLEMENTATION.md 1단계부터 구현`
1502
1502
  })
1503
1503
  ```
1504
1504
 
@@ -1546,7 +1546,7 @@ Skill({
1546
1546
  3. planner agent 프로세스:
1547
1547
  - 인터뷰: 요구사항, 제약사항, 리스크 허용도 파악
1548
1548
  - 코드베이스 조사: Explore agent로 현재 구조 분석
1549
- - 계획 생성: .claude/plans/00.세션_인증/
1549
+ - 계획 생성: .claude/plan/00.세션_인증/
1550
1550
  - 5개 문서 병렬 생성 (OVERVIEW, OPTIONS, IMPLEMENTATION, RISKS, REFERENCES)
1551
1551
  - 사용자 확인 후 핸드오프
1552
1552
 
@@ -1584,7 +1584,7 @@ Skill({
1584
1584
  4. 사용자 선택: 1
1585
1585
 
1586
1586
  5. document-writer 에이전트 5개 병렬 호출로 문서 생성
1587
- - .claude/plans/00.실시간_알림/
1587
+ - .claude/plan/00.실시간_알림/
1588
1588
  ├── OVERVIEW.md
1589
1589
  ├── OPTIONS.md
1590
1590
  ├── IMPLEMENTATION.md
@@ -1621,7 +1621,7 @@ Skill({
1621
1621
  - 단점: 테스트 필요
1622
1622
 
1623
1623
  4. 사용자 선택 → document-writer 에이전트 병렬 호출로 계획 문서 생성
1624
- - .claude/plans/00.타입스크립트_전환/
1624
+ - .claude/plan/00.타입스크립트_전환/
1625
1625
 
1626
1626
  5. 구현 자동 시작:
1627
1627
  Skill({ skill: 'execute' })
@@ -1644,9 +1644,9 @@ Skill({
1644
1644
  ✅ 옵션 최소 2개, 권장 3개
1645
1645
  ✅ 각 옵션에 장단점 명시
1646
1646
  ✅ 영향 범위 및 예상 작업량 제시
1647
- ✅ 넘버링 자동 결정 (ls .claude/plans/)
1647
+ ✅ 넘버링 자동 결정 (ls .claude/plan/)
1648
1648
  ✅ document-writer 에이전트 병렬 호출로 문서 생성
1649
- ✅ .claude/plans/00.[기능명]/ 폴더 구조 사용 (한글 설명)
1649
+ ✅ .claude/plan/00.[기능명]/ 폴더 구조 사용 (한글 설명)
1650
1650
  ```
1651
1651
 
1652
1652
  절대 금지: