@k2works/claude-code-booster 6.4.0 → 6.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/LICENSE +21 -21
- package/README.md +61 -61
- package/bin/claude-code-booster +113 -113
- package/lib/assets/.claude/README.md +287 -287
- package/lib/assets/.claude/agents/xp-architect.md +250 -250
- package/lib/assets/.claude/agents/xp-executive.md +207 -207
- package/lib/assets/.claude/agents/xp-interaction-designer.md +239 -239
- package/lib/assets/.claude/agents/xp-product-manager.md +245 -245
- package/lib/assets/.claude/agents/xp-programmer.md +268 -268
- package/lib/assets/.claude/agents/xp-project-manager.md +229 -229
- package/lib/assets/.claude/agents/xp-technical-writer.md +224 -224
- package/lib/assets/.claude/agents/xp-tester.md +265 -265
- package/lib/assets/.claude/agents/xp-user-representative.md +204 -204
- package/lib/assets/.claude/scripts/generate-inception-deck.mjs +911 -911
- package/lib/assets/.claude/settings.json +11 -11
- package/lib/assets/.claude/skills/ai-agent-guidelines/SKILL.md +111 -111
- package/lib/assets/.claude/skills/analyzing-architecture/SKILL.md +83 -83
- package/lib/assets/.claude/skills/analyzing-business-architecture/SKILL.md +122 -122
- package/lib/assets/.claude/skills/analyzing-business-case/SKILL.md +148 -148
- package/lib/assets/.claude/skills/analyzing-business-strategy/SKILL.md +277 -277
- package/lib/assets/.claude/skills/analyzing-data-model/SKILL.md +77 -77
- package/lib/assets/.claude/skills/analyzing-domain-model/SKILL.md +117 -117
- package/lib/assets/.claude/skills/analyzing-inception-deck/SKILL.md +84 -84
- package/lib/assets/.claude/skills/analyzing-non-functional/SKILL.md +95 -95
- package/lib/assets/.claude/skills/analyzing-operation/SKILL.md +95 -95
- package/lib/assets/.claude/skills/analyzing-requirements/SKILL.md +91 -91
- package/lib/assets/.claude/skills/analyzing-review/SKILL.md +174 -174
- package/lib/assets/.claude/skills/analyzing-tech-stack/SKILL.md +101 -101
- package/lib/assets/.claude/skills/analyzing-test-strategy/SKILL.md +89 -89
- package/lib/assets/.claude/skills/analyzing-ui-design/SKILL.md +80 -80
- package/lib/assets/.claude/skills/analyzing-usecases/SKILL.md +72 -72
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/benchmark.json +20 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/benchmark.md +13 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/eval_metadata.json +14 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/grading.json +39 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/adr/001-db.md +12 -0
- 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 +20 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/adr/index.md +4 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/design/data-model.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/design/index.md +3 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/index.md +10 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/log.md +7 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/operation/deploy-old.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/operation/deploy.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/docs_after/operation/index.md +4 -0
- 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 +965 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/with_skill/outputs/report.md +76 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/grading.json +39 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/adr/001-db.md +12 -0
- 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 +20 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/adr/index.md +4 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/design/data-model.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/design/index.md +3 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/index.md +10 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/log.md +7 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/operation/deploy-old.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/operation/deploy.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/docs_after/operation/index.md +4 -0
- 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 +965 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-1-register-new-adr/without_skill/outputs/report.md +22 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/eval_metadata.json +13 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/grading.json +34 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/adr/001-db.md +12 -0
- 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 +11 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/adr/index.md +3 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/design/data-model.md +14 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/design/index.md +3 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/index.md +10 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/log.md +7 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/operation/deploy-old.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/operation/deploy.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/docs_after/operation/index.md +4 -0
- 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 +965 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/with_skill/outputs/report.md +61 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/grading.json +34 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/adr/001-db.md +12 -0
- 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 +11 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/adr/index.md +3 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/design/data-model.md +13 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/design/index.md +3 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/index.md +10 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/log.md +7 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/operation/deploy-old.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/operation/deploy.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/docs_after/operation/index.md +4 -0
- 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 +965 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-2-verify-reviewed-doc/without_skill/outputs/report.md +18 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/eval_metadata.json +13 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/grading.json +34 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/adr/001-db.md +12 -0
- 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 +11 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/adr/index.md +3 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/design/data-model.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/design/index.md +3 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/index.md +10 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/log.md +7 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/operation/deploy-old.md +13 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/operation/deploy.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/docs_after/operation/index.md +7 -0
- 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 +965 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/with_skill/outputs/report.md +83 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/grading.json +34 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/adr/001-db.md +12 -0
- 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 +11 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/adr/index.md +3 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/design/data-model.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/design/index.md +3 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/index.md +10 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/log.md +7 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/operation/deploy-old.md +14 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/operation/deploy.md +12 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/docs_after/operation/index.md +4 -0
- 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 +965 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/eval-3-deprecate-replaced-doc/without_skill/outputs/report.md +15 -0
- package/lib/assets/.claude/skills/apply-okf-workspace/iteration-1/review.html +1325 -0
- package/lib/assets/.claude/skills/closing-iteration/SKILL.md +176 -176
- package/lib/assets/.claude/skills/creating-adr/SKILL.md +117 -117
- package/lib/assets/.claude/skills/creating-development-strategy/SKILL.md +187 -151
- package/lib/assets/.claude/skills/creating-iteration-report/SKILL.md +210 -210
- package/lib/assets/.claude/skills/creating-journal/SKILL.md +140 -140
- package/lib/assets/.claude/skills/creating-manual/SKILL.md +199 -199
- package/lib/assets/.claude/skills/creating-release-report/SKILL.md +161 -161
- package/lib/assets/.claude/skills/creating-slides/SKILL.md +86 -86
- package/lib/assets/.claude/skills/creating-slides/agents/openai.yaml +4 -4
- package/lib/assets/.claude/skills/creating-slides/references/manga-css.md +45 -45
- package/lib/assets/.claude/skills/creating-slides/scripts/slide_tools.py +239 -239
- package/lib/assets/.claude/skills/developing-backend/SKILL.md +138 -100
- package/lib/assets/.claude/skills/developing-frontend/SKILL.md +131 -93
- package/lib/assets/.claude/skills/developing-release/SKILL.md +120 -120
- package/lib/assets/.claude/skills/developing-review/SKILL.md +175 -175
- package/lib/assets/.claude/skills/developing-uiux-review/SKILL.md +207 -207
- package/lib/assets/.claude/skills/generating-bmc/SKILL.md +123 -123
- package/lib/assets/.claude/skills/generating-slides/SKILL.md +94 -94
- package/lib/assets/.claude/skills/git-commit/SKILL.md +81 -81
- package/lib/assets/.claude/skills/killing-processes/SKILL.md +44 -44
- package/lib/assets/.claude/skills/migrating-ai-dlc/evals/evals.json +59 -59
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/benchmark.json +20 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/benchmark.md +13 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/eval_metadata.json +15 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/grading.json +44 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/docs_after/adr/index.md +10 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/docs_after/index.md +15 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/docs_after/log.md +5 -0
- 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 +966 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/docs_after/reference/index.md +6 -0
- 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 +261 -0
- 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 +480 -0
- 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 +681 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/with_skill/outputs/report.md +85 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/grading.json +44 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/adr/index.md +8 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/index.md +11 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/log.md +7 -0
- 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 +964 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/docs_after/reference/index.md +9 -0
- 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 +250 -0
- 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 +469 -0
- 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 +677 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-1-migrate-docs/without_skill/outputs/report.md +49 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/eval_metadata.json +13 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/with_skill/grading.json +34 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/with_skill/outputs/knowledge_after/index.md +7 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/with_skill/outputs/knowledge_after/log.md +7 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/with_skill/outputs/knowledge_after/metrics/churn.md +9 -0
- 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 +15 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/eval-2-upgrade-v01-to-v02/with_skill/outputs/report.md +147 -0
- package/lib/assets/.claude/skills/migrating-okf-workspace/iteration-1/review.html +1325 -0
- package/lib/assets/.claude/skills/opening-iteration/SKILL.md +124 -124
- package/lib/assets/.claude/skills/operating-backup/SKILL.md +59 -59
- package/lib/assets/.claude/skills/operating-cicd/SKILL.md +54 -54
- package/lib/assets/.claude/skills/operating-deploy/SKILL.md +67 -67
- package/lib/assets/.claude/skills/operating-docs/SKILL.md +219 -219
- package/lib/assets/.claude/skills/operating-provision/SKILL.md +77 -77
- package/lib/assets/.claude/skills/operating-qt/SKILL.md +147 -147
- package/lib/assets/.claude/skills/operating-review/SKILL.md +171 -171
- package/lib/assets/.claude/skills/operating-script/SKILL.md +145 -145
- package/lib/assets/.claude/skills/operating-setup/SKILL.md +63 -63
- package/lib/assets/.claude/skills/orchestrating-analysis/SKILL.md +110 -110
- package/lib/assets/.claude/skills/orchestrating-development/SKILL.md +208 -172
- package/lib/assets/.claude/skills/orchestrating-operation/SKILL.md +161 -161
- package/lib/assets/.claude/skills/orchestrating-project/SKILL.md +149 -149
- package/lib/assets/.claude/skills/planning-releases/SKILL.md +121 -121
- package/lib/assets/.claude/skills/practicing-getting-start-tdd/SKILL.md +262 -262
- package/lib/assets/.claude/skills/syncing-github-project/SKILL.md +151 -151
- package/lib/assets/.claude/skills/tracking-progress/SKILL.md +91 -91
- package/lib/assets/.claude/skills/validating-design/SKILL.md +130 -130
- package/lib/assets/.claude/skills/validating-iteration-plan/SKILL.md +238 -238
- package/lib/assets/.claude/skills/validating-operating-setup/SKILL.md +118 -118
- package/lib/assets/.devcontainer/devcontainer.json +37 -37
- package/lib/assets/.env.example +32 -32
- package/lib/assets/.gitattributes +4 -4
- package/lib/assets/.github/workflows/docker-publish.yml +77 -77
- package/lib/assets/.github/workflows/mkdocs.yml +39 -39
- package/lib/assets/AGENTS.md +102 -102
- package/lib/assets/README.md +304 -304
- package/lib/assets/docker-compose.yml +33 -33
- package/lib/assets/docs/adr/index.md +10 -10
- package/lib/assets/docs/article/index.md +8 -6
- package/lib/assets/docs/assets/css/extra.css +29 -29
- package/lib/assets/docs/assets/js/extra.js +48 -48
- package/lib/assets/docs/assets/js/mathjax.js +27 -27
- package/lib/assets/docs/design/index.md +44 -44
- package/lib/assets/docs/development/index.md +39 -39
- package/lib/assets/docs/index.md +37 -37
- package/lib/assets/docs/log.md +28 -28
- package/lib/assets/docs/operation/index.md +41 -41
- package/lib/assets/docs/reference/BDD/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211.md +766 -766
- 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
- 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
- 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
- package/lib/assets/docs/reference/LivingDocumentation/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211.md +400 -0
- 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
- 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
- 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
- package/lib/assets/docs/reference/UI/350/250/255/350/250/210/343/202/254/343/202/244/343/203/211.md +460 -460
- 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
- package/lib/assets/docs/reference/images/Ansoff.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BMC.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BrandBasicStrategy.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BrandCategorization.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BrandRecurutementStrategy.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BrandValue.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/BusinessActivitiy.svg +3 -3
- package/lib/assets/docs/reference/images/HRM.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/MarketingStructure.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/OrganizationElemnts.svg +3 -3
- package/lib/assets/docs/reference/images/PPM.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/PositioningMap.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/ProductLayer.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/ProductMix.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/SWOT.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/TargetMarket.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/ThreeGenericStrategies.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/VRIO.drawio.svg +3 -3
- package/lib/assets/docs/reference/images/ValueChain.drawio.svg +3 -3
- package/lib/assets/docs/reference/index.md +66 -62
- 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
- package/lib/assets/docs/reference//343/202/242/343/203/216/343/203/206/343/203/274/343/202/267/343/203/247/343/203/263/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211.md +268 -0
- 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
- 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
- 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
- package/lib/assets/docs/reference//343/202/254/343/202/244/343/203/211/343/203/204/343/202/242/343/203/274/343/203/273/343/202/265/343/202/244/343/203/210/343/202/267/343/203/274/343/202/244/343/203/263/343/202/260/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211.md +192 -0
- 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
- package/lib/assets/docs/reference//343/203/200/343/202/244/343/203/212/343/203/237/343/203/203/343/202/257/343/202/255/343/203/245/343/203/254/343/203/274/343/202/267/343/203/247/343/203/263/345/260/216/345/205/245/343/202/254/343/202/244/343/203/211.md +191 -0
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/lib/assets/docs/reference//344/274/201/346/245/255/347/265/214/345/226/266/350/253/226.md +2647 -2647
- 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
- 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
- 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
- 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
- package/lib/assets/docs/reference//351/201/213/345/226/266/347/256/241/347/220/206.md +1492 -1492
- 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
- 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
- package/lib/assets/docs/reference//351/226/213/347/231/272/343/202/254/343/202/244/343/203/211.md +314 -314
- 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
- package/lib/assets/docs/requirements/index.md +17 -17
- package/lib/assets/docs/review/index.md +5 -5
- package/lib/assets/docs/strategy/index.md +17 -17
- package/lib/assets/docs/template/ADR.md +39 -39
- 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
- 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
- package/lib/assets/docs/template/README.md +59 -59
- package/lib/assets/docs/template/index.md +24 -24
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/lib/assets/docs/template//344/272/213/344/276/213/345/210/206/346/236/220.md +522 -522
- package/lib/assets/docs/template//344/274/201/346/245/255/345/210/206/346/236/220.md +582 -582
- 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
- package/lib/assets/docs/template//350/246/201/344/273/266/345/256/232/347/276/251.md +669 -669
- package/lib/assets/docs/template//350/250/255/350/250/210.md +183 -183
- 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
- package/lib/assets/gulpfile.js +29 -29
- package/lib/assets/mkdocs.yml +151 -147
- package/lib/assets/ops/docker/sonarqube-local/docker-compose.yml +57 -57
- package/lib/assets/ops/scripts/journal.js +180 -180
- package/lib/assets/ops/scripts/mkdocs.js +82 -82
- package/lib/assets/ops/scripts/release.js +431 -431
- package/lib/assets/ops/scripts/sonar_local.js +726 -726
- package/lib/assets/ops/scripts/ssh.js +190 -190
- package/lib/assets/ops/scripts/vault.js +299 -299
- package/lib/assets/package-lock.json +1673 -1673
- package/lib/assets/package.json +45 -45
- package/lib/gulpfile.js +37 -37
- package/package.json +41 -41
|
@@ -1,124 +1,124 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: opening-iteration
|
|
3
|
-
description: イテレーション(IT)を開発着手できる状態まで準備する手順を順序立てて案内する。前イテレーションふりかえりの反映→計画作成→詳細整合性検証→横断整合性検証→GitHub 同期→ドキュメント同期の 6 ステップをチェックリストとして提示し、着手前に計画と設計の不整合を潰す。「イテレーションを始めたい」「IT3 の計画を作って開始準備したい」「次のイテレーションの準備をしたい」「イテレーションを立ち上げたい」「開発に入る前の計画と検証を一通りやりたい」といった場面で必ず発動する。前イテレーションのクローズ直後・「次の IT に進む」「新しいスプリントを始める」局面でも積極的に提案する。開始準備は計画作成だけで終わりがちだが、着手前の整合性検証を省くと BC 独立性違反・設計反映漏れがそのまま実装の手戻りになるため、検証と同期まで含めて標準化することで開発を安全に始められる状態を作る。
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# イテレーション開始準備
|
|
8
|
-
|
|
9
|
-
イテレーション(IT)の開発に着手する前に、計画を立て、上流設計・過去計画との整合を検証し、GitHub とドキュメントに反映するまでの立ち上げ作業を、順序立てて漏れなく実施する。
|
|
10
|
-
|
|
11
|
-
計画は複数の設計ドキュメントから情報を引用するため、作成しただけで着手すると不整合がそのまま実装の手戻りになる。特に「ドメイン層のクレート依存(BC 独立性)」「設計ドキュメントの反映漏れ」「前イテレーションのふりかえり Try の取りこぼし」は、計画段階では気づきにくく実装で初めて露見しやすい。本スキルは、着手前にこれらを潰すためのチェックリストとオーケストレーションを提供する。`closing-iteration`(締め)と対になる立ち上げ側のスキルである。
|
|
12
|
-
|
|
13
|
-
## 開始の前提
|
|
14
|
-
|
|
15
|
-
以下を確認してから着手する。揃っていなければ、まず前イテレーションのクローズ(`closing-iteration`)またはリリース計画(`planning-releases --release`)に戻る。
|
|
16
|
-
|
|
17
|
-
- 前イテレーションがクローズ済み(ふりかえり・完了報告書がある)。初回イテレーションの場合は不要
|
|
18
|
-
- `docs/development/release_plan.md` に対象イテレーションのスコープ(ストーリー・SP)が定義されている
|
|
19
|
-
- `docs/development/development_strategy.md` に対象イテレーションの局面(序盤/中盤/終盤)とアプローチが定義されている
|
|
20
|
-
|
|
21
|
-
## 開始準備フロー(6 ステップ)
|
|
22
|
-
|
|
23
|
-
順序には理由がある。前 IT の学びを計画に織り込み、計画を作ってから上流設計・過去計画と突き合わせ、整合が取れてから GitHub とインデックスに反映する。上から順に実施する。
|
|
24
|
-
|
|
25
|
-
### ステップ 1: 前イテレーションふりかえりの反映
|
|
26
|
-
|
|
27
|
-
前イテレーションの `docs/development/retrospective-(N-1).md` を読み、Try(改善アクション)・持ち越し事項・次イテレーション引き継ぎを確認する。
|
|
28
|
-
|
|
29
|
-
- これらは計画作成の**入力**になる。「受入基準をテストケースに 1:1 対応させる」「N+1 を SQL 絞り込みへ」「前 IT の未実装分を統合」といった Try を、次の計画のタスク・成功基準に具体的に落とし込む
|
|
30
|
-
- ふりかえりを読まずに計画を書くと、改善のループが切れて同じ問題を繰り返す。この反映こそが計画を「生きた文書」にする
|
|
31
|
-
|
|
32
|
-
### ステップ 2: イテレーション計画の作成(`planning-releases --iteration N`)
|
|
33
|
-
|
|
34
|
-
`docs/development/iteration_plan-N.md` を作成する。
|
|
35
|
-
|
|
36
|
-
- ゴール(1-2 行)・対象ストーリー(release_plan と一致)・受入条件・タスク分解(4-16 理想時間)・スケジュール・設計(対象スコープに絞った 4 図)・リスク・DoD を記述する
|
|
37
|
-
- **設計 4 図**(ドメインモデル図・状態遷移図・ER 図・画面遷移図)は当該 IT スコープに絞って掲載する。状態を持たない対象なら状態遷移図を、画面を伴わない IT なら画面遷移図を省略し、その旨を明記する
|
|
38
|
-
- 局面(開発戦略)に合ったアプローチ(序盤/終盤=アウトサイドイン、中盤=インサイドアウト)でタスクを並べる
|
|
39
|
-
- ステップ 1 の Try を「返済枠」や成功基準として明示的に組み込む
|
|
40
|
-
- **画面を伴う IT は、ユーザーマニュアル更新(`creating-manual`)をタスクと DoD に含める**。対象章・節と画面キャプチャの撮り直しまでを見積もりに入れる。クローズ時(`closing-iteration` ステップ 6.5)に初めて思い出すと、計画外の作業がイテレーション末に積み上がる。画面を伴わない IT ではその旨を明記して省く
|
|
41
|
-
|
|
42
|
-
### ステップ 3: 詳細整合性検証(`validating-iteration-plan`)
|
|
43
|
-
|
|
44
|
-
計画と上流設計ドキュメント(ユーザーストーリー・ドメインモデル・データモデル・UI 設計)をフィールド単位で突合する。
|
|
45
|
-
|
|
46
|
-
- ストーリー ID・受入基準・集約/値オブジェクト名・テーブル名/カラム/命名規約・URL パス・htmx/PRG パターンの一致を確認する
|
|
47
|
-
- **不整合は計画側を設計ドキュメントに合わせて修正する**(設計が正)。設計ドキュメント自体の欠落・先行実装が必要な要素は「注(設計への反映が必要)」として計画に明記し、当該 IT で反映する
|
|
48
|
-
- 前イテレーションのレビュー指摘(`docs/review/` の最新)が計画に反映されているかも確認する
|
|
49
|
-
|
|
50
|
-
### ステップ 4: 横断整合性検証(`validating-design`)
|
|
51
|
-
|
|
52
|
-
開発戦略・過去のイテレーション計画との横断整合を 3 軸で検証する。
|
|
53
|
-
|
|
54
|
-
- **軸 A(開発戦略)**: 局面・アプローチ・US 割当・段階実装方針の一致
|
|
55
|
-
- **軸 B(設計トピックカバレッジ)**: 新規ドメインサービス・enum の要素表への追加、ナビゲーション整合、4 図の掲載
|
|
56
|
-
- **軸 C(過去計画の連続性)**: 命名・BC 独立性パターン(コンテキスト固有型の踏襲)・共有カーネル再利用・認可/DIP パターン・前 IT 引き継ぎの反映
|
|
57
|
-
- ここで **BC 独立性違反(例: domain-A が domain-B に依存する設計)や前 IT の設計反映漏れ**を検知できる。これらはコンパイル不能や手戻りに直結するため、着手前の検出価値が高い
|
|
58
|
-
|
|
59
|
-
### ステップ 5: GitHub 同期(`syncing-github-project --sync`)
|
|
60
|
-
|
|
61
|
-
`release_plan.md` を正として GitHub に反映する。
|
|
62
|
-
|
|
63
|
-
- 対象ストーリーの Issue を確認(未作成なら作成)し、Project のイテレーションフィールドを対象 IT に割り当てる
|
|
64
|
-
- SP・マイルストーンが正しいか確認する
|
|
65
|
-
- Status は計画済み・未着手なら Todo のまま。開発着手時に In Progress へ更新する
|
|
66
|
-
|
|
67
|
-
### ステップ 6: ドキュメント同期(`operating-docs --update`)
|
|
68
|
-
|
|
69
|
-
ドキュメントインデックスに新しい計画を反映する。
|
|
70
|
-
|
|
71
|
-
- `docs/development/index.md`: イテレーション行を追加(状態「計画済み」)
|
|
72
|
-
- `docs/development/release_plan.md`: 該当イテレーションの概要リンクを有効化・進捗表の状態を「計画済み」に
|
|
73
|
-
- `mkdocs.yml`: イテレーション計画をナビゲーションに追加
|
|
74
|
-
- 追加行のインデントが既存ナビと一致しているか確認する
|
|
75
|
-
|
|
76
|
-
### ステップ 6.5: OKF 適用(`apply-okf`)
|
|
77
|
-
|
|
78
|
-
`docs/` が OKF バンドル(ルート `index.md` に `okf_version`)なら、このフローで作成・更新した文書に規約を適用する。
|
|
79
|
-
|
|
80
|
-
```bash
|
|
81
|
-
python .claude/skills/apply-okf/scripts/okf_apply.py apply docs --changed --by <agent>
|
|
82
|
-
gulp okf:check
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
- `iteration_plan-N.md` は新規なので `type: Plan`・`status: draft` で登録される。ステップ 3・4 の検証を通し、ユーザーが計画を承認したら `verify --by human:<id>` で `stable` に昇格させる(検証済みの計画だけが開発の根拠になる)
|
|
86
|
-
- ステップ 1 で更新した前イテレーションの文書は本文が変わっているので `generated` が更新される
|
|
87
|
-
- `gulp okf:check` が ERROR 0 であることを確認してからコミットする
|
|
88
|
-
|
|
89
|
-
## 開始準備完了チェックリスト
|
|
90
|
-
|
|
91
|
-
すべて満たしたらイテレーションは開発着手可能な状態とみなす。
|
|
92
|
-
|
|
93
|
-
- [ ] 前イテレーションふりかえりの Try・引き継ぎを計画に反映
|
|
94
|
-
- [ ] `iteration_plan-N.md` 作成(ゴール・ストーリー・タスク・設計 4 図・DoD)
|
|
95
|
-
- [ ] 画面を伴う IT なら、マニュアル更新タスクを計画・DoD に計上(伴わないなら明記して省略)
|
|
96
|
-
- [ ] `validating-iteration-plan` 実施・不整合を修正
|
|
97
|
-
- [ ] `validating-design` 実施・3 軸の不整合を修正(BC 独立性・設計反映漏れ含む)
|
|
98
|
-
- [ ] GitHub Issue 確認・Project イテレーション割当
|
|
99
|
-
- [ ] `docs/development/index.md` / `release_plan.md` / `mkdocs.yml` 同期
|
|
100
|
-
- [ ] OKF バンドルなら `apply-okf` 適用・計画承認後に `verify`・`gulp okf:check` ERROR 0
|
|
101
|
-
- [ ] 各ステップの成果を意味のある単位でコミット(`git-commit`)
|
|
102
|
-
|
|
103
|
-
これらが揃ったら、`orchestrating-development` で開発フェーズ(TDD サイクル)に進む。
|
|
104
|
-
|
|
105
|
-
## 注意事項
|
|
106
|
-
|
|
107
|
-
- **順序を守る**: 計画を作る前にふりかえりを読む(学びの反映)。GitHub に反映する前に検証を通す(不整合を GitHub に持ち込まない)
|
|
108
|
-
- **検証を省かない**: 開始準備は計画作成だけで満足しがちだが、`validating-iteration-plan` と `validating-design` こそが着手前の安全網。ここで潰す不整合(BC 独立性違反・設計反映漏れ)は、実装後に直すと数倍のコストになる
|
|
109
|
-
- **マニュアルは計画時に見積もる**: 画面を伴う IT でマニュアル更新をタスクに入れ忘れると、クローズ時に計画外の作業として現れ、締めが遅れるか更新自体が飛ばされる。計画段階で枠を取っておくことが実装とマニュアルの乖離を防ぐ
|
|
110
|
-
- **設計が正**: 検証で見つかった不整合は原則計画側を直す。設計ドキュメントの欠落は「注」で明記し当該 IT で反映する(実装と設計の同時反映が、先行乖離を防ぐ)
|
|
111
|
-
|
|
112
|
-
## 関連スキル
|
|
113
|
-
|
|
114
|
-
- `closing-iteration` — イテレーションの締め(本スキルと対になるクローズ側)
|
|
115
|
-
- `orchestrating-project` — 計画・進捗管理フェーズ全体のオーケストレーション(本スキルはその「イテレーション開始時」を詳細化したもの)
|
|
116
|
-
- `planning-releases` — イテレーション計画の作成(ステップ 2)
|
|
117
|
-
- `creating-manual` — ユーザーマニュアルの更新(ステップ 2 でタスク・DoD に計上する対象)
|
|
118
|
-
- `validating-iteration-plan` — 計画と上流設計のフィールド単位の詳細突合(ステップ 3)
|
|
119
|
-
- `validating-design` — 開発戦略・過去計画との横断整合検証(ステップ 4)
|
|
120
|
-
- `syncing-github-project` — GitHub 同期(ステップ 5)
|
|
121
|
-
- `operating-docs` — ドキュメントインデックス更新・Lint(ステップ 6)
|
|
122
|
-
- `apply-okf` — 計画への OKF 規約適用と承認後の `verify`(ステップ 6.5)
|
|
123
|
-
- `orchestrating-development` — 開始準備完了後の開発フェーズ
|
|
124
|
-
- `git-commit` — 各ステップ成果のコミット
|
|
1
|
+
---
|
|
2
|
+
name: opening-iteration
|
|
3
|
+
description: イテレーション(IT)を開発着手できる状態まで準備する手順を順序立てて案内する。前イテレーションふりかえりの反映→計画作成→詳細整合性検証→横断整合性検証→GitHub 同期→ドキュメント同期の 6 ステップをチェックリストとして提示し、着手前に計画と設計の不整合を潰す。「イテレーションを始めたい」「IT3 の計画を作って開始準備したい」「次のイテレーションの準備をしたい」「イテレーションを立ち上げたい」「開発に入る前の計画と検証を一通りやりたい」といった場面で必ず発動する。前イテレーションのクローズ直後・「次の IT に進む」「新しいスプリントを始める」局面でも積極的に提案する。開始準備は計画作成だけで終わりがちだが、着手前の整合性検証を省くと BC 独立性違反・設計反映漏れがそのまま実装の手戻りになるため、検証と同期まで含めて標準化することで開発を安全に始められる状態を作る。
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# イテレーション開始準備
|
|
8
|
+
|
|
9
|
+
イテレーション(IT)の開発に着手する前に、計画を立て、上流設計・過去計画との整合を検証し、GitHub とドキュメントに反映するまでの立ち上げ作業を、順序立てて漏れなく実施する。
|
|
10
|
+
|
|
11
|
+
計画は複数の設計ドキュメントから情報を引用するため、作成しただけで着手すると不整合がそのまま実装の手戻りになる。特に「ドメイン層のクレート依存(BC 独立性)」「設計ドキュメントの反映漏れ」「前イテレーションのふりかえり Try の取りこぼし」は、計画段階では気づきにくく実装で初めて露見しやすい。本スキルは、着手前にこれらを潰すためのチェックリストとオーケストレーションを提供する。`closing-iteration`(締め)と対になる立ち上げ側のスキルである。
|
|
12
|
+
|
|
13
|
+
## 開始の前提
|
|
14
|
+
|
|
15
|
+
以下を確認してから着手する。揃っていなければ、まず前イテレーションのクローズ(`closing-iteration`)またはリリース計画(`planning-releases --release`)に戻る。
|
|
16
|
+
|
|
17
|
+
- 前イテレーションがクローズ済み(ふりかえり・完了報告書がある)。初回イテレーションの場合は不要
|
|
18
|
+
- `docs/development/release_plan.md` に対象イテレーションのスコープ(ストーリー・SP)が定義されている
|
|
19
|
+
- `docs/development/development_strategy.md` に対象イテレーションの局面(序盤/中盤/終盤)とアプローチが定義されている
|
|
20
|
+
|
|
21
|
+
## 開始準備フロー(6 ステップ)
|
|
22
|
+
|
|
23
|
+
順序には理由がある。前 IT の学びを計画に織り込み、計画を作ってから上流設計・過去計画と突き合わせ、整合が取れてから GitHub とインデックスに反映する。上から順に実施する。
|
|
24
|
+
|
|
25
|
+
### ステップ 1: 前イテレーションふりかえりの反映
|
|
26
|
+
|
|
27
|
+
前イテレーションの `docs/development/retrospective-(N-1).md` を読み、Try(改善アクション)・持ち越し事項・次イテレーション引き継ぎを確認する。
|
|
28
|
+
|
|
29
|
+
- これらは計画作成の**入力**になる。「受入基準をテストケースに 1:1 対応させる」「N+1 を SQL 絞り込みへ」「前 IT の未実装分を統合」といった Try を、次の計画のタスク・成功基準に具体的に落とし込む
|
|
30
|
+
- ふりかえりを読まずに計画を書くと、改善のループが切れて同じ問題を繰り返す。この反映こそが計画を「生きた文書」にする
|
|
31
|
+
|
|
32
|
+
### ステップ 2: イテレーション計画の作成(`planning-releases --iteration N`)
|
|
33
|
+
|
|
34
|
+
`docs/development/iteration_plan-N.md` を作成する。
|
|
35
|
+
|
|
36
|
+
- ゴール(1-2 行)・対象ストーリー(release_plan と一致)・受入条件・タスク分解(4-16 理想時間)・スケジュール・設計(対象スコープに絞った 4 図)・リスク・DoD を記述する
|
|
37
|
+
- **設計 4 図**(ドメインモデル図・状態遷移図・ER 図・画面遷移図)は当該 IT スコープに絞って掲載する。状態を持たない対象なら状態遷移図を、画面を伴わない IT なら画面遷移図を省略し、その旨を明記する
|
|
38
|
+
- 局面(開発戦略)に合ったアプローチ(序盤/終盤=アウトサイドイン、中盤=インサイドアウト)でタスクを並べる
|
|
39
|
+
- ステップ 1 の Try を「返済枠」や成功基準として明示的に組み込む
|
|
40
|
+
- **画面を伴う IT は、ユーザーマニュアル更新(`creating-manual`)をタスクと DoD に含める**。対象章・節と画面キャプチャの撮り直しまでを見積もりに入れる。クローズ時(`closing-iteration` ステップ 6.5)に初めて思い出すと、計画外の作業がイテレーション末に積み上がる。画面を伴わない IT ではその旨を明記して省く
|
|
41
|
+
|
|
42
|
+
### ステップ 3: 詳細整合性検証(`validating-iteration-plan`)
|
|
43
|
+
|
|
44
|
+
計画と上流設計ドキュメント(ユーザーストーリー・ドメインモデル・データモデル・UI 設計)をフィールド単位で突合する。
|
|
45
|
+
|
|
46
|
+
- ストーリー ID・受入基準・集約/値オブジェクト名・テーブル名/カラム/命名規約・URL パス・htmx/PRG パターンの一致を確認する
|
|
47
|
+
- **不整合は計画側を設計ドキュメントに合わせて修正する**(設計が正)。設計ドキュメント自体の欠落・先行実装が必要な要素は「注(設計への反映が必要)」として計画に明記し、当該 IT で反映する
|
|
48
|
+
- 前イテレーションのレビュー指摘(`docs/review/` の最新)が計画に反映されているかも確認する
|
|
49
|
+
|
|
50
|
+
### ステップ 4: 横断整合性検証(`validating-design`)
|
|
51
|
+
|
|
52
|
+
開発戦略・過去のイテレーション計画との横断整合を 3 軸で検証する。
|
|
53
|
+
|
|
54
|
+
- **軸 A(開発戦略)**: 局面・アプローチ・US 割当・段階実装方針の一致
|
|
55
|
+
- **軸 B(設計トピックカバレッジ)**: 新規ドメインサービス・enum の要素表への追加、ナビゲーション整合、4 図の掲載
|
|
56
|
+
- **軸 C(過去計画の連続性)**: 命名・BC 独立性パターン(コンテキスト固有型の踏襲)・共有カーネル再利用・認可/DIP パターン・前 IT 引き継ぎの反映
|
|
57
|
+
- ここで **BC 独立性違反(例: domain-A が domain-B に依存する設計)や前 IT の設計反映漏れ**を検知できる。これらはコンパイル不能や手戻りに直結するため、着手前の検出価値が高い
|
|
58
|
+
|
|
59
|
+
### ステップ 5: GitHub 同期(`syncing-github-project --sync`)
|
|
60
|
+
|
|
61
|
+
`release_plan.md` を正として GitHub に反映する。
|
|
62
|
+
|
|
63
|
+
- 対象ストーリーの Issue を確認(未作成なら作成)し、Project のイテレーションフィールドを対象 IT に割り当てる
|
|
64
|
+
- SP・マイルストーンが正しいか確認する
|
|
65
|
+
- Status は計画済み・未着手なら Todo のまま。開発着手時に In Progress へ更新する
|
|
66
|
+
|
|
67
|
+
### ステップ 6: ドキュメント同期(`operating-docs --update`)
|
|
68
|
+
|
|
69
|
+
ドキュメントインデックスに新しい計画を反映する。
|
|
70
|
+
|
|
71
|
+
- `docs/development/index.md`: イテレーション行を追加(状態「計画済み」)
|
|
72
|
+
- `docs/development/release_plan.md`: 該当イテレーションの概要リンクを有効化・進捗表の状態を「計画済み」に
|
|
73
|
+
- `mkdocs.yml`: イテレーション計画をナビゲーションに追加
|
|
74
|
+
- 追加行のインデントが既存ナビと一致しているか確認する
|
|
75
|
+
|
|
76
|
+
### ステップ 6.5: OKF 適用(`apply-okf`)
|
|
77
|
+
|
|
78
|
+
`docs/` が OKF バンドル(ルート `index.md` に `okf_version`)なら、このフローで作成・更新した文書に規約を適用する。
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
python .claude/skills/apply-okf/scripts/okf_apply.py apply docs --changed --by <agent>
|
|
82
|
+
gulp okf:check
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
- `iteration_plan-N.md` は新規なので `type: Plan`・`status: draft` で登録される。ステップ 3・4 の検証を通し、ユーザーが計画を承認したら `verify --by human:<id>` で `stable` に昇格させる(検証済みの計画だけが開発の根拠になる)
|
|
86
|
+
- ステップ 1 で更新した前イテレーションの文書は本文が変わっているので `generated` が更新される
|
|
87
|
+
- `gulp okf:check` が ERROR 0 であることを確認してからコミットする
|
|
88
|
+
|
|
89
|
+
## 開始準備完了チェックリスト
|
|
90
|
+
|
|
91
|
+
すべて満たしたらイテレーションは開発着手可能な状態とみなす。
|
|
92
|
+
|
|
93
|
+
- [ ] 前イテレーションふりかえりの Try・引き継ぎを計画に反映
|
|
94
|
+
- [ ] `iteration_plan-N.md` 作成(ゴール・ストーリー・タスク・設計 4 図・DoD)
|
|
95
|
+
- [ ] 画面を伴う IT なら、マニュアル更新タスクを計画・DoD に計上(伴わないなら明記して省略)
|
|
96
|
+
- [ ] `validating-iteration-plan` 実施・不整合を修正
|
|
97
|
+
- [ ] `validating-design` 実施・3 軸の不整合を修正(BC 独立性・設計反映漏れ含む)
|
|
98
|
+
- [ ] GitHub Issue 確認・Project イテレーション割当
|
|
99
|
+
- [ ] `docs/development/index.md` / `release_plan.md` / `mkdocs.yml` 同期
|
|
100
|
+
- [ ] OKF バンドルなら `apply-okf` 適用・計画承認後に `verify`・`gulp okf:check` ERROR 0
|
|
101
|
+
- [ ] 各ステップの成果を意味のある単位でコミット(`git-commit`)
|
|
102
|
+
|
|
103
|
+
これらが揃ったら、`orchestrating-development` で開発フェーズ(TDD サイクル)に進む。
|
|
104
|
+
|
|
105
|
+
## 注意事項
|
|
106
|
+
|
|
107
|
+
- **順序を守る**: 計画を作る前にふりかえりを読む(学びの反映)。GitHub に反映する前に検証を通す(不整合を GitHub に持ち込まない)
|
|
108
|
+
- **検証を省かない**: 開始準備は計画作成だけで満足しがちだが、`validating-iteration-plan` と `validating-design` こそが着手前の安全網。ここで潰す不整合(BC 独立性違反・設計反映漏れ)は、実装後に直すと数倍のコストになる
|
|
109
|
+
- **マニュアルは計画時に見積もる**: 画面を伴う IT でマニュアル更新をタスクに入れ忘れると、クローズ時に計画外の作業として現れ、締めが遅れるか更新自体が飛ばされる。計画段階で枠を取っておくことが実装とマニュアルの乖離を防ぐ
|
|
110
|
+
- **設計が正**: 検証で見つかった不整合は原則計画側を直す。設計ドキュメントの欠落は「注」で明記し当該 IT で反映する(実装と設計の同時反映が、先行乖離を防ぐ)
|
|
111
|
+
|
|
112
|
+
## 関連スキル
|
|
113
|
+
|
|
114
|
+
- `closing-iteration` — イテレーションの締め(本スキルと対になるクローズ側)
|
|
115
|
+
- `orchestrating-project` — 計画・進捗管理フェーズ全体のオーケストレーション(本スキルはその「イテレーション開始時」を詳細化したもの)
|
|
116
|
+
- `planning-releases` — イテレーション計画の作成(ステップ 2)
|
|
117
|
+
- `creating-manual` — ユーザーマニュアルの更新(ステップ 2 でタスク・DoD に計上する対象)
|
|
118
|
+
- `validating-iteration-plan` — 計画と上流設計のフィールド単位の詳細突合(ステップ 3)
|
|
119
|
+
- `validating-design` — 開発戦略・過去計画との横断整合検証(ステップ 4)
|
|
120
|
+
- `syncing-github-project` — GitHub 同期(ステップ 5)
|
|
121
|
+
- `operating-docs` — ドキュメントインデックス更新・Lint(ステップ 6)
|
|
122
|
+
- `apply-okf` — 計画への OKF 規約適用と承認後の `verify`(ステップ 6.5)
|
|
123
|
+
- `orchestrating-development` — 開始準備完了後の開発フェーズ
|
|
124
|
+
- `git-commit` — 各ステップ成果のコミット
|
|
@@ -1,59 +1,59 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: operating-backup
|
|
3
|
-
description: データベースのバックアップ・リストアを実行。AWS Backup による自動バックアップ、SSH トンネル経由の手動バックアップ、スナップショットからのリストア。バックアップやリストア、データ復旧時に使用。
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# バックアップ・リストア
|
|
7
|
-
|
|
8
|
-
データベースのバックアップ・リストアを実行します。
|
|
9
|
-
|
|
10
|
-
## Instructions
|
|
11
|
-
|
|
12
|
-
### 1. AWS Backup(自動バックアップ)
|
|
13
|
-
|
|
14
|
-
`Backup = "true"` タグが付与された RDS インスタンスに対して日次・週次でスナップショットを自動取得する。
|
|
15
|
-
|
|
16
|
-
| ルール | スケジュール | 保持期間 |
|
|
17
|
-
|--------|-------------|---------|
|
|
18
|
-
| daily | 毎日 JST 0:00 | 7 日 |
|
|
19
|
-
| weekly | 毎週日曜 JST 0:00 | 35 日 |
|
|
20
|
-
|
|
21
|
-
### 2. 手動バックアップ(SSH トンネル経由)
|
|
22
|
-
|
|
23
|
-
踏み台サーバー経由で RDS に接続し、スキーマ単位のバックアップを実行する。
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
# SSH トンネルを確立
|
|
27
|
-
ssh -L 5432:<RDS エンドポイント>:5432 ec2-user@<踏み台 IP> -i <キーペア>.pem
|
|
28
|
-
|
|
29
|
-
# スキーマ単位でバックアップ
|
|
30
|
-
PGPASSWORD=<パスワード> pg_dump -h 127.0.0.1 -p 5432 -U <ユーザー名> -d <DB 名> -n <スキーマ名> -Fc -f <スキーマ名>_backup.dump
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
### 3. リストア
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
# pg_restore によるリストア
|
|
37
|
-
PGPASSWORD=<パスワード> pg_restore -h 127.0.0.1 -p 5432 -U <ユーザー名> -d <DB 名> --clean --if-exists <ダンプファイル>
|
|
38
|
-
```
|
|
39
|
-
|
|
40
|
-
### 4. AWS Backup からのリストア
|
|
41
|
-
|
|
42
|
-
1. AWS コンソール → AWS Backup → バックアップボールト → リカバリポイントを選択
|
|
43
|
-
2. 「復元」をクリック → リストア先の DB インスタンス識別子を指定
|
|
44
|
-
3. リストア完了後、アプリケーションの接続先を切り替え
|
|
45
|
-
|
|
46
|
-
> **注意**: AWS Backup からのリストアは新しい RDS インスタンスとして作成されます。
|
|
47
|
-
|
|
48
|
-
### 5. 基本例
|
|
49
|
-
|
|
50
|
-
```bash
|
|
51
|
-
# 「データベースをバックアップして」
|
|
52
|
-
# 「SMS スキーマをバックアップして」
|
|
53
|
-
# 「バックアップからリストアして」
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
### 関連スキル
|
|
57
|
-
|
|
58
|
-
- `operating-deploy` : デプロイ前のバックアップ確認
|
|
59
|
-
- `operating-provision` : AWS Backup リソースのプロビジョニング
|
|
1
|
+
---
|
|
2
|
+
name: operating-backup
|
|
3
|
+
description: データベースのバックアップ・リストアを実行。AWS Backup による自動バックアップ、SSH トンネル経由の手動バックアップ、スナップショットからのリストア。バックアップやリストア、データ復旧時に使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# バックアップ・リストア
|
|
7
|
+
|
|
8
|
+
データベースのバックアップ・リストアを実行します。
|
|
9
|
+
|
|
10
|
+
## Instructions
|
|
11
|
+
|
|
12
|
+
### 1. AWS Backup(自動バックアップ)
|
|
13
|
+
|
|
14
|
+
`Backup = "true"` タグが付与された RDS インスタンスに対して日次・週次でスナップショットを自動取得する。
|
|
15
|
+
|
|
16
|
+
| ルール | スケジュール | 保持期間 |
|
|
17
|
+
|--------|-------------|---------|
|
|
18
|
+
| daily | 毎日 JST 0:00 | 7 日 |
|
|
19
|
+
| weekly | 毎週日曜 JST 0:00 | 35 日 |
|
|
20
|
+
|
|
21
|
+
### 2. 手動バックアップ(SSH トンネル経由)
|
|
22
|
+
|
|
23
|
+
踏み台サーバー経由で RDS に接続し、スキーマ単位のバックアップを実行する。
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
# SSH トンネルを確立
|
|
27
|
+
ssh -L 5432:<RDS エンドポイント>:5432 ec2-user@<踏み台 IP> -i <キーペア>.pem
|
|
28
|
+
|
|
29
|
+
# スキーマ単位でバックアップ
|
|
30
|
+
PGPASSWORD=<パスワード> pg_dump -h 127.0.0.1 -p 5432 -U <ユーザー名> -d <DB 名> -n <スキーマ名> -Fc -f <スキーマ名>_backup.dump
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
### 3. リストア
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
# pg_restore によるリストア
|
|
37
|
+
PGPASSWORD=<パスワード> pg_restore -h 127.0.0.1 -p 5432 -U <ユーザー名> -d <DB 名> --clean --if-exists <ダンプファイル>
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
### 4. AWS Backup からのリストア
|
|
41
|
+
|
|
42
|
+
1. AWS コンソール → AWS Backup → バックアップボールト → リカバリポイントを選択
|
|
43
|
+
2. 「復元」をクリック → リストア先の DB インスタンス識別子を指定
|
|
44
|
+
3. リストア完了後、アプリケーションの接続先を切り替え
|
|
45
|
+
|
|
46
|
+
> **注意**: AWS Backup からのリストアは新しい RDS インスタンスとして作成されます。
|
|
47
|
+
|
|
48
|
+
### 5. 基本例
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
# 「データベースをバックアップして」
|
|
52
|
+
# 「SMS スキーマをバックアップして」
|
|
53
|
+
# 「バックアップからリストアして」
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### 関連スキル
|
|
57
|
+
|
|
58
|
+
- `operating-deploy` : デプロイ前のバックアップ確認
|
|
59
|
+
- `operating-provision` : AWS Backup リソースのプロビジョニング
|
|
@@ -1,54 +1,54 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: operating-cicd
|
|
3
|
-
description: CI/CD パイプラインを構築。CI(Lint・テスト・ビルド・セキュリティスキャン)と CD(環境別デプロイ・OIDC 認証)の設計・実装。CI/CD パイプラインの構築やデプロイ自動化の設定時に使用。
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# CI/CD パイプライン構築
|
|
7
|
-
|
|
8
|
-
継続的インテグレーション・デプロイのパイプラインを構築します。
|
|
9
|
-
|
|
10
|
-
## Instructions
|
|
11
|
-
|
|
12
|
-
### 1. CI パイプライン
|
|
13
|
-
|
|
14
|
-
ビルド・テスト・品質チェックを自動化する。
|
|
15
|
-
|
|
16
|
-
| 段階 | 内容 | 目的 |
|
|
17
|
-
|------|------|------|
|
|
18
|
-
| ソースチェックアウト | リポジトリのコード取得 | 最新コードの取得 |
|
|
19
|
-
| 依存関係インストール | パッケージのインストール | ビルド環境の準備 |
|
|
20
|
-
| 静的解析 | Lint、型チェック | コード品質の担保 |
|
|
21
|
-
| テスト | 単体・統合テストの実行 | 機能の正しさの検証 |
|
|
22
|
-
| ビルド | アプリケーションのビルド | デプロイ可能な成果物の生成 |
|
|
23
|
-
| セキュリティスキャン | 依存関係の脆弱性チェック | セキュリティリスクの排除 |
|
|
24
|
-
|
|
25
|
-
### 2. CD パイプライン
|
|
26
|
-
|
|
27
|
-
環境別のデプロイを自動化する。
|
|
28
|
-
|
|
29
|
-
| 環境 | トリガー | 方式 | 承認 |
|
|
30
|
-
|------|---------|------|------|
|
|
31
|
-
| Development | `develop` ブランチ push | 即座デプロイ | 不要 |
|
|
32
|
-
| Staging | `main` ブランチ push | 自動デプロイ | 不要 |
|
|
33
|
-
| Production | リリースタグ作成 | ローリング or Blue/Green | 必須 |
|
|
34
|
-
|
|
35
|
-
### 3. OIDC 認証
|
|
36
|
-
|
|
37
|
-
クラウド環境へのデプロイではシークレットキーの直接管理を避け、OIDC(OpenID Connect)認証を使用する。
|
|
38
|
-
|
|
39
|
-
- **AWS**: GitHub Actions OIDC Provider + IAM Role
|
|
40
|
-
- **GCP**: Workload Identity Federation
|
|
41
|
-
- **Azure**: Federated Identity Credentials
|
|
42
|
-
|
|
43
|
-
### 4. ベストプラクティス
|
|
44
|
-
|
|
45
|
-
- **高速フィードバック**: Lint → テスト → ビルドの順で失敗を早期検知
|
|
46
|
-
- **キャッシュ活用**: 依存関係のキャッシュで実行時間を短縮
|
|
47
|
-
- **並列実行**: 独立したジョブは並列で実行
|
|
48
|
-
- **段階的導入**: CI 基盤 → 開発環境 CD → ステージング CD → 本番 CD の順
|
|
49
|
-
|
|
50
|
-
### 関連スキル
|
|
51
|
-
|
|
52
|
-
- `operating-deploy` : デプロイの実行
|
|
53
|
-
- `operating-provision` : OIDC 用 IAM ロールのプロビジョニング
|
|
54
|
-
- `orchestrating-operation` : 運用フェーズ全体のワークフロー案内
|
|
1
|
+
---
|
|
2
|
+
name: operating-cicd
|
|
3
|
+
description: CI/CD パイプラインを構築。CI(Lint・テスト・ビルド・セキュリティスキャン)と CD(環境別デプロイ・OIDC 認証)の設計・実装。CI/CD パイプラインの構築やデプロイ自動化の設定時に使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# CI/CD パイプライン構築
|
|
7
|
+
|
|
8
|
+
継続的インテグレーション・デプロイのパイプラインを構築します。
|
|
9
|
+
|
|
10
|
+
## Instructions
|
|
11
|
+
|
|
12
|
+
### 1. CI パイプライン
|
|
13
|
+
|
|
14
|
+
ビルド・テスト・品質チェックを自動化する。
|
|
15
|
+
|
|
16
|
+
| 段階 | 内容 | 目的 |
|
|
17
|
+
|------|------|------|
|
|
18
|
+
| ソースチェックアウト | リポジトリのコード取得 | 最新コードの取得 |
|
|
19
|
+
| 依存関係インストール | パッケージのインストール | ビルド環境の準備 |
|
|
20
|
+
| 静的解析 | Lint、型チェック | コード品質の担保 |
|
|
21
|
+
| テスト | 単体・統合テストの実行 | 機能の正しさの検証 |
|
|
22
|
+
| ビルド | アプリケーションのビルド | デプロイ可能な成果物の生成 |
|
|
23
|
+
| セキュリティスキャン | 依存関係の脆弱性チェック | セキュリティリスクの排除 |
|
|
24
|
+
|
|
25
|
+
### 2. CD パイプライン
|
|
26
|
+
|
|
27
|
+
環境別のデプロイを自動化する。
|
|
28
|
+
|
|
29
|
+
| 環境 | トリガー | 方式 | 承認 |
|
|
30
|
+
|------|---------|------|------|
|
|
31
|
+
| Development | `develop` ブランチ push | 即座デプロイ | 不要 |
|
|
32
|
+
| Staging | `main` ブランチ push | 自動デプロイ | 不要 |
|
|
33
|
+
| Production | リリースタグ作成 | ローリング or Blue/Green | 必須 |
|
|
34
|
+
|
|
35
|
+
### 3. OIDC 認証
|
|
36
|
+
|
|
37
|
+
クラウド環境へのデプロイではシークレットキーの直接管理を避け、OIDC(OpenID Connect)認証を使用する。
|
|
38
|
+
|
|
39
|
+
- **AWS**: GitHub Actions OIDC Provider + IAM Role
|
|
40
|
+
- **GCP**: Workload Identity Federation
|
|
41
|
+
- **Azure**: Federated Identity Credentials
|
|
42
|
+
|
|
43
|
+
### 4. ベストプラクティス
|
|
44
|
+
|
|
45
|
+
- **高速フィードバック**: Lint → テスト → ビルドの順で失敗を早期検知
|
|
46
|
+
- **キャッシュ活用**: 依存関係のキャッシュで実行時間を短縮
|
|
47
|
+
- **並列実行**: 独立したジョブは並列で実行
|
|
48
|
+
- **段階的導入**: CI 基盤 → 開発環境 CD → ステージング CD → 本番 CD の順
|
|
49
|
+
|
|
50
|
+
### 関連スキル
|
|
51
|
+
|
|
52
|
+
- `operating-deploy` : デプロイの実行
|
|
53
|
+
- `operating-provision` : OIDC 用 IAM ロールのプロビジョニング
|
|
54
|
+
- `orchestrating-operation` : 運用フェーズ全体のワークフロー案内
|
|
@@ -1,67 +1,67 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: operating-deploy
|
|
3
|
-
description: 各環境へのデプロイを実行。Docker イメージのビルド・プッシュ、ローリングデプロイ、Blue/Green デプロイ、ロールバック、ステータス確認、ログ取得。デプロイやロールバック、サービス状態確認時に使用。
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# デプロイ
|
|
7
|
-
|
|
8
|
-
各環境へのデプロイ、ロールバック、ステータス確認を実行します。
|
|
9
|
-
|
|
10
|
-
## Instructions
|
|
11
|
-
|
|
12
|
-
### 1. デプロイフロー
|
|
13
|
-
|
|
14
|
-
```
|
|
15
|
-
Docker ビルド → Registry プッシュ → 対象環境でプル → サービス更新 → ヘルスチェック
|
|
16
|
-
```
|
|
17
|
-
|
|
18
|
-
### 2. デプロイ方式
|
|
19
|
-
|
|
20
|
-
| 方式 | 説明 | 用途 |
|
|
21
|
-
|------|------|------|
|
|
22
|
-
| Docker イメージ配布 | Registry 経由でイメージをプル | 開発環境 |
|
|
23
|
-
| ローリングデプロイ | 段階的にインスタンスを更新 | ECS ステージング・本番 |
|
|
24
|
-
| Blue/Green | 新旧環境を切り替え | RDS アップグレード |
|
|
25
|
-
|
|
26
|
-
### 3. 環境別デプロイ
|
|
27
|
-
|
|
28
|
-
```bash
|
|
29
|
-
# 開発環境: Docker イメージ配布
|
|
30
|
-
# 「開発環境にデプロイして」
|
|
31
|
-
|
|
32
|
-
# ステージング環境: ECS ローリングデプロイ
|
|
33
|
-
# 「ステージングにデプロイして」
|
|
34
|
-
|
|
35
|
-
# 本番環境: 承認後デプロイ
|
|
36
|
-
# 「本番にデプロイして」
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
### 4. ロールバック
|
|
40
|
-
|
|
41
|
-
問題発生時は前バージョンに切り戻す。
|
|
42
|
-
|
|
43
|
-
```bash
|
|
44
|
-
# 「開発環境をロールバックして」
|
|
45
|
-
# 「本番を前バージョンに戻して」
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
### 5. ステータス確認・ログ
|
|
49
|
-
|
|
50
|
-
```bash
|
|
51
|
-
# 「開発環境の状態を確認して」
|
|
52
|
-
# 「ステージングのログを見せて」
|
|
53
|
-
# 「全環境の状態を確認して」
|
|
54
|
-
```
|
|
55
|
-
|
|
56
|
-
### 6. 注意事項
|
|
57
|
-
|
|
58
|
-
- **段階的デプロイ**: Development → Staging → Production の順序を厳守
|
|
59
|
-
- **ステージング検証**: 本番デプロイ前にステージングで十分に検証
|
|
60
|
-
- **ロールバック準備**: デプロイ前にロールバック手順を確認
|
|
61
|
-
- **ヘルスチェック**: デプロイ後に必ず動作確認を実施
|
|
62
|
-
|
|
63
|
-
### 関連スキル
|
|
64
|
-
|
|
65
|
-
- `operating-cicd` : CI/CD パイプライン構築
|
|
66
|
-
- `operating-backup` : デプロイ前のバックアップ
|
|
67
|
-
- `developing-release` : リリースワークフロー
|
|
1
|
+
---
|
|
2
|
+
name: operating-deploy
|
|
3
|
+
description: 各環境へのデプロイを実行。Docker イメージのビルド・プッシュ、ローリングデプロイ、Blue/Green デプロイ、ロールバック、ステータス確認、ログ取得。デプロイやロールバック、サービス状態確認時に使用。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# デプロイ
|
|
7
|
+
|
|
8
|
+
各環境へのデプロイ、ロールバック、ステータス確認を実行します。
|
|
9
|
+
|
|
10
|
+
## Instructions
|
|
11
|
+
|
|
12
|
+
### 1. デプロイフロー
|
|
13
|
+
|
|
14
|
+
```
|
|
15
|
+
Docker ビルド → Registry プッシュ → 対象環境でプル → サービス更新 → ヘルスチェック
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
### 2. デプロイ方式
|
|
19
|
+
|
|
20
|
+
| 方式 | 説明 | 用途 |
|
|
21
|
+
|------|------|------|
|
|
22
|
+
| Docker イメージ配布 | Registry 経由でイメージをプル | 開発環境 |
|
|
23
|
+
| ローリングデプロイ | 段階的にインスタンスを更新 | ECS ステージング・本番 |
|
|
24
|
+
| Blue/Green | 新旧環境を切り替え | RDS アップグレード |
|
|
25
|
+
|
|
26
|
+
### 3. 環境別デプロイ
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
# 開発環境: Docker イメージ配布
|
|
30
|
+
# 「開発環境にデプロイして」
|
|
31
|
+
|
|
32
|
+
# ステージング環境: ECS ローリングデプロイ
|
|
33
|
+
# 「ステージングにデプロイして」
|
|
34
|
+
|
|
35
|
+
# 本番環境: 承認後デプロイ
|
|
36
|
+
# 「本番にデプロイして」
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### 4. ロールバック
|
|
40
|
+
|
|
41
|
+
問題発生時は前バージョンに切り戻す。
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
# 「開発環境をロールバックして」
|
|
45
|
+
# 「本番を前バージョンに戻して」
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
### 5. ステータス確認・ログ
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
# 「開発環境の状態を確認して」
|
|
52
|
+
# 「ステージングのログを見せて」
|
|
53
|
+
# 「全環境の状態を確認して」
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### 6. 注意事項
|
|
57
|
+
|
|
58
|
+
- **段階的デプロイ**: Development → Staging → Production の順序を厳守
|
|
59
|
+
- **ステージング検証**: 本番デプロイ前にステージングで十分に検証
|
|
60
|
+
- **ロールバック準備**: デプロイ前にロールバック手順を確認
|
|
61
|
+
- **ヘルスチェック**: デプロイ後に必ず動作確認を実施
|
|
62
|
+
|
|
63
|
+
### 関連スキル
|
|
64
|
+
|
|
65
|
+
- `operating-cicd` : CI/CD パイプライン構築
|
|
66
|
+
- `operating-backup` : デプロイ前のバックアップ
|
|
67
|
+
- `developing-release` : リリースワークフロー
|