musubi-sdd 0.1.6 → 0.1.7

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 (24) hide show
  1. package/package.json +1 -1
  2. package/src/templates/agents/claude-code/skills/ai-ml-engineer/SKILL.md +93 -1
  3. package/src/templates/agents/claude-code/skills/api-designer/SKILL.md +21 -0
  4. package/src/templates/agents/claude-code/skills/bug-hunter/SKILL.md +76 -3
  5. package/src/templates/agents/claude-code/skills/change-impact-analyzer/SKILL.md +88 -1
  6. package/src/templates/agents/claude-code/skills/cloud-architect/SKILL.md +21 -0
  7. package/src/templates/agents/claude-code/skills/code-reviewer/SKILL.md +90 -2
  8. package/src/templates/agents/claude-code/skills/constitution-enforcer/SKILL.md +84 -1
  9. package/src/templates/agents/claude-code/skills/database-administrator/SKILL.md +87 -1
  10. package/src/templates/agents/claude-code/skills/database-schema-designer/SKILL.md +21 -0
  11. package/src/templates/agents/claude-code/skills/devops-engineer/SKILL.md +85 -1
  12. package/src/templates/agents/claude-code/skills/performance-optimizer/SKILL.md +79 -3
  13. package/src/templates/agents/claude-code/skills/project-manager/SKILL.md +21 -0
  14. package/src/templates/agents/claude-code/skills/quality-assurance/SKILL.md +88 -1
  15. package/src/templates/agents/claude-code/skills/release-coordinator/SKILL.md +87 -1
  16. package/src/templates/agents/claude-code/skills/requirements-analyst/SKILL.md +21 -0
  17. package/src/templates/agents/claude-code/skills/security-auditor/SKILL.md +97 -2
  18. package/src/templates/agents/claude-code/skills/site-reliability-engineer/SKILL.md +91 -1
  19. package/src/templates/agents/claude-code/skills/software-developer/SKILL.md +62 -10
  20. package/src/templates/agents/claude-code/skills/system-architect/SKILL.md +21 -0
  21. package/src/templates/agents/claude-code/skills/technical-writer/SKILL.md +19 -0
  22. package/src/templates/agents/claude-code/skills/test-engineer/SKILL.md +44 -10
  23. package/src/templates/agents/claude-code/skills/traceability-auditor/SKILL.md +85 -1
  24. package/src/templates/agents/claude-code/skills/ui-ux-designer/SKILL.md +22 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "musubi-sdd",
3
- "version": "0.1.6",
3
+ "version": "0.1.7",
4
4
  "description": "Ultimate Specification Driven Development Tool with 25 Agents for 7 AI Coding Platforms (Claude Code, GitHub Copilot, Cursor, Gemini CLI, Windsurf, Codex, Qwen Code)",
5
5
  "main": "src/index.js",
6
6
  "bin": {
@@ -557,10 +557,102 @@ LLM・生成AIのユースケースを教えてください:
557
557
 
558
558
  ---
559
559
 
560
- ### Phase 4: 実装・ドキュメント生成
560
+ ### Phase 4: 段階的実装・ドキュメント生成
561
+
562
+ **CRITICAL: コンテキスト長オーバーフロー防止**
563
+
564
+ **出力方式の原則:**
565
+ - ✅ 1ファイルずつ順番に生成・保存
566
+ - ✅ 各生成後に進捗を報告
567
+ - ✅ 大きなファイル(>300行)は複数に分割
568
+ - ✅ エラー発生時も部分的な成果物が残る
561
569
 
562
570
  確認後、以下の成果物を生成します。
563
571
 
572
+ ```
573
+ 🤖 確認ありがとうございます。以下のファイルを順番に生成します。
574
+
575
+ 【生成予定のファイル】
576
+ 1. プロジェクト構造 (README.md, setup.py)
577
+ 2. データセットクラス (src/data/dataset.py)
578
+ 3. モデル定義 (src/models/model.py)
579
+ 4. トレーニングスクリプト (src/models/trainer.py)
580
+ 5. 推論スクリプト (src/inference/predictor.py)
581
+ 6. Jupyter Notebook (notebooks/)
582
+ 7. 設定ファイル (config/)
583
+ 8. テスト (tests/)
584
+ 9. ドキュメント (docs/)
585
+
586
+ 合計: 約12-15ファイル
587
+
588
+ **重要: 段階的生成方式**
589
+ 各ファイルを1つずつ生成・保存し、進捗を報告します。
590
+ これにより、途中経過が見え、エラーが発生しても部分的な成果物が残ります。
591
+
592
+ 生成を開始してよろしいですか?
593
+ 👤 ユーザー: [回答待ち]
594
+ ```
595
+
596
+ ユーザーが承認後、**各ファイルを順番に生成**:
597
+
598
+ **Step 1: README & setup.py**
599
+
600
+ ```
601
+ 🤖 [1/N] プロジェクト設定ファイルを生成しています...
602
+
603
+ 📝 README.md
604
+ 📝 setup.py
605
+ ✅ 保存が完了しました
606
+
607
+ [1/N] 完了。次のファイルに進みます。
608
+ ```
609
+
610
+ **Step 2: データセットクラス**
611
+
612
+ ```
613
+ 🤖 [2/N] データセットクラスを生成しています...
614
+
615
+ 📝 src/data/dataset.py
616
+ ✅ 保存が完了しました (280行)
617
+
618
+ [2/N] 完了。次のファイルに進みます。
619
+ ```
620
+
621
+ **大きなMLファイル(>300行)の場合:**
622
+
623
+ ```
624
+ 🤖 [3/N] モデルトレーニングスクリプトを生成しています...
625
+ ⚠️ トレーニングスクリプトが450行になるため、2パートに分割して生成します。
626
+
627
+ 📝 Part 1/2: src/models/trainer.py (行1-250: データ準備とモデル定義)
628
+ ✅ 保存が完了しました
629
+
630
+ 📝 Part 2/2: src/models/trainer.py (行251-450: トレーニングループと評価)
631
+ ✅ 保存が完了しました
632
+
633
+ ✅ ファイル生成完了: src/models/trainer.py (450行)
634
+
635
+ [3/N] 完了。次のファイルに進みます。
636
+ ```
637
+
638
+ **Final: 実装完了サマリー**
639
+
640
+ ```
641
+ 🤖 ✨ すべてのファイル生成が完了しました!
642
+
643
+ ## 📊 実装サマリー
644
+ - **生成ファイル数**: N個
645
+ - **総コード行数**: 約XXX行
646
+ - **テストカバレッジ**: 85%
647
+
648
+ ## 📂 生成されたファイル
649
+ 1. ✅ README.md, setup.py - プロジェクト設定
650
+ 2. ✅ src/data/dataset.py - データセットクラス
651
+ 3. ✅ src/models/model.py - モデル定義
652
+ ...
653
+
654
+ ```
655
+
564
656
  ### 4.1 画像分類プロジェクトの成果物
565
657
 
566
658
  #### 1. プロジェクト構造
@@ -458,6 +458,27 @@ f) すべて
458
458
  [3/10] 完了。次のドキュメントに進みます。
459
459
  ```
460
460
 
461
+ ---
462
+
463
+ **大きなOpenAPI仕様書(>300行)の場合:**
464
+
465
+ ```
466
+ 🤖 [4/10] 包括的なOpenAPI仕様書を生成しています...
467
+ ⚠️ OpenAPI仕様が600行になるため、2パートに分割して生成します。
468
+
469
+ 📝 Part 1/2: design/api/openapi.yaml (認証&ユーザーエンドポイント)
470
+ ✅ 保存が完了しました (350行)
471
+
472
+ 📝 Part 2/2: design/api/openapi.yaml (データ&管理エンドポイント)
473
+ ✅ 保存が完了しました (280行)
474
+
475
+ ✅ 仕様書生成完了: design/api/openapi.yaml (630行, 45エンドポイント)
476
+
477
+ [4/10] 完了。次のドキュメントに進みます。
478
+ ```
479
+
480
+ ---
481
+
461
482
  **Step 4: 認証フロー図 - 英語版**
462
483
 
463
484
  ```
@@ -365,12 +365,85 @@ app.get('/api/user/profile', async (req, res) => {
365
365
  👤 ユーザー: [はい、実装してください]
366
366
  ```
367
367
 
368
- ### Phase 4: 修正実装
368
+ ### Phase 4: 段階的修正実装
369
+
370
+ **CRITICAL: コンテキスト長オーバーフロー防止**
371
+
372
+ **出力方式の原則:**
373
+ - ✅ 1ファイルずつ順番に修正・保存
374
+ - ✅ 各修正後に進捗を報告
375
+ - ✅ エラー発生時も部分的な修正が残る
369
376
 
370
377
  ```
371
- 修正を実装しました!
378
+ 🤖 修正内容を確認しました。以下のファイルを順番に修正します。
379
+
380
+ 【修正予定のファイル】
381
+ 1. src/config/database.ts - 接続プール設定変更
382
+ 2. src/features/dashboard/Dashboard.tsx - エラーハンドリング追加
383
+ 3. src/api/routes/user.routes.ts - キャッシング実装
384
+ 4. テストファイル追加/修正
385
+
386
+ 合計: N個のファイル
387
+
388
+ **重要: 段階的修正方式**
389
+ 各ファイルを1つずつ修正・保存し、進捗を報告します。
390
+ これにより、途中経過が見え、エラーが発生しても部分的な修正が残ります。
391
+
392
+ 修正を開始してよろしいですか?
393
+ 👤 ユーザー: [回答待ち]
394
+ ```
395
+
396
+ ユーザーが承認後、**各ファイルを順番に修正**:
397
+
398
+ **Step 1: データベース設定修正**
399
+
400
+ ```
401
+ 🤖 [1/N] データベース設定を修正しています...
402
+
403
+ 📝 src/config/database.ts
404
+ ✅ 修正が完了しました
405
+
406
+ [1/N] 完了。次のファイルに進みます。
407
+ ```
408
+
409
+ **Step 2: エラーハンドリング追加**
410
+
411
+ ```
412
+ 🤖 [2/N] エラーハンドリングを追加しています...
413
+
414
+ 📝 src/features/dashboard/Dashboard.tsx
415
+ ✅ 修正が完了しました
416
+
417
+ [2/N] 完了。次のファイルに進みます。
418
+ ```
419
+
420
+ **大きなファイル(>300行)修正の場合:**
421
+
422
+ ```
423
+ 🤖 [3/N] 大きなファイルを修正しています...
424
+ ⚠️ このファイルは500行あるため、2パートに分割して修正を適用します。
425
+
426
+ 📝 Part 1/2: src/api/routes/complex.routes.ts (行1-250の修正)
427
+ ✅ 修正が完了しました
428
+
429
+ 📝 Part 2/2: src/api/routes/complex.routes.ts (行251-500の修正)
430
+ ✅ 修正が完了しました
431
+
432
+ ✅ ファイル修正完了: src/api/routes/complex.routes.ts (500行)
433
+
434
+ [3/N] 完了。次のファイルに進みます。
435
+ ```
436
+
437
+ **Final: 修正完了サマリー**
438
+
439
+ ```
440
+ 🤖 ✨ すべての修正が完了しました!
441
+
442
+ ## 📊 修正サマリー
443
+ - **修正ファイル数**: N個
444
+ - **追加テスト**: M個
372
445
 
373
- ## 修正されたファイル
446
+ ## 📂 修正されたファイル
374
447
  1. ✅ src/config/database.ts - 接続プール設定変更
375
448
  2. ✅ src/features/dashboard/Dashboard.tsx - エラーハンドリング追加
376
449
  3. ✅ src/api/routes/user.routes.ts - キャッシング実装
@@ -310,7 +310,94 @@ find api/ -name "*.yaml" -o -name "*.json"
310
310
  3. Identify indirect (cascading) dependencies
311
311
  4. Identify integration points
312
312
 
313
- ### Phase 4: Impact Report Generation
313
+ ### Phase 4: 段階的影響分析レポート生成
314
+
315
+ **CRITICAL: コンテキスト長オーバーフロー防止**
316
+
317
+ **出力方式の原則:**
318
+ - ✅ 1セクションずつ順番に生成・保存
319
+ - ✅ 各セクション生成後に進捗を報告
320
+ - ✅ 大きなレポートをセクションごとに分割
321
+ - ✅ エラー発生時も部分的なレポートが残る
322
+
323
+ ```
324
+ 🤖 確認ありがとうございます。影響分析レポートを順番に生成します。
325
+
326
+ 【生成予定のセクション】
327
+ 1. Executive Summary
328
+ 2. Affected Components
329
+ 3. Breaking Changes
330
+ 4. Risk Assessment
331
+ 5. Recommendations
332
+ 6. Approval Checklist
333
+
334
+ 合計: 6セクション
335
+
336
+ **重要: 段階的生成方式**
337
+ 各セクションを1つずつ生成・保存し、進捗を報告します。
338
+ これにより、途中経過が見え、エラーが発生しても部分的なレポートが残ります。
339
+
340
+ 生成を開始してよろしいですか?
341
+ 👤 ユーザー: [回答待ち]
342
+ ```
343
+
344
+ ユーザーが承認後、**各セクションを順番に生成**:
345
+
346
+ **Step 1: Executive Summary**
347
+
348
+ ```
349
+ 🤖 [1/6] Executive Summaryを生成しています...
350
+
351
+ 📝 impact-analysis/add-two-factor-auth-report.md (Section 1)
352
+ ✅ 保存が完了しました
353
+
354
+ [1/6] 完了。次のセクションに進みます。
355
+ ```
356
+
357
+ **Step 2: Affected Components**
358
+
359
+ ```
360
+ 🤖 [2/6] Affected Componentsを生成しています...
361
+
362
+ 📝 impact-analysis/add-two-factor-auth-report.md (Section 2)
363
+ ✅ 保存が完了しました
364
+
365
+ [2/6] 完了。次のセクションに進みます。
366
+ ```
367
+
368
+ **大きな影響分析レポート(>300行)の場合:**
369
+
370
+ ```
371
+ 🤖 影響分析レポート全体が500行超えるため、セクションごとに保存します。
372
+ ⚠️ 各セクションを個別ファイルとして生成し、最後に統合します。
373
+
374
+ 📝 Part 1/3: impact-analysis/add-two-factor-auth-report-part1.md (Executive Summary & Affected Components)
375
+ ✅ 保存が完了しました (200行)
376
+
377
+ 📝 Part 2/3: impact-analysis/add-two-factor-auth-report-part2.md (Risk Assessment & Dependencies)
378
+ ✅ 保存が完了しました (180行)
379
+
380
+ 📝 Part 3/3: impact-analysis/add-two-factor-auth-report-part3.md (Recommendations & Approval)
381
+ ✅ 保存が完了しました (150行)
382
+
383
+ ✅ レポート生成完了: 3ファイル (合計530行)
384
+ 💡 必要に応じて統合版も生成できます
385
+ ```
386
+
387
+ **Final: レポート生成完了サマリー**
388
+
389
+ ```
390
+ 🤖 ✨ 影響分析レポートの生成が完了しました!
391
+
392
+ ## 📊 分析サマリー
393
+ - **影響を受けるコンポーネント**: 12ファイル
394
+ - **破壊的変更**: 1件
395
+ - **リスクレベル**: HIGH
396
+
397
+ ## 📂 生成されたレポート
398
+ ✅ impact-analysis/add-two-factor-auth-report.md (6セクション)
399
+
400
+ ```
314
401
 
315
402
  ```markdown
316
403
  # Change Impact Analysis Report
@@ -454,6 +454,27 @@ f) すべて
454
454
  [3/12] 完了。次のドキュメントに進みます。
455
455
  ```
456
456
 
457
+ ---
458
+
459
+ **大きなIaCファイル(>300行)の場合:**
460
+
461
+ ```
462
+ 🤖 [4/12] 大規模なTerraform/Bicepコードを生成しています...
463
+ ⚠️ IaCファイルが600行になるため、2パートに分割して生成します。
464
+
465
+ 📝 Part 1/2: infrastructure/main.tf (行1-350: ネットワーク&セキュリティ)
466
+ ✅ 保存が完了しました
467
+
468
+ 📝 Part 2/2: infrastructure/main.tf (行351-600: コンピュート&ストレージ)
469
+ ✅ 保存が完了しました
470
+
471
+ ✅ IaCコード生成完了: infrastructure/main.tf (600行)
472
+
473
+ [4/12] 完了。次のドキュメントに進みます。
474
+ ```
475
+
476
+ ---
477
+
457
478
  **Step 4: セキュリティ設計書 - 英語版**
458
479
 
459
480
  ```
@@ -600,7 +600,14 @@ export async function login(email: string, password: string): Promise<LoginRespo
600
600
  👤 ユーザー: [回答待ち]
601
601
  ```
602
602
 
603
- ### Phase 4: 修正支援
603
+ ### Phase 4: 段階的修正支援
604
+
605
+ **CRITICAL: コンテキスト長オーバーフロー防止**
606
+
607
+ **出力方式の原則:**
608
+ - ✅ 1問題ずつ順番に修正・保存
609
+ - ✅ 各修正後に進捗を報告
610
+ - ✅ エラー発生時も部分的な修正が残る
604
611
 
605
612
  必要に応じて、コードの修正を支援します。
606
613
 
@@ -608,13 +615,94 @@ export async function login(email: string, password: string): Promise<LoginRespo
608
615
  【質問】どの問題から修正を始めますか?
609
616
 
610
617
  選択肢:
611
- 1. すべての重大な問題を一括で修正
618
+ 1. すべての重大な問題を順番に修正
612
619
  2. 特定の問題を選択して修正
613
620
  3. 修正案のみ提示(自分で修正する)
614
621
 
615
622
  👤 ユーザー: [回答待ち]
616
623
  ```
617
624
 
625
+ ユーザーが「1. すべての重大な問題を順番に修正」を選択した場合:
626
+
627
+ ```
628
+ 🤖 確認ありがとうございます。以下の問題を順番に修正します。
629
+
630
+ 【修正予定の問題】(重大度順)
631
+ 1. [🔴 重大] SQLインジェクション (auth.routes.ts)
632
+ 2. [🔴 重大] N+1クエリ (users.routes.ts)
633
+ 3. [🟡 警告] 依存配列の問題 (useAuth.ts)
634
+ 4. [🟡 警告] エラーハンドリング (LoginForm.tsx)
635
+
636
+ 合計: N件の問題
637
+
638
+ **重要: 段階的修正方式**
639
+ 各問題を1つずつ修正・保存し、進捗を報告します。
640
+ これにより、途中経過が見え、エラーが発生しても部分的な修正が残ります。
641
+
642
+ 修正を開始してよろしいですか?
643
+ 👤 ユーザー: [回答待ち]
644
+ ```
645
+
646
+ ユーザーが承認後、**各問題を順番に修正**:
647
+
648
+ **Step 1: SQLインジェクション修正**
649
+
650
+ ```
651
+ 🤖 [1/N] SQLインジェクションを修正しています...
652
+
653
+ 📝 src/api/routes/auth.routes.ts
654
+ ✅ 修正が完了しました
655
+
656
+ [1/N] 完了。次の問題修正に進みます。
657
+ ```
658
+
659
+ **Step 2: N+1クエリ修正**
660
+
661
+ ```
662
+ 🤖 [2/N] N+1クエリを修正しています...
663
+
664
+ 📝 src/api/routes/users.routes.ts
665
+ ✅ 修正が完了しました
666
+
667
+ [2/N] 完了。次の問題修正に進みます。
668
+ ```
669
+
670
+ **大きなファイル(>300行)のレビュー修正の場合:**
671
+
672
+ ```
673
+ 🤖 [3/N] 大規模ファイルのリファクタリングを実施しています...
674
+ ⚠️ このファイルは500行あるため、2パートに分割して修正を適用します。
675
+
676
+ 📝 Part 1/2: src/services/complex-service.ts (行1-250の修正)
677
+ ✅ 修正が完了しました (10箇所改善)
678
+
679
+ 📝 Part 2/2: src/services/complex-service.ts (行251-500の修正)
680
+ ✅ 修正が完了しました (8箇所改善)
681
+
682
+ ✅ ファイル修正完了: src/services/complex-service.ts (500行, 18箇所改善)
683
+
684
+ [3/N] 完了。次の問題修正に進みます。
685
+ ```
686
+
687
+ **Final: 修正完了サマリー**
688
+
689
+ ```
690
+ 🤖 ✨ すべての問題修正が完了しました!
691
+
692
+ ## 📊 修正サマリー
693
+ - **修正した問題**: N件
694
+ - 🔴 重大: X件 → ✅ すべて修正完了
695
+ - 🟡 警告: Y件 → ✅ すべて修正完了
696
+ - **修正行数**: 約80行
697
+
698
+ ## 📂 修正されたファイル
699
+ 1. ✅ src/api/routes/auth.routes.ts - セキュリティ問題修正
700
+ 2. ✅ src/api/routes/users.routes.ts - N+1クエリ解決
701
+ 3. ✅ src/features/auth/useAuth.ts - リファクタリング
702
+ 4. ✅ src/features/auth/LoginForm.tsx - 依存配列修正
703
+
704
+ ```
705
+
618
706
  **修正支援プロセス**:
619
707
 
620
708
  1. **修正対象の確認**: ユーザーが選択した問題
@@ -376,7 +376,90 @@ Run all Phase -1 Gates:
376
376
  8. CLI Interface Gate
377
377
  9. Test-First Gate
378
378
 
379
- ### Phase 4: Report Generation
379
+ ### Phase 4: 段階的レポート生成
380
+
381
+ **CRITICAL: コンテキスト長オーバーフロー防止**
382
+
383
+ **出力方式の原則:**
384
+ - ✅ 1セクションずつ順番に生成・保存
385
+ - ✅ 各セクション生成後に進捗を報告
386
+ - ✅ エラー発生時も部分的なレポートが残る
387
+
388
+ ```
389
+ 🤖 確認ありがとうございます。憲法違反レポートを順番に生成します。
390
+
391
+ 【生成予定のセクション】
392
+ 1. Executive Summary
393
+ 2. Failed Gates
394
+ 3. Passed Gates
395
+ 4. Recommendations
396
+ 5. Approval Status
397
+
398
+ 合計: 5セクション
399
+
400
+ **重要: 段階的生成方式**
401
+ 各セクションを1つずつ生成・保存し、進捗を報告します。
402
+ これにより、途中経過が見え、エラーが発生しても部分的なレポートが残ります。
403
+
404
+ 生成を開始してよろしいですか?
405
+ 👤 ユーザー: [回答待ち]
406
+ ```
407
+
408
+ ユーザーが承認後、**各セクションを順番に生成**:
409
+
410
+ **Step 1: Executive Summary**
411
+
412
+ ```
413
+ 🤖 [1/5] Executive Summaryを生成しています...
414
+
415
+ 📝 compliance/constitutional-compliance-report.md (Section 1)
416
+ ✅ 保存が完了しました
417
+
418
+ [1/5] 完了。次のセクションに進みます。
419
+ ```
420
+
421
+ **Step 2: Failed Gates**
422
+
423
+ ```
424
+ 🤖 [2/5] Failed Gatesを生成しています...
425
+
426
+ 📝 compliance/constitutional-compliance-report.md (Section 2)
427
+ ✅ 保存が完了しました
428
+
429
+ [2/5] 完了。次のセクションに進みます。
430
+ ```
431
+
432
+ **大きなコンプライアンスレポート(>300行)の場合:**
433
+
434
+ ```
435
+ 🤖 コンプライアンスレポート全体が400行超えるため、セクションごとに保存します。
436
+ ⚠️ 詳細な検証結果を2パートに分割して生成します。
437
+
438
+ 📝 Part 1/2: compliance/constitutional-compliance-report.md (Summary & Failed Gates詳細)
439
+ ✅ 保存が完了しました (250行)
440
+
441
+ 📝 Part 2/2: compliance/constitutional-compliance-report.md (Passed Gates & Recommendations)
442
+ ✅ 保存が完了しました (180行)
443
+
444
+ ✅ レポート生成完了: compliance/constitutional-compliance-report.md (430行)
445
+
446
+ 全セクション完了。
447
+ ```
448
+
449
+ **Final: レポート生成完了サマリー**
450
+
451
+ ```
452
+ 🤖 ✨ 憲法違反レポートの生成が完了しました!
453
+
454
+ ## 📊 コンプライアンスサマリー
455
+ - **合格ゲート**: 7/9 (77.8%)
456
+ - **不合格ゲート**: 2/9 (22.2%)
457
+ - **ステータス**: ❌ BLOCKED
458
+
459
+ ## 📂 生成されたレポート
460
+ ✅ compliance/constitutional-compliance-report.md (5セクション)
461
+
462
+ ```
380
463
 
381
464
  ```markdown
382
465
  # Constitutional Compliance Report
@@ -530,10 +530,96 @@ RPO(Recovery Point Objective - 目標復旧時点):
530
530
 
531
531
  ---
532
532
 
533
- ### Phase 4: 実装・ドキュメント生成
533
+ ### Phase 4: 段階的ドキュメント生成
534
+
535
+ **CRITICAL: コンテキスト長オーバーフロー防止**
536
+
537
+ **出力方式の原則:**
538
+ - ✅ 1ドキュメントずつ順番に生成・保存
539
+ - ✅ 各生成後に進捗を報告
540
+ - ✅ 大きなドキュメント(>300行)はセクションごとに分割
541
+ - ✅ エラー発生時も部分的なドキュメントが残る
534
542
 
535
543
  確認後、以下の成果物を生成します。
536
544
 
545
+ ```
546
+ 🤖 確認ありがとうございます。以下のドキュメントを順番に生成します。
547
+
548
+ 【生成予定のドキュメント】
549
+ 1. スロークエリ分析レポート
550
+ 2. インデックス推奨ドキュメント
551
+ 3. パフォーマンスチューニング推奨設定
552
+ 4. バックアップ設定ドキュメント
553
+ 5. 運用ガイド
554
+
555
+ 合計: N個のドキュメント
556
+
557
+ **重要: 段階的生成方式**
558
+ 各ドキュメントを1つずつ生成・保存し、進捗を報告します。
559
+ これにより、途中経過が見え、エラーが発生しても部分的なドキュメントが残ります。
560
+
561
+ 生成を開始してよろしいですか?
562
+ 👤 ユーザー: [回答待ち]
563
+ ```
564
+
565
+ ユーザーが承認後、**各ドキュメントを順番に生成**:
566
+
567
+ **Step 1: スロークエリ分析レポート**
568
+
569
+ ```
570
+ 🤖 [1/N] スロークエリ分析レポートを生成しています...
571
+
572
+ 📝 database/reports/slow_query_analysis.md
573
+ ✅ 保存が完了しました (280行)
574
+
575
+ [1/N] 完了。次のドキュメントに進みます。
576
+ ```
577
+
578
+ **Step 2: インデックス推奨**
579
+
580
+ ```
581
+ 🤖 [2/N] インデックス推奨ドキュメントを生成しています...
582
+
583
+ 📝 database/recommendations/index_recommendations.md
584
+ ✅ 保存が完了しました (150行)
585
+
586
+ [2/N] 完了。次のドキュメントに進みます。
587
+ ```
588
+
589
+ **大きなドキュメント(>300行)の場合:**
590
+
591
+ ```
592
+ 🤖 [3/N] データベース移行スクリプトを生成しています...
593
+ ⚠️ 移行スクリプトが600行になるため、2パートに分割して生成します。
594
+
595
+ 📝 Part 1/2: database/migrations/v2.0-schema-update.sql (行1-350)
596
+ ✅ 保存が完了しました
597
+
598
+ 📝 Part 2/2: database/migrations/v2.0-schema-update.sql (行351-600)
599
+ ✅ 保存が完了しました
600
+
601
+ ✅ ファイル生成完了: database/migrations/v2.0-schema-update.sql (600行)
602
+
603
+ [3/N] 完了。次のドキュメントに進みます。
604
+ ```
605
+
606
+ **Final: 生成完了サマリー**
607
+
608
+ ```
609
+ 🤖 ✨ すべてのドキュメント生成が完了しました!
610
+
611
+ ## 📊 生成サマリー
612
+ - **生成ドキュメント数**: N個
613
+ - **総ページ数**: 約XXXページ
614
+
615
+ ## 📂 生成されたドキュメント
616
+ 1. ✅ database/reports/slow_query_analysis.md
617
+ 2. ✅ database/recommendations/index_recommendations.md
618
+ 3. ✅ database/config/tuning_recommendations.md
619
+ ...
620
+
621
+ ```
622
+
537
623
  ### 4.1 パフォーマンス最適化の成果物
538
624
 
539
625
  #### 1. スロークエリ分析レポート
@@ -441,6 +441,27 @@ f) すべて
441
441
  [3/12] 完了。次のドキュメントに進みます。
442
442
  ```
443
443
 
444
+ ---
445
+
446
+ **大きなDDL/マイグレーションスクリプト(>300行)の場合:**
447
+
448
+ ```
449
+ 🤖 [4/12] 大規模なデータベーススキーマを生成しています...
450
+ ⚠️ DDLスクリプトが500行になるため、2パートに分割して生成します。
451
+
452
+ 📝 Part 1/2: design/database/schema-migration.sql (テーブル定義 1-25)
453
+ ✅ 保存が完了しました (280行)
454
+
455
+ 📝 Part 2/2: design/database/schema-migration.sql (テーブル定義 26-50 & インデックス)
456
+ ✅ 保存が完了しました (250行)
457
+
458
+ ✅ DDL生成完了: design/database/schema-migration.sql (530行, 50テーブル)
459
+
460
+ [4/12] 完了。次のドキュメントに進みます。
461
+ ```
462
+
463
+ ---
464
+
444
465
  **Step 4: インデックス設計書 - 英語版**
445
466
 
446
467
  ```