@k2works/claude-code-booster 6.3.0 → 6.4.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.
Files changed (293) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +61 -61
  3. package/bin/claude-code-booster +113 -113
  4. package/lib/assets/.claude/README.md +287 -287
  5. package/lib/assets/.claude/agents/xp-architect.md +250 -250
  6. package/lib/assets/.claude/agents/xp-executive.md +207 -207
  7. package/lib/assets/.claude/agents/xp-interaction-designer.md +239 -239
  8. package/lib/assets/.claude/agents/xp-product-manager.md +245 -245
  9. package/lib/assets/.claude/agents/xp-programmer.md +268 -268
  10. package/lib/assets/.claude/agents/xp-project-manager.md +229 -229
  11. package/lib/assets/.claude/agents/xp-technical-writer.md +224 -224
  12. package/lib/assets/.claude/agents/xp-tester.md +265 -265
  13. package/lib/assets/.claude/agents/xp-user-representative.md +204 -204
  14. package/lib/assets/.claude/scripts/generate-inception-deck.mjs +911 -911
  15. package/lib/assets/.claude/settings.json +11 -11
  16. package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +111 -111
  17. package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +83 -83
  18. package/lib/assets/.claude/skills/analyzing-business-architecture/SKILL.md +122 -122
  19. package/lib/assets/.claude/skills/analyzing-business-case/SKILL.md +148 -148
  20. package/lib/assets/.claude/skills/analyzing-business-strategy/SKILL.md +277 -277
  21. package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +77 -77
  22. package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +117 -117
  23. package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +84 -84
  24. package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +95 -95
  25. package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +95 -95
  26. package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +91 -91
  27. package/lib/assets/.claude/skills/analyzing-review/SKILL.md +174 -174
  28. package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +101 -101
  29. package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +89 -89
  30. package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +80 -80
  31. package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +72 -72
  32. package/lib/assets/.claude/skills/closing-iteration/SKILL.md +176 -176
  33. package/lib/assets/.claude/skills/creating-adr/SKILL.md +117 -117
  34. package/lib/assets/.claude/skills/creating-development-strategy/SKILL.md +151 -127
  35. package/lib/assets/.claude/skills/creating-iteration-report/SKILL.md +210 -210
  36. package/lib/assets/.claude/skills/creating-journal/SKILL.md +140 -140
  37. package/lib/assets/.claude/skills/creating-manual/SKILL.md +199 -199
  38. package/lib/assets/.claude/skills/creating-release-report/SKILL.md +161 -161
  39. package/lib/assets/.claude/skills/creating-slides/SKILL.md +86 -86
  40. package/lib/assets/.claude/skills/creating-slides/agents/openai.yaml +4 -4
  41. package/lib/assets/.claude/skills/creating-slides/references/manga-css.md +45 -45
  42. package/lib/assets/.claude/skills/creating-slides/scripts/slide_tools.py +239 -239
  43. package/lib/assets/.claude/skills/developing-backend/SKILL.md +100 -100
  44. package/lib/assets/.claude/skills/developing-frontend/SKILL.md +93 -93
  45. package/lib/assets/.claude/skills/developing-release/SKILL.md +120 -120
  46. package/lib/assets/.claude/skills/developing-review/SKILL.md +175 -175
  47. package/lib/assets/.claude/skills/developing-uiux-review/SKILL.md +207 -207
  48. package/lib/assets/.claude/skills/generating-bmc/SKILL.md +123 -123
  49. package/lib/assets/.claude/skills/generating-slides/SKILL.md +94 -94
  50. package/lib/assets/.claude/skills/git-commit/SKILL.md +81 -81
  51. package/lib/assets/.claude/skills/killing-processes/SKILL.md +44 -44
  52. package/lib/assets/.claude/skills/migrating-ai-dlc/evals/evals.json +59 -59
  53. package/lib/assets/.claude/skills/opening-iteration/SKILL.md +124 -124
  54. package/lib/assets/.claude/skills/operating-backup/SKILL.md +59 -59
  55. package/lib/assets/.claude/skills/operating-cicd/SKILL.md +54 -54
  56. package/lib/assets/.claude/skills/operating-deploy/SKILL.md +67 -67
  57. package/lib/assets/.claude/skills/operating-docs/SKILL.md +219 -219
  58. package/lib/assets/.claude/skills/operating-provision/SKILL.md +77 -77
  59. package/lib/assets/.claude/skills/operating-qt/SKILL.md +147 -147
  60. package/lib/assets/.claude/skills/operating-review/SKILL.md +171 -171
  61. package/lib/assets/.claude/skills/operating-script/SKILL.md +145 -145
  62. package/lib/assets/.claude/skills/operating-setup/SKILL.md +63 -63
  63. package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +110 -110
  64. package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +172 -172
  65. package/lib/assets/.claude/skills/orchestrating-operation/SKILL.md +161 -161
  66. package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +149 -149
  67. package/lib/assets/.claude/skills/planning-releases/SKILL.md +121 -121
  68. package/lib/assets/.claude/skills/practicing-getting-start-tdd/SKILL.md +262 -262
  69. package/lib/assets/.claude/skills/syncing-github-project/SKILL.md +151 -151
  70. package/lib/assets/.claude/skills/tracking-progress/SKILL.md +91 -91
  71. package/lib/assets/.claude/skills/validating-design/SKILL.md +130 -130
  72. package/lib/assets/.claude/skills/validating-iteration-plan/SKILL.md +238 -238
  73. package/lib/assets/.claude/skills/validating-operating-setup/SKILL.md +118 -118
  74. package/lib/assets/.devcontainer/devcontainer.json +37 -37
  75. package/lib/assets/.env.example +32 -32
  76. package/lib/assets/.gitattributes +4 -4
  77. package/lib/assets/.github/workflows/docker-publish.yml +77 -77
  78. package/lib/assets/.github/workflows/mkdocs.yml +39 -39
  79. package/lib/assets/AGENTS.md +102 -102
  80. package/lib/assets/README.md +304 -304
  81. package/lib/assets/docker-compose.yml +33 -33
  82. package/lib/assets/docs/adr/index.md +10 -10
  83. package/lib/assets/docs/article/index.md +2 -1
  84. package/lib/assets/docs/assets/css/extra.css +29 -29
  85. package/lib/assets/docs/assets/js/extra.js +48 -48
  86. package/lib/assets/docs/assets/js/mathjax.js +27 -27
  87. package/lib/assets/docs/design/index.md +44 -44
  88. package/lib/assets/docs/development/index.md +39 -39
  89. package/lib/assets/docs/index.md +1 -1
  90. package/lib/assets/docs/log.md +3 -0
  91. package/lib/assets/docs/operation/index.md +41 -41
  92. package/lib/assets/docs/reference/BDD/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211.md +766 -0
  93. package/lib/assets/docs/reference/CodexCLIMCP/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/351/226/213/347/231/272/343/203/225/343/203/255/343/203/274.md +555 -555
  94. package/lib/assets/docs/reference/CodexCLIMCP/343/202/265/343/203/274/343/203/220/343/203/274/350/250/255/345/256/232/346/211/213/351/240/206.md +351 -351
  95. package/lib/assets/docs/reference/Java/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +592 -592
  96. package/lib/assets/docs/reference/OKF/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211_V0.2.md +965 -965
  97. package/lib/assets/docs/reference/SonarQube/343/203/255/343/203/274/343/202/253/343/203/253/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +652 -652
  98. package/lib/assets/docs/reference/TypeScript/343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/346/247/213/347/257/211/343/202/254/343/202/244/343/203/211.md +476 -476
  99. package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +460 -460
  100. package/lib/assets/docs/reference/Vim/346/223/215/344/275/234/343/203/236/343/203/213/343/203/245/343/202/242/343/203/253.md +177 -177
  101. package/lib/assets/docs/reference/images/Ansoff.drawio.svg +3 -3
  102. package/lib/assets/docs/reference/images/BMC.drawio.svg +3 -3
  103. package/lib/assets/docs/reference/images/BrandBasicStrategy.drawio.svg +3 -3
  104. package/lib/assets/docs/reference/images/BrandCategorization.drawio.svg +3 -3
  105. package/lib/assets/docs/reference/images/BrandRecurutementStrategy.drawio.svg +3 -3
  106. package/lib/assets/docs/reference/images/BrandValue.drawio.svg +3 -3
  107. package/lib/assets/docs/reference/images/BusinessActivitiy.svg +3 -3
  108. package/lib/assets/docs/reference/images/HRM.drawio.svg +3 -3
  109. package/lib/assets/docs/reference/images/MarketingStructure.drawio.svg +3 -3
  110. package/lib/assets/docs/reference/images/OrganizationElemnts.svg +3 -3
  111. package/lib/assets/docs/reference/images/PPM.drawio.svg +3 -3
  112. package/lib/assets/docs/reference/images/PositioningMap.drawio.svg +3 -3
  113. package/lib/assets/docs/reference/images/ProductLayer.drawio.svg +3 -3
  114. package/lib/assets/docs/reference/images/ProductMix.drawio.svg +3 -3
  115. package/lib/assets/docs/reference/images/SWOT.drawio.svg +3 -3
  116. package/lib/assets/docs/reference/images/TargetMarket.drawio.svg +3 -3
  117. package/lib/assets/docs/reference/images/ThreeGenericStrategies.drawio.svg +3 -3
  118. package/lib/assets/docs/reference/images/VRIO.drawio.svg +3 -3
  119. package/lib/assets/docs/reference/images/ValueChain.drawio.svg +3 -3
  120. package/lib/assets/docs/reference/index.md +1 -0
  121. package/lib/assets/docs/reference//343/202/210/343/201/204/343/202/275/343/203/225/343/203/210/343/202/246/343/202/247/343/202/242/343/201/250/343/201/257.md +250 -250
  122. package/lib/assets/docs/reference//343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +2226 -2226
  123. package/lib/assets/docs/reference//343/202/244/343/203/263/343/203/225/343/203/251/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +1888 -1888
  124. package/lib/assets/docs/reference//343/202/250/343/202/257/343/202/271/343/203/210/343/203/252/343/203/274/343/203/240/343/203/227/343/203/255/343/202/260/343/203/251/343/203/237/343/203/263/343/202/260.md +549 -549
  125. package/lib/assets/docs/reference//343/202/263/343/203/274/343/203/207/343/202/243/343/203/263/343/202/260/343/201/250/343/203/206/343/202/271/343/203/210/343/202/254/343/202/244/343/203/211.md +715 -715
  126. package/lib/assets/docs/reference//343/203/206/343/202/271/343/203/210/346/210/246/347/225/245/343/202/254/343/202/244/343/203/211.md +1323 -1323
  127. package/lib/assets/docs/reference//343/203/207/343/203/274/343/202/277/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +321 -321
  128. package/lib/assets/docs/reference//343/203/211/343/203/241/343/202/244/343/203/263/343/203/242/343/203/207/343/203/253/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +609 -609
  129. package/lib/assets/docs/reference//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243/345/210/206/346/236/220/343/202/254/343/202/244/343/203/211.md +537 -537
  130. package/lib/assets/docs/reference//343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +699 -699
  131. package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/202/254/343/202/244/343/203/211.md +470 -470
  132. package/lib/assets/docs/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/203/273/343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/350/250/210/347/224/273/343/202/254/343/202/244/343/203/211.md +580 -580
  133. package/lib/assets/docs/reference//343/203/255/343/202/270/343/202/253/343/203/253/343/202/267/343/203/263/343/202/255/343/203/263/343/202/260.md +1376 -1376
  134. package/lib/assets/docs/reference//344/274/201/346/245/255/347/265/214/345/226/266/350/253/226.md +2647 -2647
  135. package/lib/assets/docs/reference//347/222/260/345/242/203/345/244/211/346/225/260/347/256/241/347/220/206/343/202/254/343/202/244/343/203/211.md +675 -675
  136. package/lib/assets/docs/reference//347/265/214/345/226/266/346/210/246/347/225/245/345/210/206/346/236/220/343/202/254/343/202/244/343/203/211.md +575 -575
  137. package/lib/assets/docs/reference//350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1258 -1258
  138. package/lib/assets/docs/reference//350/250/200/350/252/236/345/210/245/351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +527 -527
  139. package/lib/assets/docs/reference//351/201/213/345/226/266/347/256/241/347/220/206.md +1492 -1492
  140. package/lib/assets/docs/reference//351/201/213/347/224/250/343/202/271/343/202/257/343/203/252/343/203/227/343/203/210/344/275/234/346/210/220/343/202/254/343/202/244/343/203/211.md +430 -430
  141. package/lib/assets/docs/reference//351/201/213/347/224/250/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +402 -402
  142. package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +314 -314
  143. package/lib/assets/docs/reference//351/235/236/346/251/237/350/203/275/350/246/201/344/273/266/345/256/232/347/276/251/343/202/254/343/202/244/343/203/211.md +1246 -1246
  144. package/lib/assets/docs/requirements/index.md +17 -17
  145. package/lib/assets/docs/review/index.md +5 -5
  146. package/lib/assets/docs/strategy/index.md +17 -17
  147. package/lib/assets/docs/template/ADR.md +39 -39
  148. package/lib/assets/docs/template/AWS/343/202/271/343/203/206/343/203/274/343/202/270/343/203/263/343/202/260/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +1375 -1375
  149. package/lib/assets/docs/template/AWS/343/203/227/343/203/255/343/203/200/343/202/257/343/202/267/343/203/247/343/203/263/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +643 -643
  150. package/lib/assets/docs/template/README.md +59 -59
  151. package/lib/assets/docs/template/index.md +24 -24
  152. package/lib/assets/docs/template//343/201/276/343/201/232/343/201/223/343/202/214/343/202/222/350/252/255/343/202/202/343/201/206/343/203/252/343/202/271/343/203/210.md +21 -21
  153. package/lib/assets/docs/template//343/202/242/343/203/227/343/203/252/343/202/261/343/203/274/343/202/267/343/203/247/343/203/263/351/226/213/347/231/272/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +556 -556
  154. package/lib/assets/docs/template//343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md +68 -68
  155. package/lib/assets/docs/template//343/202/244/343/203/206/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/350/250/210/347/224/273.md +336 -336
  156. package/lib/assets/docs/template//343/202/244/343/203/263/343/202/273/343/203/227/343/202/267/343/203/247/343/203/263/343/203/207/343/203/203/343/202/255.md +22 -22
  157. package/lib/assets/docs/template//343/203/223/343/202/270/343/203/215/343/202/271/343/202/242/343/203/274/343/202/255/343/203/206/343/202/257/343/203/201/343/203/243.md +388 -388
  158. package/lib/assets/docs/template//343/203/252/343/203/252/343/203/274/343/202/271/345/256/214/344/272/206/345/240/261/345/221/212/346/233/270.md +284 -284
  159. package/lib/assets/docs/template//343/203/252/343/203/252/343/203/274/343/202/271/350/250/210/347/224/273.md +289 -289
  160. package/lib/assets/docs/template//344/272/213/344/276/213/345/210/206/346/236/220.md +522 -522
  161. package/lib/assets/docs/template//344/274/201/346/245/255/345/210/206/346/236/220.md +582 -582
  162. package/lib/assets/docs/template//345/256/214/345/205/250/345/275/242/345/274/217/343/201/256/343/203/246/343/203/274/343/202/271/343/202/261/343/203/274/343/202/271.md +69 -69
  163. package/lib/assets/docs/template//350/246/201/344/273/266/345/256/232/347/276/251.md +669 -669
  164. package/lib/assets/docs/template//350/250/255/350/250/210.md +183 -183
  165. package/lib/assets/docs/template//351/226/213/347/231/272/347/222/260/345/242/203/343/202/273/343/203/203/343/203/210/343/202/242/343/203/203/343/203/227/346/211/213/351/240/206/346/233/270.md +697 -697
  166. package/lib/assets/gulpfile.js +29 -29
  167. package/lib/assets/mkdocs.yml +147 -138
  168. package/lib/assets/ops/docker/sonarqube-local/docker-compose.yml +57 -57
  169. package/lib/assets/ops/scripts/journal.js +180 -180
  170. package/lib/assets/ops/scripts/mkdocs.js +82 -82
  171. package/lib/assets/ops/scripts/release.js +431 -431
  172. package/lib/assets/ops/scripts/sonar_local.js +726 -726
  173. package/lib/assets/ops/scripts/ssh.js +190 -190
  174. package/lib/assets/ops/scripts/vault.js +299 -299
  175. package/lib/assets/package-lock.json +1673 -1673
  176. package/lib/assets/package.json +45 -45
  177. package/lib/gulpfile.js +37 -37
  178. package/package.json +41 -41
  179. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/benchmark.json +0 -20
  180. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/benchmark.md +0 -13
  181. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/eval_metadata.json +0 -14
  182. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/grading.json +0 -39
  183. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/adr/001-db.md +0 -12
  184. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/adr/002-cache-strategy.md +0 -20
  185. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/adr/index.md +0 -4
  186. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/design/data-model.md +0 -12
  187. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/design/index.md +0 -3
  188. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/index.md +0 -10
  189. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/log.md +0 -7
  190. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/operation/deploy-old.md +0 -12
  191. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/operation/deploy.md +0 -12
  192. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/operation/index.md +0 -4
  193. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/reference/OKF/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211_V0.2.md +0 -965
  194. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/report.md +0 -76
  195. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/grading.json +0 -39
  196. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/adr/001-db.md +0 -12
  197. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/adr/002-cache-strategy.md +0 -20
  198. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/adr/index.md +0 -4
  199. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/design/data-model.md +0 -12
  200. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/design/index.md +0 -3
  201. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/index.md +0 -10
  202. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/log.md +0 -7
  203. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/operation/deploy-old.md +0 -12
  204. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/operation/deploy.md +0 -12
  205. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/operation/index.md +0 -4
  206. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/reference/OKF/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211_V0.2.md +0 -965
  207. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/report.md +0 -22
  208. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/eval_metadata.json +0 -13
  209. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/grading.json +0 -34
  210. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/adr/001-db.md +0 -12
  211. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/adr/002-cache-strategy.md +0 -11
  212. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/adr/index.md +0 -3
  213. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/design/data-model.md +0 -14
  214. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/design/index.md +0 -3
  215. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/index.md +0 -10
  216. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/log.md +0 -7
  217. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/operation/deploy-old.md +0 -12
  218. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/operation/deploy.md +0 -12
  219. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/operation/index.md +0 -4
  220. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/reference/OKF/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211_V0.2.md +0 -965
  221. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/report.md +0 -61
  222. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/grading.json +0 -34
  223. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/adr/001-db.md +0 -12
  224. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/adr/002-cache-strategy.md +0 -11
  225. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/adr/index.md +0 -3
  226. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/design/data-model.md +0 -13
  227. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/design/index.md +0 -3
  228. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/index.md +0 -10
  229. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/log.md +0 -7
  230. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/operation/deploy-old.md +0 -12
  231. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/operation/deploy.md +0 -12
  232. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/operation/index.md +0 -4
  233. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/reference/OKF/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211_V0.2.md +0 -965
  234. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/report.md +0 -18
  235. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/eval_metadata.json +0 -13
  236. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/grading.json +0 -34
  237. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/adr/001-db.md +0 -12
  238. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/adr/002-cache-strategy.md +0 -11
  239. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/adr/index.md +0 -3
  240. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/design/data-model.md +0 -12
  241. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/design/index.md +0 -3
  242. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/index.md +0 -10
  243. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/log.md +0 -7
  244. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/operation/deploy-old.md +0 -13
  245. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/operation/deploy.md +0 -12
  246. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/operation/index.md +0 -7
  247. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/reference/OKF/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211_V0.2.md +0 -965
  248. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/report.md +0 -83
  249. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/grading.json +0 -34
  250. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/adr/001-db.md +0 -12
  251. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/adr/002-cache-strategy.md +0 -11
  252. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/adr/index.md +0 -3
  253. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/design/data-model.md +0 -12
  254. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/design/index.md +0 -3
  255. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/index.md +0 -10
  256. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/log.md +0 -7
  257. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/operation/deploy-old.md +0 -14
  258. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/operation/deploy.md +0 -12
  259. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/operation/index.md +0 -4
  260. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/reference/OKF/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211_V0.2.md +0 -965
  261. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/report.md +0 -15
  262. package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/review.html +0 -1325
  263. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/benchmark.json +0 -20
  264. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/benchmark.md +0 -13
  265. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/eval_metadata.json +0 -15
  266. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/grading.json +0 -44
  267. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/docs_after/adr/index.md +0 -10
  268. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/docs_after/index.md +0 -15
  269. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/docs_after/log.md +0 -5
  270. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/docs_after/reference/OKF/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211_V0.2.md +0 -966
  271. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/docs_after/reference/index.md +0 -6
  272. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/docs_after/reference//343/202/210/343/201/204/343/202/275/343/203/225/343/203/210/343/202/246/343/202/247/343/202/242/343/201/250/343/201/257.md +0 -261
  273. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/docs_after/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/202/254/343/202/244/343/203/211.md +0 -480
  274. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/docs_after/reference//347/222/260/345/242/203/345/244/211/346/225/260/347/256/241/347/220/206/343/202/254/343/202/244/343/203/211.md +0 -681
  275. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/report.md +0 -85
  276. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/grading.json +0 -44
  277. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/adr/index.md +0 -8
  278. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/index.md +0 -11
  279. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/log.md +0 -7
  280. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/reference/OKF/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211_V0.2.md +0 -964
  281. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/reference/index.md +0 -9
  282. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/reference//343/202/210/343/201/204/343/202/275/343/203/225/343/203/210/343/202/246/343/202/247/343/202/242/343/201/250/343/201/257.md +0 -250
  283. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/reference//343/203/252/343/203/252/343/203/274/343/202/271/343/202/254/343/202/244/343/203/211.md +0 -469
  284. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/reference//347/222/260/345/242/203/345/244/211/346/225/260/347/256/241/347/220/206/343/202/254/343/202/244/343/203/211.md +0 -677
  285. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/report.md +0 -49
  286. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/eval_metadata.json +0 -13
  287. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/with_skill/grading.json +0 -34
  288. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/with_skill/outputs/knowledge_after/index.md +0 -7
  289. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/with_skill/outputs/knowledge_after/log.md +0 -7
  290. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/with_skill/outputs/knowledge_after/metrics/churn.md +0 -9
  291. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/with_skill/outputs/knowledge_after/metrics/income-statement.md +0 -15
  292. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/with_skill/outputs/report.md +0 -147
  293. package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/review.html +0 -1325
@@ -1,219 +1,219 @@
1
- ---
2
- name: operating-docs
3
- description: 設計ドキュメントの一覧表示、進捗確認、内容参照、インデックス更新、Markdown Lint を実行。ドキュメント管理や整備時に使用。
4
- ---
5
-
6
- # ドキュメント管理ガイド
7
-
8
- 設計ドキュメントの一覧表示、進捗確認、内容参照を行います。
9
-
10
- ## Instructions
11
-
12
- ### 1. オプション
13
-
14
- - なし : ドキュメント一覧と進捗状況を表示
15
- - `--list` : ドキュメント一覧のみを表示
16
- - `--status` : ドキュメントの作成状況を詳細表示
17
- - `--read <ファイル名>` : 指定したドキュメントの内容を表示
18
- - `--summary` : 全ドキュメントの概要を表示
19
- - `--update` : `docs/index.md` と `mkdocs.yml` を現在のドキュメント構成に合わせて更新
20
- - `--update-index` : `docs/index.md` のみを更新
21
- - `--update-mkdocs` : `mkdocs.yml` のみを更新
22
- - `--lint` : Markdown フォーマットをチェックし、違反を自動修正
23
-
24
- ### 2. 基本例
25
-
26
- ```bash
27
- # ドキュメント一覧と進捗確認
28
- # 「設計ドキュメントの一覧と作成状況を確認」
29
-
30
- # 特定ドキュメントの参照
31
- # --read tech_stack
32
- # 「技術スタック選定ドキュメントの内容を表示」
33
-
34
- # docs/index.md と mkdocs.yml を更新
35
- # --update
36
- # 「現在のドキュメント構成に合わせて両ファイルを更新」
37
-
38
- # Markdown フォーマットをチェック・修正
39
- # --lint
40
- # 「タスク項目の前に空行がないなどのフォーマット違反を検出し自動修正」
41
- ```
42
-
43
- ### 3. ドキュメント構成
44
-
45
- 本プロジェクトのドキュメントは以下の構成で管理されています:
46
-
47
- **要件定義ドキュメント** (`docs/requirements/`)
48
-
49
- - `requirements_definition.md` : 要件定義書(RDRA 2.0)
50
- - `business_usecase.md` : ビジネスユースケース
51
- - `system_usecase.md` : システムユースケース
52
- - `user_story.md` : ユーザーストーリー
53
-
54
- **設計ドキュメント** (`docs/design/`)
55
-
56
- - `architecture_backend.md` : バックエンドアーキテクチャ
57
- - `architecture_frontend.md` : フロントエンドアーキテクチャ
58
- - `architecture_infrastructure.md` : インフラストラクチャ
59
- - `data-model.md` : データモデル設計
60
- - `domain-model.md` : ドメインモデル設計
61
- - `ui-design.md` : UI 設計
62
- - `test_strategy.md` : テスト戦略
63
- - `non_functional.md` : 非機能要件
64
- - `operation.md` : 運用要件
65
- - `tech_stack.md` : 技術スタック選定
66
-
67
- ### 4. ドキュメント更新機能
68
-
69
- `--update` オプションを使用すると、現在のドキュメント構成に合わせて `docs/index.md` と `mkdocs.yml` と 各ディレクトリの `index.md` を自動更新できます。
70
-
71
- **docs/index.md の更新内容**:
72
-
73
- - ドキュメント一覧をカテゴリ別に整理
74
- - 各ドキュメントへのリンクと説明を生成
75
- - 「まずこれを読もうリスト」形式で構成
76
-
77
- **mkdocs.yml の更新内容**:
78
-
79
- - `nav` セクションを現在のドキュメント構成に合わせて更新
80
- - 要件定義、設計、開発、運用などのカテゴリで階層化
81
- - 新しいドキュメントを自動的にナビゲーションに追加
82
-
83
- **各ディレクトリの index.md の更新内容**:
84
-
85
- - ドキュメント一覧をカテゴリ別に整理
86
- - 各ドキュメントへのリンクと説明を生成
87
-
88
- ### 5. Lint 機能
89
-
90
- `--lint` オプションを使用すると、Markdown ドキュメントのフォーマットをチェックし、違反を自動修正できます。
91
-
92
- **チェックルール**:
93
-
94
- - タスク項目(リスト)の前には空行が必要
95
- - 番号付きリストのサブリスト前にも空行が必要
96
- - 番号付きリストのサブリストは 5 スペースインデント(3 スペースは NG)
97
- - コロンで終わる行の直後にリストがある場合も空行が必要
98
- - 太字ラベル(半角・全角コロン両方)の直後にリストがある場合も空行が必要
99
-
100
- **NG 例** - ラベルの直後にリスト:
101
-
102
- ```markdown
103
- **受入条件**:
104
- - [ ] ログアウトボタンをクリックするとログアウトできる
105
- ```
106
-
107
- **OK 例**:
108
-
109
- ```markdown
110
- **受入条件**:
111
-
112
- - [ ] ログアウトボタンをクリックするとログアウトできる
113
- ```
114
-
115
- **NG 例** - 番号付きリストの直後にサブリスト:
116
-
117
- ```markdown
118
- 1. **対処**: SMB バージョンを確認
119
- - コントロールパネル > ファイルサービス > SMB で設定
120
- ```
121
-
122
- **OK 例**:
123
-
124
- ```markdown
125
- 1. **対処**: SMB バージョンを確認
126
-
127
- - コントロールパネル > ファイルサービス > SMB で設定
128
- ```
129
-
130
- **NG 例** - 番号付きリストのサブリストのインデントが浅い:
131
-
132
- ```markdown
133
- 1. **データとしてのパターン**
134
-
135
- - すべてのパターンがデータ構造として表現される
136
- - パターン間の境界が明確
137
- ```
138
-
139
- **OK 例**:
140
-
141
- ```markdown
142
- 1. **データとしてのパターン**
143
-
144
- - すべてのパターンがデータ構造として表現される
145
- - パターン間の境界が明確
146
- ```
147
-
148
- **NG 例** - コロンで終わる行の直後にリスト:
149
-
150
- ```markdown
151
- PMD はカスタム設定で以下をチェック:
152
- - マジックナンバーの使用
153
- ```
154
-
155
- **OK 例**:
156
-
157
- ```markdown
158
- PMD はカスタム設定で以下をチェック:
159
-
160
- - マジックナンバーの使用
161
- ```
162
-
163
- **実行手順**:
164
-
165
- 1. `docs/` 配下の全 Markdown ファイルをスキャン
166
- 2. 上記ルールに違反する箇所を検出
167
- 3. 違反箇所を自動修正
168
- 4. 修正結果を報告
169
-
170
- ### 6. 出力例
171
-
172
- ```
173
- 設計ドキュメント一覧
174
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
175
-
176
- docs/requirements/
177
- ├─ requirements_definition.md (要件定義書)
178
- ├─ business_usecase.md (ビジネスユースケース)
179
- ├─ system_usecase.md (システムユースケース)
180
- └─ user_story.md (ユーザーストーリー)
181
-
182
- docs/design/
183
- ├─ architecture_backend.md (バックエンドアーキテクチャ)
184
- ├─ architecture_frontend.md (フロントエンドアーキテクチャ)
185
- ├─ data-model.md (データモデル設計)
186
- ├─ domain-model.md (ドメインモデル設計)
187
- ├─ ui-design.md (UI 設計)
188
- ├─ test_strategy.md (テスト戦略)
189
- ├─ non_functional.md (非機能要件)
190
- ├─ operation.md (運用要件)
191
- └─ tech_stack.md (技術スタック選定)
192
-
193
- 進捗: 14/14 ドキュメント完成 (100%)
194
- ```
195
-
196
- ### 7. 注意事項
197
-
198
- - **前提条件**: `docs/` ディレクトリが存在すること
199
- - **制限事項**: Markdown 形式のドキュメントのみ対応
200
- - **推奨事項**: 定期的にドキュメントの進捗を確認し、最新の状態を維持すること
201
- - **更新時の注意**: `--update` 実行前に現在の `docs/index.md` と `mkdocs.yml` をバックアップすることを推奨
202
- - **MkDocs 依存**: `--update-mkdocs` を使用する場合、MkDocs がインストールされている必要がある
203
-
204
- ### 8. ベストプラクティス
205
-
206
- 1. **定期確認**: 開発フェーズ移行前にドキュメントの完成度を確認する
207
- 2. **整合性維持**: コード変更時は関連ドキュメントも更新する
208
- 3. **レビュー活用**: チームレビュー前にドキュメント概要を共有する
209
- 4. **バージョン管理**: ドキュメントの変更は Git でコミットする
210
- 5. **インデックス同期**: 新しいドキュメント作成後は `--update` でインデックスを同期する
211
- 6. **プレビュー確認**: `--update-mkdocs` 後は `mkdocs serve` でナビゲーションを確認する
212
- 7. **フォーマット統一**: コミット前に `--lint` でフォーマットの一貫性を確保する
213
-
214
- ### 関連スキル
215
-
216
- - `orchestrating-analysis` : 分析フェーズ全体の作業支援
217
- - `analyzing-requirements` : 要件定義関連の作業支援
218
- - `analyzing-architecture` : アーキテクチャ設計支援
219
- - `tracking-progress` : プロジェクト全体の進捗確認
1
+ ---
2
+ name: operating-docs
3
+ description: 設計ドキュメントの一覧表示、進捗確認、内容参照、インデックス更新、Markdown Lint を実行。ドキュメント管理や整備時に使用。
4
+ ---
5
+
6
+ # ドキュメント管理ガイド
7
+
8
+ 設計ドキュメントの一覧表示、進捗確認、内容参照を行います。
9
+
10
+ ## Instructions
11
+
12
+ ### 1. オプション
13
+
14
+ - なし : ドキュメント一覧と進捗状況を表示
15
+ - `--list` : ドキュメント一覧のみを表示
16
+ - `--status` : ドキュメントの作成状況を詳細表示
17
+ - `--read <ファイル名>` : 指定したドキュメントの内容を表示
18
+ - `--summary` : 全ドキュメントの概要を表示
19
+ - `--update` : `docs/index.md` と `mkdocs.yml` を現在のドキュメント構成に合わせて更新
20
+ - `--update-index` : `docs/index.md` のみを更新
21
+ - `--update-mkdocs` : `mkdocs.yml` のみを更新
22
+ - `--lint` : Markdown フォーマットをチェックし、違反を自動修正
23
+
24
+ ### 2. 基本例
25
+
26
+ ```bash
27
+ # ドキュメント一覧と進捗確認
28
+ # 「設計ドキュメントの一覧と作成状況を確認」
29
+
30
+ # 特定ドキュメントの参照
31
+ # --read tech_stack
32
+ # 「技術スタック選定ドキュメントの内容を表示」
33
+
34
+ # docs/index.md と mkdocs.yml を更新
35
+ # --update
36
+ # 「現在のドキュメント構成に合わせて両ファイルを更新」
37
+
38
+ # Markdown フォーマットをチェック・修正
39
+ # --lint
40
+ # 「タスク項目の前に空行がないなどのフォーマット違反を検出し自動修正」
41
+ ```
42
+
43
+ ### 3. ドキュメント構成
44
+
45
+ 本プロジェクトのドキュメントは以下の構成で管理されています:
46
+
47
+ **要件定義ドキュメント** (`docs/requirements/`)
48
+
49
+ - `requirements_definition.md` : 要件定義書(RDRA 2.0)
50
+ - `business_usecase.md` : ビジネスユースケース
51
+ - `system_usecase.md` : システムユースケース
52
+ - `user_story.md` : ユーザーストーリー
53
+
54
+ **設計ドキュメント** (`docs/design/`)
55
+
56
+ - `architecture_backend.md` : バックエンドアーキテクチャ
57
+ - `architecture_frontend.md` : フロントエンドアーキテクチャ
58
+ - `architecture_infrastructure.md` : インフラストラクチャ
59
+ - `data-model.md` : データモデル設計
60
+ - `domain-model.md` : ドメインモデル設計
61
+ - `ui-design.md` : UI 設計
62
+ - `test_strategy.md` : テスト戦略
63
+ - `non_functional.md` : 非機能要件
64
+ - `operation.md` : 運用要件
65
+ - `tech_stack.md` : 技術スタック選定
66
+
67
+ ### 4. ドキュメント更新機能
68
+
69
+ `--update` オプションを使用すると、現在のドキュメント構成に合わせて `docs/index.md` と `mkdocs.yml` と 各ディレクトリの `index.md` を自動更新できます。
70
+
71
+ **docs/index.md の更新内容**:
72
+
73
+ - ドキュメント一覧をカテゴリ別に整理
74
+ - 各ドキュメントへのリンクと説明を生成
75
+ - 「まずこれを読もうリスト」形式で構成
76
+
77
+ **mkdocs.yml の更新内容**:
78
+
79
+ - `nav` セクションを現在のドキュメント構成に合わせて更新
80
+ - 要件定義、設計、開発、運用などのカテゴリで階層化
81
+ - 新しいドキュメントを自動的にナビゲーションに追加
82
+
83
+ **各ディレクトリの index.md の更新内容**:
84
+
85
+ - ドキュメント一覧をカテゴリ別に整理
86
+ - 各ドキュメントへのリンクと説明を生成
87
+
88
+ ### 5. Lint 機能
89
+
90
+ `--lint` オプションを使用すると、Markdown ドキュメントのフォーマットをチェックし、違反を自動修正できます。
91
+
92
+ **チェックルール**:
93
+
94
+ - タスク項目(リスト)の前には空行が必要
95
+ - 番号付きリストのサブリスト前にも空行が必要
96
+ - 番号付きリストのサブリストは 5 スペースインデント(3 スペースは NG)
97
+ - コロンで終わる行の直後にリストがある場合も空行が必要
98
+ - 太字ラベル(半角・全角コロン両方)の直後にリストがある場合も空行が必要
99
+
100
+ **NG 例** - ラベルの直後にリスト:
101
+
102
+ ```markdown
103
+ **受入条件**:
104
+ - [ ] ログアウトボタンをクリックするとログアウトできる
105
+ ```
106
+
107
+ **OK 例**:
108
+
109
+ ```markdown
110
+ **受入条件**:
111
+
112
+ - [ ] ログアウトボタンをクリックするとログアウトできる
113
+ ```
114
+
115
+ **NG 例** - 番号付きリストの直後にサブリスト:
116
+
117
+ ```markdown
118
+ 1. **対処**: SMB バージョンを確認
119
+ - コントロールパネル > ファイルサービス > SMB で設定
120
+ ```
121
+
122
+ **OK 例**:
123
+
124
+ ```markdown
125
+ 1. **対処**: SMB バージョンを確認
126
+
127
+ - コントロールパネル > ファイルサービス > SMB で設定
128
+ ```
129
+
130
+ **NG 例** - 番号付きリストのサブリストのインデントが浅い:
131
+
132
+ ```markdown
133
+ 1. **データとしてのパターン**
134
+
135
+ - すべてのパターンがデータ構造として表現される
136
+ - パターン間の境界が明確
137
+ ```
138
+
139
+ **OK 例**:
140
+
141
+ ```markdown
142
+ 1. **データとしてのパターン**
143
+
144
+ - すべてのパターンがデータ構造として表現される
145
+ - パターン間の境界が明確
146
+ ```
147
+
148
+ **NG 例** - コロンで終わる行の直後にリスト:
149
+
150
+ ```markdown
151
+ PMD はカスタム設定で以下をチェック:
152
+ - マジックナンバーの使用
153
+ ```
154
+
155
+ **OK 例**:
156
+
157
+ ```markdown
158
+ PMD はカスタム設定で以下をチェック:
159
+
160
+ - マジックナンバーの使用
161
+ ```
162
+
163
+ **実行手順**:
164
+
165
+ 1. `docs/` 配下の全 Markdown ファイルをスキャン
166
+ 2. 上記ルールに違反する箇所を検出
167
+ 3. 違反箇所を自動修正
168
+ 4. 修正結果を報告
169
+
170
+ ### 6. 出力例
171
+
172
+ ```
173
+ 設計ドキュメント一覧
174
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
175
+
176
+ docs/requirements/
177
+ ├─ requirements_definition.md (要件定義書)
178
+ ├─ business_usecase.md (ビジネスユースケース)
179
+ ├─ system_usecase.md (システムユースケース)
180
+ └─ user_story.md (ユーザーストーリー)
181
+
182
+ docs/design/
183
+ ├─ architecture_backend.md (バックエンドアーキテクチャ)
184
+ ├─ architecture_frontend.md (フロントエンドアーキテクチャ)
185
+ ├─ data-model.md (データモデル設計)
186
+ ├─ domain-model.md (ドメインモデル設計)
187
+ ├─ ui-design.md (UI 設計)
188
+ ├─ test_strategy.md (テスト戦略)
189
+ ├─ non_functional.md (非機能要件)
190
+ ├─ operation.md (運用要件)
191
+ └─ tech_stack.md (技術スタック選定)
192
+
193
+ 進捗: 14/14 ドキュメント完成 (100%)
194
+ ```
195
+
196
+ ### 7. 注意事項
197
+
198
+ - **前提条件**: `docs/` ディレクトリが存在すること
199
+ - **制限事項**: Markdown 形式のドキュメントのみ対応
200
+ - **推奨事項**: 定期的にドキュメントの進捗を確認し、最新の状態を維持すること
201
+ - **更新時の注意**: `--update` 実行前に現在の `docs/index.md` と `mkdocs.yml` をバックアップすることを推奨
202
+ - **MkDocs 依存**: `--update-mkdocs` を使用する場合、MkDocs がインストールされている必要がある
203
+
204
+ ### 8. ベストプラクティス
205
+
206
+ 1. **定期確認**: 開発フェーズ移行前にドキュメントの完成度を確認する
207
+ 2. **整合性維持**: コード変更時は関連ドキュメントも更新する
208
+ 3. **レビュー活用**: チームレビュー前にドキュメント概要を共有する
209
+ 4. **バージョン管理**: ドキュメントの変更は Git でコミットする
210
+ 5. **インデックス同期**: 新しいドキュメント作成後は `--update` でインデックスを同期する
211
+ 6. **プレビュー確認**: `--update-mkdocs` 後は `mkdocs serve` でナビゲーションを確認する
212
+ 7. **フォーマット統一**: コミット前に `--lint` でフォーマットの一貫性を確保する
213
+
214
+ ### 関連スキル
215
+
216
+ - `orchestrating-analysis` : 分析フェーズ全体の作業支援
217
+ - `analyzing-requirements` : 要件定義関連の作業支援
218
+ - `analyzing-architecture` : アーキテクチャ設計支援
219
+ - `tracking-progress` : プロジェクト全体の進捗確認
@@ -1,77 +1,77 @@
1
- ---
2
- name: operating-provision
3
- description: IaC(Terraform)によるインフラプロビジョニングを実行。S3 状態管理、VPC、RDS、ECR、ECS 等の AWS リソースを段階的に構築・管理。Terraform の init/plan/apply やインフラ構築時に使用。
4
- ---
5
-
6
- # インフラプロビジョニング
7
-
8
- IaC(Infrastructure as Code)により、ステージング・本番環境のインフラを構築・管理します。
9
-
10
- ## Instructions
11
-
12
- ### 1. Terraform ワークフロー
13
-
14
- ```
15
- インフラコード作成 → init → plan → apply → テスト → ドキュメント更新
16
- ```
17
-
18
- ```bash
19
- # 初期化
20
- terraform init --backend-config=backend.hcl
21
-
22
- # 変更確認
23
- terraform plan
24
-
25
- # 適用
26
- terraform apply
27
-
28
- # 廃棄
29
- terraform destroy
30
- ```
31
-
32
- aws-vault 使用時は `aws-vault exec <profile> --` プレフィックスを付与する。
33
-
34
- ### 2. プロビジョニング順序
35
-
36
- ステージング・本番環境では以下のリソースを段階的にプロビジョニングする。
37
-
38
- 1. **状態管理**: S3 バケット + DynamoDB(Terraform State)
39
- 2. **IAM**: OIDC 認証用 IAM ロール(GitHub Actions 連携)
40
- 3. **シークレット**: SSM パラメータストア(DB 認証情報)
41
- 4. **ネットワーク**: VPC・サブネット・NAT Gateway
42
- 5. **データストア**: RDS
43
- 6. **バックアップ**: AWS Backup
44
- 7. **レジストリ**: ECR リポジトリ
45
- 8. **コンピュート**: ECS(Fargate + ALB)
46
- 9. **管理**: Application Manager(リソースグループ)
47
- 10. **DNS**: Route 53・カスタムドメイン(任意)
48
- 11. **踏み台**: EC2 踏み台サーバー(任意)
49
-
50
- ### 3. Terraform ディレクトリ構成
51
-
52
- ```text
53
- ops/terraform/
54
- ├── live/
55
- │ ├── global/ # S3 状態管理、IAM ロール
56
- │ ├── stage/ # ステージング環境リソース
57
- │ └── prod/ # 本番環境リソース
58
- ├── modules/ # 再利用可能モジュール
59
- └── test/ # Terratest
60
- ```
61
-
62
- ### 4. 環境廃棄
63
-
64
- 廃棄は**構築時と逆の順序**で実行する。本番環境では `deletion_protection` を事前に `false` に変更する。
65
-
66
- ### 5. 注意事項
67
-
68
- - **状態管理が先**: S3 + DynamoDB は他の全リソースより先に作成
69
- - **IaC 優先**: 手作業を最小限に抑え、インフラをコードで管理
70
- - **テスト**: LocalStack(ローカル)、Terratest(単体・結合)で検証
71
- - **secret.tfvars**: Git 管理外にすること
72
-
73
- ### 関連スキル
74
-
75
- - `operating-setup` : 環境構築の段階的実行
76
- - `operating-cicd` : CI/CD パイプライン構築
77
- - `operating-deploy` : デプロイ実行
1
+ ---
2
+ name: operating-provision
3
+ description: IaC(Terraform)によるインフラプロビジョニングを実行。S3 状態管理、VPC、RDS、ECR、ECS 等の AWS リソースを段階的に構築・管理。Terraform の init/plan/apply やインフラ構築時に使用。
4
+ ---
5
+
6
+ # インフラプロビジョニング
7
+
8
+ IaC(Infrastructure as Code)により、ステージング・本番環境のインフラを構築・管理します。
9
+
10
+ ## Instructions
11
+
12
+ ### 1. Terraform ワークフロー
13
+
14
+ ```
15
+ インフラコード作成 → init → plan → apply → テスト → ドキュメント更新
16
+ ```
17
+
18
+ ```bash
19
+ # 初期化
20
+ terraform init --backend-config=backend.hcl
21
+
22
+ # 変更確認
23
+ terraform plan
24
+
25
+ # 適用
26
+ terraform apply
27
+
28
+ # 廃棄
29
+ terraform destroy
30
+ ```
31
+
32
+ aws-vault 使用時は `aws-vault exec <profile> --` プレフィックスを付与する。
33
+
34
+ ### 2. プロビジョニング順序
35
+
36
+ ステージング・本番環境では以下のリソースを段階的にプロビジョニングする。
37
+
38
+ 1. **状態管理**: S3 バケット + DynamoDB(Terraform State)
39
+ 2. **IAM**: OIDC 認証用 IAM ロール(GitHub Actions 連携)
40
+ 3. **シークレット**: SSM パラメータストア(DB 認証情報)
41
+ 4. **ネットワーク**: VPC・サブネット・NAT Gateway
42
+ 5. **データストア**: RDS
43
+ 6. **バックアップ**: AWS Backup
44
+ 7. **レジストリ**: ECR リポジトリ
45
+ 8. **コンピュート**: ECS(Fargate + ALB)
46
+ 9. **管理**: Application Manager(リソースグループ)
47
+ 10. **DNS**: Route 53・カスタムドメイン(任意)
48
+ 11. **踏み台**: EC2 踏み台サーバー(任意)
49
+
50
+ ### 3. Terraform ディレクトリ構成
51
+
52
+ ```text
53
+ ops/terraform/
54
+ ├── live/
55
+ │ ├── global/ # S3 状態管理、IAM ロール
56
+ │ ├── stage/ # ステージング環境リソース
57
+ │ └── prod/ # 本番環境リソース
58
+ ├── modules/ # 再利用可能モジュール
59
+ └── test/ # Terratest
60
+ ```
61
+
62
+ ### 4. 環境廃棄
63
+
64
+ 廃棄は**構築時と逆の順序**で実行する。本番環境では `deletion_protection` を事前に `false` に変更する。
65
+
66
+ ### 5. 注意事項
67
+
68
+ - **状態管理が先**: S3 + DynamoDB は他の全リソースより先に作成
69
+ - **IaC 優先**: 手作業を最小限に抑え、インフラをコードで管理
70
+ - **テスト**: LocalStack(ローカル)、Terratest(単体・結合)で検証
71
+ - **secret.tfvars**: Git 管理外にすること
72
+
73
+ ### 関連スキル
74
+
75
+ - `operating-setup` : 環境構築の段階的実行
76
+ - `operating-cicd` : CI/CD パイプライン構築
77
+ - `operating-deploy` : デプロイ実行