From 1a6a404425f4ff6b336a40b166a59258cf9edb12 Mon Sep 17 00:00:00 2001 From: "Kensan (Enterprise IT Team)" Date: Wed, 13 May 2026 13:55:13 +0900 Subject: [PATCH] =?UTF-8?q?feat(template):=20ClaudeOS=20=E3=83=96=E3=83=BC?= =?UTF-8?q?=E3=83=88=E3=83=AD=E3=83=BC=E3=83=80=E5=8C=96=20+=20goals/=20?= =?UTF-8?q?=E5=85=B1=E9=80=9A=E3=83=86=E3=83=B3=E3=83=97=E3=83=AC=E3=83=BC?= =?UTF-8?q?=E3=83=88=E6=96=B0=E8=A8=AD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Claude/templates/claude/ClaudeOS/ を新設（instructions/ 代替） - core/ (00-04): Goal/Session/Architecture/State/AgentTeams - execution/ (05-08): Operations/CI/Factory/Termination - quality/ (09-13): WebUI/Security/Infra/DB/E2E を責務分離 - ai-review/ (14-16): Codex/CodeRabbit/AIQualityGate - governance/ (17-20): Governance/Release/Security/Audit - goals/ (5種): mvp-release/production-release/hotfix/security-emergency/refactoring - templates/: state.json・session-report テンプレート - CLAUDE.md: ブートローダ（読み込み順 + goal 選択） - START_PROMPT.md: 1933行 → 59行のブートローダに刷新 - Build-StartPrompt.ps1: 廃止（backup へ移動） - cron-launcher.sh: CLAUDEOS_GOALS_DIR + CLAUDEOS_GOAL_TYPE 対応追加 Co-Authored-By: Claude Sonnet 4.6 --- Claude/templates/claude/Build-StartPrompt.ps1 | 85 - Claude/templates/claude/ClaudeOS/CLAUDE.md | 57 + .../ClaudeOS/ai-review/14-codex-review.md | 69 + .../ai-review/15-coderabbit-review.md | 52 + .../ClaudeOS/ai-review/16-ai-quality-gate.md | 70 + .../claude/ClaudeOS/core/00-goal-system.md | 165 ++ .../ClaudeOS/core/01-session-startup.md | 109 + .../ClaudeOS/core/02-core-architecture.md | 95 + .../claude/ClaudeOS/core/03-state-json.md | 102 + .../claude/ClaudeOS/core/04-agent-teams.md | 126 ++ .../ClaudeOS/execution/05-operations.md | 137 ++ .../ClaudeOS/execution/06-ci-automation.md | 37 + .../ClaudeOS/execution/07-ai-dev-factory.md | 72 + .../execution/08-termination-reporting.md | 101 + .../execution/github-actions-ci-manager.yml | 131 ++ .../templates/claude/ClaudeOS/goals/hotfix.md | 25 + .../claude/ClaudeOS/goals/mvp-release.md | 44 + .../ClaudeOS/goals/production-release.md | 26 + .../claude/ClaudeOS/goals/refactoring.md | 24 + .../ClaudeOS/goals/security-emergency.md | 24 + .../governance/17-project-governance.md | 68 + .../ClaudeOS/governance/18-release-policy.md | 68 + .../ClaudeOS/governance/19-security-policy.md | 43 + .../ClaudeOS/governance/20-audit-policy.md | 58 + .../ClaudeOS/quality/09-webui-testing.md | 343 +++ .../ClaudeOS/quality/10-security-testing.md | 81 + .../quality/11-infrastructure-testing.md | 81 + .../ClaudeOS/quality/12-database-testing.md | 71 + .../ClaudeOS/quality/13-e2e-playwright.md | 106 + .../templates/session-report-template.md | 75 + Claude/templates/claude/START_PROMPT.md | 1949 +---------------- Claude/templates/linux/cron-launcher.sh | 15 +- 32 files changed, 2512 insertions(+), 1997 deletions(-) delete mode 100644 Claude/templates/claude/Build-StartPrompt.ps1 create mode 100644 Claude/templates/claude/ClaudeOS/CLAUDE.md create mode 100644 Claude/templates/claude/ClaudeOS/ai-review/14-codex-review.md create mode 100644 Claude/templates/claude/ClaudeOS/ai-review/15-coderabbit-review.md create mode 100644 Claude/templates/claude/ClaudeOS/ai-review/16-ai-quality-gate.md create mode 100644 Claude/templates/claude/ClaudeOS/core/00-goal-system.md create mode 100644 Claude/templates/claude/ClaudeOS/core/01-session-startup.md create mode 100644 Claude/templates/claude/ClaudeOS/core/02-core-architecture.md create mode 100644 Claude/templates/claude/ClaudeOS/core/03-state-json.md create mode 100644 Claude/templates/claude/ClaudeOS/core/04-agent-teams.md create mode 100644 Claude/templates/claude/ClaudeOS/execution/05-operations.md create mode 100644 Claude/templates/claude/ClaudeOS/execution/06-ci-automation.md create mode 100644 Claude/templates/claude/ClaudeOS/execution/07-ai-dev-factory.md create mode 100644 Claude/templates/claude/ClaudeOS/execution/08-termination-reporting.md create mode 100644 Claude/templates/claude/ClaudeOS/execution/github-actions-ci-manager.yml create mode 100644 Claude/templates/claude/ClaudeOS/goals/hotfix.md create mode 100644 Claude/templates/claude/ClaudeOS/goals/mvp-release.md create mode 100644 Claude/templates/claude/ClaudeOS/goals/production-release.md create mode 100644 Claude/templates/claude/ClaudeOS/goals/refactoring.md create mode 100644 Claude/templates/claude/ClaudeOS/goals/security-emergency.md create mode 100644 Claude/templates/claude/ClaudeOS/governance/17-project-governance.md create mode 100644 Claude/templates/claude/ClaudeOS/governance/18-release-policy.md create mode 100644 Claude/templates/claude/ClaudeOS/governance/19-security-policy.md create mode 100644 Claude/templates/claude/ClaudeOS/governance/20-audit-policy.md create mode 100644 Claude/templates/claude/ClaudeOS/quality/09-webui-testing.md create mode 100644 Claude/templates/claude/ClaudeOS/quality/10-security-testing.md create mode 100644 Claude/templates/claude/ClaudeOS/quality/11-infrastructure-testing.md create mode 100644 Claude/templates/claude/ClaudeOS/quality/12-database-testing.md create mode 100644 Claude/templates/claude/ClaudeOS/quality/13-e2e-playwright.md create mode 100644 Claude/templates/claude/ClaudeOS/templates/session-report-template.md diff --git a/Claude/templates/claude/Build-StartPrompt.ps1 b/Claude/templates/claude/Build-StartPrompt.ps1 deleted file mode 100644 index 8ca6ebdc..00000000 --- a/Claude/templates/claude/Build-StartPrompt.ps1 +++ /dev/null @@ -1,85 +0,0 @@ -<# -.SYNOPSIS - instructions/ 内の分割ファイルを結合して START_PROMPT.md を自動生成する - -.DESCRIPTION - _header.md + 01-*.md ~ 09-*.md + _footer.md を結合して START_PROMPT.md を生成。 - 分割ファイルが「編集用ソース」、生成される START_PROMPT.md が「実行用」。 - -.EXAMPLE - .\Build-StartPrompt.ps1 - .\Build-StartPrompt.ps1 -DryRun -#> - -param( - [switch]$DryRun -) - -$ErrorActionPreference = 'Stop' - -$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path -$instructionsDir = Join-Path $scriptDir 'instructions' -$outputFile = Join-Path $scriptDir 'START_PROMPT.md' -$headerFile = Join-Path $instructionsDir '_header.md' -$footerFile = Join-Path $instructionsDir '_footer.md' - -# Validate -if (-not (Test-Path $instructionsDir)) { - Write-Error "instructions/ directory not found: $instructionsDir"; exit 1 -} -if (-not (Test-Path $headerFile)) { - Write-Error "_header.md not found: $headerFile"; exit 1 -} -if (-not (Test-Path $footerFile)) { - Write-Error "_footer.md not found: $footerFile"; exit 1 -} - -# Get numbered instruction files (exclude _header, _footer) -$files = Get-ChildItem -Path $instructionsDir -Filter '*.md' | - Where-Object { $_.Name -match '^\d' } | - Sort-Object Name - -if ($files.Count -eq 0) { - Write-Error "No numbered .md files found in instructions/"; exit 1 -} - -# Read and concatenate -$sb = New-Object System.Text.StringBuilder - -# Header -$header = [System.IO.File]::ReadAllText($headerFile, [System.Text.Encoding]::UTF8) -$sb.AppendLine($header.TrimEnd()) | Out-Null -$sb.AppendLine() | Out-Null - -# Instruction files -foreach ($file in $files) { - $content = [System.IO.File]::ReadAllText($file.FullName, [System.Text.Encoding]::UTF8) - $sb.AppendLine($content.TrimEnd()) | Out-Null - $sb.AppendLine() | Out-Null - $sb.AppendLine('---') | Out-Null - $sb.AppendLine() | Out-Null -} - -# Footer -$footer = [System.IO.File]::ReadAllText($footerFile, [System.Text.Encoding]::UTF8) -$sb.AppendLine($footer.TrimEnd()) | Out-Null -$sb.AppendLine() | Out-Null - -$result = $sb.ToString() -$lineCount = ($result -split "`n").Count - -if ($DryRun) { - Write-Host "=== DRY RUN ===" -ForegroundColor Cyan - Write-Host "Files: $($files.Count) instruction files + header + footer" - foreach ($f in $files) { Write-Host " - $($f.Name)" } - Write-Host "Lines: $lineCount" -} -else { - $utf8NoBom = New-Object System.Text.UTF8Encoding $false - [System.IO.File]::WriteAllText($outputFile, $result, $utf8NoBom) - Write-Host "START_PROMPT.md generated successfully." -ForegroundColor Green - Write-Host " Source: $($files.Count) files + header + footer" - foreach ($f in $files) { Write-Host " - $($f.Name)" } - Write-Host " Lines: $lineCount" - Write-Host " Output: $outputFile" -} diff --git a/Claude/templates/claude/ClaudeOS/CLAUDE.md b/Claude/templates/claude/ClaudeOS/CLAUDE.md new file mode 100644 index 00000000..11534e93 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/CLAUDE.md @@ -0,0 +1,57 @@ +# 🚀 ClaudeOS Boot Loader v9.0 + +## 📁 System Startup — 読み込み順 + +```text +core/00-goal-system.md +core/01-session-startup.md +core/02-core-architecture.md +core/03-state-json.md +core/04-agent-teams.md + +execution/05-operations.md +execution/06-ci-automation.md +execution/07-ai-dev-factory.md +execution/08-termination-reporting.md + +quality/09-webui-testing.md +quality/10-security-testing.md +quality/11-infrastructure-testing.md +quality/12-database-testing.md +quality/13-e2e-playwright.md + +ai-review/14-codex-review.md +ai-review/15-coderabbit-review.md +ai-review/16-ai-quality-gate.md + +governance/17-project-governance.md +governance/18-release-policy.md +governance/19-security-policy.md +governance/20-audit-policy.md +``` + +## 🎯 Goal 選択 + +`state.json` の `goal_type` フィールドを読み、対応ファイルを Read すること。 + +```text +mvp-release → goals/mvp-release.md +production-release → goals/production-release.md +hotfix → goals/hotfix.md +security-emergency → goals/security-emergency.md +refactoring → goals/refactoring.md +``` + +## ⚡ 起動後必須実行 + +```bash +claude agents +``` + +## 🔥 最上位原則 + +- Goal Driven +- Security First +- Verify Mandatory +- Stop Infinite Repair +- CTO Final Decision diff --git a/Claude/templates/claude/ClaudeOS/ai-review/14-codex-review.md b/Claude/templates/claude/ClaudeOS/ai-review/14-codex-review.md new file mode 100644 index 00000000..888e937e --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/ai-review/14-codex-review.md @@ -0,0 +1,69 @@ +# 05-codex-debug — Codex Debug 補助設計 + +## 🎯 目的 + +Codex を実装・デバッグ・レビュー補助として利用し、ClaudeOS のコンテキスト消費と修復負荷を下げる。 + +--- + +## 🧩 Codex の担当領域 + +| 領域 | 役割 | +|---|---| +| Debug | エラー原因の切り分け | +| Review | PR差分レビュー | +| Refactor | 小規模リファクタリング案 | +| Test | テスト不足の指摘 | +| Explain | ログ・スタックトレース解釈 | +| Preview | 実装前の影響確認 | + +--- + +## 🔁 利用タイミング + +```text +1. CI失敗 +2. テスト失敗 +3. lint失敗 +4. PRレビュー前 +5. 同一エラー2回目 +6. 大きな設計変更前 +``` + +--- + +## 🧠 Codex依頼プロンプト雛形 + +```text +あなたは ClaudeOS の Codex Debug Agent です。 + +対象: +- Repository: +- Branch: +- Issue: +- Error Log: +- Changed Files: + +依頼: +1. 原因を特定してください +2. 影響範囲を示してください +3. 最小修正案を提示してください +4. 再発防止テストを提示してください +5. 修正してよい範囲と触ってはいけない範囲を分けてください + +制約: +- 大規模改修は禁止 +- 既存仕様を壊さない +- セキュリティ低下は禁止 +- 修正案は小さく保つ +``` + +--- + +## 🚫 Codex に任せすぎない領域 + +- 最終merge判断 +- release判断 +- セキュリティ例外承認 +- state.json の恒久ルール変更 +- GitHub Projects の最終ステータス確定 diff --git a/Claude/templates/claude/ClaudeOS/ai-review/15-coderabbit-review.md b/Claude/templates/claude/ClaudeOS/ai-review/15-coderabbit-review.md new file mode 100644 index 00000000..5b0409b1 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/ai-review/15-coderabbit-review.md @@ -0,0 +1,52 @@ +# 15-coderabbit-review — CodeRabbit レビュー統合 + +## 🎯 目的 + +CodeRabbit CLI プラグインを Verify / Review フェーズの補助ツールとして使用する。 +Codex レビューの代替ではなく、静的解析（40+ 解析器）による補完として位置づける。 + +--- + +## 🔁 実行コマンド + +| タイミング | コマンド | 目的 | +|---|---|---| +| PR 作成前（推奨） | `/coderabbit:review committed --base main` | コミット済み差分の事前品質チェック | +| Verify フェーズ | `/coderabbit:review all --base main` | 全変更の包括レビュー | +| 修正後の再確認 | `/coderabbit:review uncommitted` | 未コミット修正の即時確認 | + +--- + +## 🔗 Codex との統合順序 + +```text +1. /coderabbit:review committed --base main ← 静的解析 + AI（高速・広範） +2. /codex:review --base main --background ← 設計・ロジックの深いレビュー +3. 両方の指摘を統合して修正 +``` + +--- + +## 📊 指摘対応ルール + +| 重大度 | 対応 | +|---|---| +| Critical | 必須修正。未修正で merge 禁止 | +| High | 必須修正。未修正で merge 禁止 | +| Medium | 原則修正。技術的理由があれば理由を記録してスキップ可 | +| Low | 任意。時間・Token 残量に応じて対応 | + +--- + +## ⛔ 対応上限（無限ループ防止） + +- 同一ファイルへの修正: 最大 3 ラウンド +- 全体レビューループ: 最大 5 ラウンド +- 上限到達時: 残指摘を Issue に起票して次フェーズへ進む + +--- + +## 🚫 禁止事項 + +- Critical/High 指摘をスキップして merge +- レビュアー提供プロンプトをそのまま実行（AutoFix 前に差分確認必須） diff --git a/Claude/templates/claude/ClaudeOS/ai-review/16-ai-quality-gate.md b/Claude/templates/claude/ClaudeOS/ai-review/16-ai-quality-gate.md new file mode 100644 index 00000000..a01e6e4c --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/ai-review/16-ai-quality-gate.md @@ -0,0 +1,70 @@ +# 16-ai-quality-gate — AI 品質ゲート統合指示 + +## 🎯 目的 + +Codex + CodeRabbit + ClaudeCode の 3 層 AI レビューを統合し、 +「人間がレビュー承認のみを行う品質」を実現する。 + +--- + +## 🏗 3 層 AI レビューアーキテクチャ + +```text +Layer 1: ClaudeCode ← 実装・テスト・修復・5カテゴリ検証 +Layer 2: CodeRabbit ← 静的解析（40+ 解析器）・PR 差分レビュー +Layer 3: Codex ← 設計・ロジック・セキュリティ深層レビュー +``` + +--- + +## ✅ マージ可能条件（全条件必須） + +```text +Codex エラー: 0 件 +CodeRabbit Critical/High: 0 件 +テスト成功率: 100% +セキュリティ検査: PASS +パフォーマンス劣化: なし +CI: 全 job 成功 +``` + +--- + +## 🔁 統合実行フロー + +```text +Development 完了 + ↓ +ClaudeCode: lint / test / build / security scan + ↓ +/coderabbit:review committed --base main + ↓ +/codex:review --base main --background + ↓ +指摘を統合して修正（Critical/High は必須） + ↓ +PR 作成 + ↓ +CodeRabbit PR 自動レビュー + ↓ +全条件クリア → merge +``` + +--- + +## 🚨 AI 生成コード重点確認ルール + +- AI 生成 SQL・正規表現・認可条件・ファイル操作は必ず security-reviewer 対象 +- XSS / CSRF / IDOR / Path Traversal / SSRF を重点確認 +- 同一エラー再修復は **2 回まで**。3 回目は停止して Issue 化 +- AutoFix 後は必ず差分レビューを挟み、テスト通過を確認 + +--- + +## 📊 AI 役割分担 + +| AI | 担当領域 | +|---|---| +| ClaudeCode | 全体統制・テスト実行・デバッグ・修復 | +| CodeRabbit | 静的解析・スタイル・依存関係・secrets scan | +| Codex | アーキテクチャ・ロジック・セキュリティ設計 | diff --git a/Claude/templates/claude/ClaudeOS/core/00-goal-system.md b/Claude/templates/claude/ClaudeOS/core/00-goal-system.md new file mode 100644 index 00000000..f7fe778f --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/core/00-goal-system.md @@ -0,0 +1,165 @@ +# 🎯 ClaudeOS Goal System v9.0 + +## 目的 + +ClaudeOS における `/goal` を一元管理する。 + +全 Agent・CTO・CIManager・Codex・CodeRabbit は +本ファイルの `/goal` 定義を唯一の正本として扱うこと。 + +--- + +# 🧠 Goal-Driven Development 原則 + +ClaudeOS は： + +- 固定ループではなく Goal Driven +- `/goal` を最上位命令として扱う +- Goal 未達なら継続 +- Goal 達成なら適切に終了 +- 暴走は禁止 +- Security は常に最優先 + +--- + +# 🚀 標準 /goal テンプレート + +```text +/goal " +MVP Release Candidate を完成させる。 + +以下を実施対象とする： +- フロントエンド実装 +- バックエンド実装 +- データベース実装 +- セキュリティ実装 +- インフラ構成 +- CI/CD構築 +- テスト +- ドキュメント整備 + +優先順位： +1. 動作 +2. 安定性 +3. セキュリティ +4. 保守性 +5. UI改善 + +完了条件： +1. 全主要画面正常動作 +2. API疎通成功 +3. 認証認可正常 +4. DB CRUD成功 +5. CI成功 +6. Critical/High脆弱性ゼロ +7. E2E成功 +8. README完成 +9. Docker起動成功（docker-compose.yml がある場合のみ） +10. ローカル環境再現可能 + +今回対象外： +- 過剰なUI改善 +- Enterprise拡張 +- AI最適化 +- マイクロサービス化 +- 大規模リファクタ + +制約： +- 5時間以内 +- 修復ループ最大5回 +- 同一原因エラー2回まで +- 未検証merge禁止 +- Release期の新機能禁止 + +停止条件： +- MVP完成 +- CI成功 +- リリース条件達成 +- 修復ループ上限到達 +- Token枯渇 +- Context圧迫 +- Security Critical発生 + +or stop after 20 turns +" +``` + +--- + +# 👁 Agent View 必須ルール + +```bash +claude agents +``` + +必ず `/goal` 設定後に実行すること。 + +--- + +# 🤖 Agent Teams 必須ルール + +## パターンA（並列実装） + +- Backend +- Frontend +- QA + +## パターンB（品質強化） + +- CI修復 +- Security +- Regression Test + +## パターンC（設計検討） + +- Architect +- Research +- Devil's Advocate + +--- + +# 🚦 CTO 優先順位 + +| 優先度 | 状態 | 行動 | +|---|---|---| +| 1 | Security Critical | 即時対応 | +| 2 | CI失敗 | 修復 | +| 3 | Blocker | 解除 | +| 4 | /goal直結Issue | 実装 | +| 5 | 品質不足 | Verify | +| 6 | 改善 | 余裕時のみ | + +--- + +# 🚨 Global Stop Conditions + +```text +同一原因エラー2回 → Issue化 +修復3回失敗 → Blocked +5時間到達 → 終了 +Token枯渇 → 安全終了 +Context圧迫 → 即終了 +``` + +--- + +# 📊 KPI Gate + +| 状態 | 行動 | +|---|---| +| Security Critical > 0 | 強制Verify | +| CI失敗 | 修復 | +| test_pass_rate < 80% | QA強化 | +| blocker > 0 | Blocker解除 | + +--- + +# 📋 全ファイル共通ルール + +他 md ファイルでは `/goal` を再定義しない。 + +記載する場合は以下のみ許可： + +```text +詳細は 00-goal-system.md を参照 +``` diff --git a/Claude/templates/claude/ClaudeOS/core/01-session-startup.md b/Claude/templates/claude/ClaudeOS/core/01-session-startup.md new file mode 100644 index 00000000..a8a2d0f6 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/core/01-session-startup.md @@ -0,0 +1,109 @@ +# 01-session-startup — セッション開始・復元ルール (v9.0) + +## 🎯 目的 + +ClaudeOS v9.0 起動時に、`/goal` 設定・前回状態・GitHub・CI・Project の状況を必ず復元し、CTO の動的判断材料を整える。 + +--- + +## ✅ セッション開始時の必須処理 + +```text +1. state.json 読込（前回ゴール・KPI・blocked_issues 復元） +2. 週次フェーズ算出（start_date から自動計算） +3. GitHub Issues / Projects 状態取得 +4. CI 状態取得（gh run list --limit 5） +5. /goal 設定（達成条件 + or stop after N turns） +6. Agent View 起動（claude agents） +7. CTO 優先順位評価 → 最初のアクション決定 +8. 本セッションの作業方針を出力 +``` + +--- + +## 🎯 /goal 設定 + + +/goal +#"MVP Release Candidate を完成させる。完了条件: 全主要画面正常動作・API疎通成功・認証認可正常・DB CRUD成功・CI成功・Critical/High脆弱性ゼロ・E2Eテスト成功・README/運用手順完成・Docker起動成功・ローカル環境再現可能。停止条件: MVP完成・CI成功・リリース条件達成・修復ループ上限到達" +/goal " +MVP Release Candidate を完成させる。 + +優先順位： +1. 動作 +2. 安定性 +3. セキュリティ +4. 保守性 +5. UI改善 + +完了条件： +- 全主要機能動作 +- CI成功 +- Critical/High脆弱性ゼロ +- Docker再現成功（docker-compose.yml がある場合のみ） +- README完成 +- E2E成功 + +制約： +- 5時間以内 +- 修復ループ最大5回 +- 過剰リファクタ禁止 +- 新技術導入禁止 +- アーキテクチャ全面変更禁止 + +停止条件： +- MVP完成 +- リリース条件達成 +- 修復上限到達 +" + + +--- + +## 📤 必須出力 + +セッション開始時は必ず以下を出力する。 + +```text +[Session Restore Report v9.0] + +Project: +- name: +- start_date: +- release_deadline: +- week_phase: Week N → Build/Quality/Stabilize/Release + +/goal: +- current: (設定中の条件) +- status: active / not set + +GitHub: +- open_issues: +- active_prs: +- latest_ci_status: + +KPI: +- ci_success_rate: +- test_pass_rate: +- security_critical: +- blocker_count: + +blocked_issues: (あれば列挙) + +CTO Decision: +- 優先アクション: (§5 CTO優先順位テーブルに基づく) +- reason: +``` + +--- + +## 🚦 CTO 優先順位（v9.0 Dynamic Orchestration） + +| 優先度 | 状態 | 行動 | +|---|---|---| +| 1 | Security Critical | 即時対応（Agent Teams パターン B） | +| 2 | CI 失敗中 | 原因分析 + 最小差分修復 | +| 3 | Blocker Issue | 解除 | +| 4 | /goal 直結 Issue | 実装（パターン A 検討） | +| 5 | 検証不足 | 品質強化（パターン B） | +| 6 | 改善 | 余裕がある場合のみ | diff --git a/Claude/templates/claude/ClaudeOS/core/02-core-architecture.md b/Claude/templates/claude/ClaudeOS/core/02-core-architecture.md new file mode 100644 index 00000000..8da19abf --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/core/02-core-architecture.md @@ -0,0 +1,95 @@ +# 02-core-architecture — ClaudeOS v9.0 Core Architecture + +## 🧠 システム概要 + +ClaudeOS v9.0 は AI を単なる開発補助ではなく、AI 開発組織そのものとして統合動作させる。 +`/goal` コマンドで目標を設定し、CTO に全権委任する。Agent Teams で並列に動き、Agent View で監視する。 + +``` +止まらない。ただし暴走しない。 +必ず検証する。Goal 達成後は適切に終了する。 +``` + +--- + +## 🎯 統合対象 + +- `/goal` 駆動の自律継続開発（v2.1.139+ 公式機能） +- Agent Teams による並列協調開発（パターン A/B/C） +- Agent View（`claude agents`）によるセッション監視 +- 完全自律開発（CTO 委任） +- 5 時間セッション最適化 +- KPI 連動動的判断 +- 6 か月フェーズ制御 +- state.json 意思決定 AI +- GitHub Actions 自動修復 +- GitHub Projects 完全同期 +- AI Dev Factory +- Codex / CodeRabbit Review 補助 +- 終了報告と引き継ぎ + +--- + +## 📆 6 か月フェーズ制御 + +```text +現在週 = (today - start_date) / 7 +``` + +| 週 | フェーズ | 主目的 | Agent Teams | +|---|---|---|---| +| 1–8 | Build | 機能開発・基盤構築 | パターン A 多用 | +| 9–16 | Quality | 品質強化・テスト拡充 | パターン B 多用 | +| 17–20 | Stabilize | 安定化・バグ収束 | パターン B | +| 21–24 | Release | リリース準備・検証完了 | パターン B + Audit | + +--- + +## ⚖️ 時間配分 + +| フェーズ | Dev | Verify | Improve | +|---|---:|---:|---:| +| Build | 45 | 25 | 15 | +| Quality | 30 | 40 | 15 | +| Stabilize | 20 | 50 | 15 | +| Release | 5 | 55 | 20 | + +残り時間は Monitor / Reporting / Safety Buffer に割り当てる。 + +--- + +## 🔁 実行フロー（v9.0 動的判断） + +```text +/goal 設定 → state.json Read → CTO 優先順位評価 +→ 最適行動選択（Fix/Build/Verify/Improve） +→ Agent Teams spawn（必要時） +→ /goal 達成判定（Haiku）→ 次ターン or 終了 +``` + +フォールバック: `Monitor → Development → Verify → Improvement` + +--- + +## 📈 KPI 制御（v9.0） + +| 状態 | score | 行動 | +|---|---|---| +| security_critical > 0 | +5 | Security 最優先 | +| CI 失敗 | +3 | Verify / Repair | +| test_pass_rate < 0.8 | +2 | QA 強化 | +| blocker_count > 0 | +3 | Blocker 解除 | + +score ≥ 5 → 強制継続 / ≥ 3 → 継続 / ≥ 1 → 軽量 / 0 → 終了 + +--- + +## 🚫 強制ルール + +- Release 期は新機能禁止 +- Security は最優先 +- 未検証 merge 禁止 +- 同一原因エラーは **2 回まで**（3 回目は Issue 化） +- CI 修復は最大 **3 回まで** +- CLAUDE.md / settings.json / hooks の自己書き換え禁止 +- force push 禁止 diff --git a/Claude/templates/claude/ClaudeOS/core/03-state-json.md b/Claude/templates/claude/ClaudeOS/core/03-state-json.md new file mode 100644 index 00000000..a5b7e71e --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/core/03-state-json.md @@ -0,0 +1,102 @@ +# 03-state-json — state.json 仕様 (v9.0) + +## 🎯 目的 + +state.json は ClaudeOS の意思決定・継続判断・失敗学習・進捗復元の中核ファイル。 +v9.0 では `/goal` 条件・blocked_issues・learning パターンを正式に管理する。 + +--- + +## 🧠 state.json 完全版（v9.0） + +```json +{ + "project": { + "name": "project-name", + "start_date": "2026-01-01", + "release_deadline": "2026-07-01", + "phase_mode": "development" + }, + "goal": "Issue #XX-#YY 実装完了", + "phase": "Monitor", + "kpi": { + "success_rate_target": 0.9, + "ci_success_rate": 0.0, + "test_pass_rate": 0.0, + "security_critical": 0, + "blocker_count": 0 + }, + "execution": { + "max_duration_minutes": 300, + "repair_count": 0, + "max_repair": 3, + "same_error_limit": 2, + "loop_count": 0, + "phase": "Monitor", + "last_session_summary": "" + }, + "automation": { + "auto_issue_generation": true, + "self_evolution": true + }, + "stable": { + "stable_achieved": false, + "consecutive_success": 0 + }, + "completed_issues": [], + "blocked_issues": [], + "learning": { + "failure_patterns": [], + "success_patterns": [] + }, + "quality_gates": { + "lint": { "warning_threshold": 10, "error_threshold": 0 }, + "coverage": { "line_min": 70, "changed_files_min": 80 } + } +} +``` + +--- + +## 🔄 更新タイミング + +| タイミング | 更新内容 | +|---|---| +| セッション開始 | Read（前回状態復元） | +| Issue 完了時 | `completed_issues` 追記 | +| CI 状態変化時 | `kpi.ci_success_rate` 更新 | +| ブロッカー発生時 | `blocked_issues` 追記 | +| Verify 完了時 | `kpi.test_pass_rate` / `stable` 更新 | +| 学習発生時 | `learning.failure_patterns` / `success_patterns` 追記 | +| セッション終了時 | Write（最終状態保存）| + +毎ターン更新は不要。フェーズ遷移時のみ。 + +--- + +## 🧬 学習ルール（v9.0） + +### learning.failure_patterns + +以下を記録する（上限 20 件）： + +- 同一エラーで 2 回詰まったケース +- blocked_issues の原因 +- verify_subagent_missing 発生 + +### learning.success_patterns + +以下を記録する（上限 20 件）： + +- STABLE 達成時のセッションサマリー +- 修復成功手順 +- 有効だった Agent Teams パターン + +--- + +## 🚨 安全ルール + +- state.json が壊れている場合は `state.backup.json` を作成する +- JSON 構文エラー時は自動修復せず、修復 Issue を作成する +- `release_deadline` は原則変更禁止 +- `same_error_limit: 2` — 同一原因エラーは 2 回で Issue 化 diff --git a/Claude/templates/claude/ClaudeOS/core/04-agent-teams.md b/Claude/templates/claude/ClaudeOS/core/04-agent-teams.md new file mode 100644 index 00000000..98cb0688 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/core/04-agent-teams.md @@ -0,0 +1,126 @@ +# 04-agent-teams — Agent Teams 設計 (v9.0) + +## 🎯 目的 + +ClaudeOS v9.0 を単体 AI ではなく、複数役割を持つ仮想開発組織として運用する。 +`/goal` で設定した目標に対し、CTO が状況に応じてパターン A/B/C を自律選択する。 + +--- + +## 🧑‍💼 基本チーム構成 + +| Agent | 役割 | +|---|---| +| CTO | 全体判断・優先順位・/goal 管理・リリース責任 | +| Manager | Issue 管理・進捗管理・Project 同期 | +| Architect | 設計・技術選定・構造レビュー | +| DevAPI | API / Backend 実装 | +| DevUI | Frontend / UI 実装 | +| QA | テスト設計・品質保証 | +| Tester | 実行検証・再現確認 | +| CIManager | GitHub Actions / CI 修復 | +| Security | 脆弱性・権限・秘密情報確認 | +| ReleaseManager | リリース判定・最終報告 | +| CMDB-Agent | 構成管理・依存関係マップ・変更影響分析 | +| Audit-Agent | 変更証跡・ISO/J-SOX 規格準拠・監査レポート | + +--- + +## 🤝 Agent Teams パターン（v9.0 新設） + +### パターン A: 並列実装（複数機能の同時開発） + +``` +Lead: CTO（統制・統合） +Teammate 1: Backend 実装（API / DB / ロジック） +Teammate 2: Frontend 実装（UI / UX） +Teammate 3: テスト設計・検証 +``` + +使用場面: 複数機能の並列実装 + +### パターン B: 品質強化（CI 失敗修復・リリース前） + +``` +Lead: CTO（統制・判断） +Teammate 1: バグ修復・CI 修復 +Teammate 2: セキュリティレビュー +Teammate 3: 回帰テスト +``` + +使用場面: CI 失敗 + Security + テスト同時対応 + +### パターン C: 調査・設計（アーキテクチャ検討） + +``` +Lead: CTO（統制・意思決定） +Teammate 1: 技術調査 +Teammate 2: アーキテクチャ設計 +Teammate 3: Devil's Advocate（反証・リスク指摘） +``` + +使用場面: 大規模設計検討・多観点が必要な場面 + +--- + +## 👁 Agent View（v9.0） + +```bash +claude agents +``` + +| アイコン | 状態 | +|---|---| +| ✽ | Working（実行中） | +| ✻ | Needs Input（入力待ち） | +| ✙ | Idle（アイドル） | +| ✔ | Completed（完了） | +| ✘ | Failed（失敗） | + +操作: Space（Peek・返信）/ Enter（Attach・直接接続） + +**Agent View は監視・観測のみ担当。意思決定は CTO が行う。** + +--- + +## ⚖️ Sub-agent vs Agent Teams + +| 基準 | Sub-agent（Task） | Agent Teams | +|---|---|---| +| コンテキスト | 結果を呼び出し元に返す | 各自独立ウィンドウ | +| 通信 | 親エージェントへ報告のみ | Teammate 間で直接通信可 | +| トークンコスト | 低 | 高 | +| 使用場面 | Lint 修正・単機能・docs 更新 | 複数機能並列・多観点協調 | + +**Agent Teams 使用条件:** + +| 場面 | 判断 | +|---|---| +| 複数機能の並列実装 | ✅ パターン A | +| CI + Security + テスト同時 | ✅ パターン B | +| 大規模設計検討 | ✅ パターン C | +| 1 ファイル修正 / Lint / docs | ❌ Sub-agent で十分 | + +--- + +## 🔁 Agent ログフォーマット + +```text +[👔 CTO / 最高技術責任者] 判断: +[💻 Developer / デベロッパー] 実装: +[🧪 QA / 品質保証] 検証: +[🔒 Security / セキュリティ] リスク: +[⚙️ DevOps / 運用基盤] CI状態: +[🗄️ CMDB-Agent / 構成管理] 影響範囲分析: +[📋 Audit-Agent / 監査] 証跡確認・規格準拠: +``` + +--- + +## 🚫 禁止事項 + +- Agent 判断なしの merge +- QA 確認なしの Done 移動 +- Security 未確認の release +- Release 期の新機能追加 +- 同一原因エラーの無限修復（2 回で停止） diff --git a/Claude/templates/claude/ClaudeOS/execution/05-operations.md b/Claude/templates/claude/ClaudeOS/execution/05-operations.md new file mode 100644 index 00000000..7f621138 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/execution/05-operations.md @@ -0,0 +1,137 @@ +# 08-operations — 運用ルール (v9.0) + +## 🎯 目的 + +ClaudeOS v9.0 を `/goal` 駆動・動的判断モードで安全に運用する。 + +--- + +## 🔁 基本実行フロー（v9.0 動的判断） + +```text +/goal 設定 → CTO 優先順位評価 → 最適行動選択 → 実行 → /goal 達成判定 +``` + +フォールバック: `Monitor → Development → Verify → Improvement` + +--- + +## 👔 CTO 優先順位（v9.0） + +| 優先度 | 状態 | 行動 | +|---|---|---| +| 1 | Security Critical | 即時対応 | +| 2 | CI 失敗中 | 修復 | +| 3 | Blocker Issue | 解除 | +| 4 | /goal 直結 Issue | 実装 | +| 5 | 検証不足 | 品質強化 | +| 6 | 改善 | 余裕時のみ | + +--- + +## 🟢 Monitor + +確認対象: + +- state.json +- GitHub Issues +- GitHub Pull Requests +- GitHub Projects +- GitHub Actions +- backlog.md +- TODO.md +- docs/roadmap.md + +出力: + +```text +Monitor Report: +- current_phase: +- open_issues: +- active_prs: +- ci_status: +- blockers: +- next_target: +``` + +--- + +## 🔨 Development + +実施内容: + +- Issue選定 +- ブランチ作成 +- 最小単位実装 +- 必要テスト追加 +- 変更ログ作成 + +禁止: + +- Release期の新機能開発 +- 仕様外の大規模改修 +- テストなし修正 + +--- + +## ✅ Verify + +確認対象: + +- lint +- unit test +- integration test +- build +- security check +- PR review +- Codex review + +判定: + +```text +pass → Improvement or Done +fail → CIManager / Codex Debug +``` + +--- + +## 🧹 Improvement + +実施内容: + +- 小規模リファクタリング +- テスト補強 +- ドキュメント更新 +- state.json学習更新 +- Project同期 + +--- + +## 📋 GitHub Projects ステータス + +```text +Backlog → Todo → In Progress → Review → Verify → Done +``` + +| トリガー | 状態 | +|---|---| +| Issue生成 | Backlog | +| 開発開始 | In Progress | +| PR作成 | Review | +| CI実行 | Verify | +| 完了 | Done | + +--- + +## 🚨 Safety Guard（v9.0 Stop Conditions） + +``` +同一エラー同一原因 2 回連続 → Issue 化して次タスクへ +修復試行 3 回到達 → Blocked +コンテキスト圧迫警告 → 即終了処理 +``` + +- 残 60 分 → 最終ループ +- 残 15 分 → Verify のみ +- 残 5 分 → 終了処理 +- Security 最優先 diff --git a/Claude/templates/claude/ClaudeOS/execution/06-ci-automation.md b/Claude/templates/claude/ClaudeOS/execution/06-ci-automation.md new file mode 100644 index 00000000..9ce941bf --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/execution/06-ci-automation.md @@ -0,0 +1,37 @@ +# 06-ci-automation — GitHub Actions / CI 自動化 + +## 🎯 目的 + +CIをClaudeOSの品質ゲートとして扱い、失敗時は自動でIssue化し、CIManagerが修復対象として扱えるようにする。 + +--- + +## 🔁 CI対象 + +- npm install / npm ci +- lint +- test +- build +- artifact出力 +- CI失敗Issue作成 + +--- + +## 🚦 CI修復ルール + +| 条件 | 対応 | +|---|---| +| CI失敗 | Issue自動生成 | +| 同一エラー1回目 | 修復 | +| 同一エラー2回目 | Codex Debugへ依頼 | +| 同一エラー3回目 | 修復停止・別Issue化 | +| 修復5回到達 | 打ち切り | + +--- + +## 🚫 禁止事項 + +- CI未通過のmerge +- テスト未実行のDone移動 +- 同一エラーの無限修復 +- ログを残さない修正 diff --git a/Claude/templates/claude/ClaudeOS/execution/07-ai-dev-factory.md b/Claude/templates/claude/ClaudeOS/execution/07-ai-dev-factory.md new file mode 100644 index 00000000..6fa47882 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/execution/07-ai-dev-factory.md @@ -0,0 +1,72 @@ +# 07-ai-dev-factory — AI Dev Factory + +## 🎯 目的 + +ClaudeOS が backlog / TODO / CI / KPI / Review から自動的にIssue候補を生成し、開発対象を枯渇させない。 + +--- + +## 🏭 Issue自動生成条件 + +- CI失敗 +- KPI未達 +- テスト不足 +- セキュリティ指摘 +- backlog.md の未処理項目 +- TODOコメントの蓄積 +- docs/roadmap.md との差分 +- 既存Issueのブロッカー + +--- + +## 📝 Issueテンプレート + +```text +Title: [P1] 問題概要 + +Reason: +CI failure / KPI gap / test gap / security risk + +Context: +- 発生箇所: +- 関連ファイル: +- 関連Issue: +- 関連PR: + +Acceptance: +- 再現可能 +- 修正可能 +- テスト可能 +- CI通過 +- 影響範囲が説明されている + +Priority: +P1 / P2 / P3 + +Owner: +ClaudeOS / CIManager / QA / Security +``` + +--- + +## 📊 優先順位 + +| 優先度 | 条件 | +|---|---| +| P1 | Security / CI停止 / Release阻害 | +| P2 | テスト不足 / 品質低下 | +| P3 | 改善 / リファクタリング | +| P4 | 将来案 / 調査 | + +--- + +## 🚫 Release期の制約 + +Release期に生成された新機能Issueは原則Backlogへ回す。 + +ただし、以下は例外。 + +- Security修正 +- Release阻害バグ +- データ破損リスク +- ビルド不能 diff --git a/Claude/templates/claude/ClaudeOS/execution/08-termination-reporting.md b/Claude/templates/claude/ClaudeOS/execution/08-termination-reporting.md new file mode 100644 index 00000000..d3653af8 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/execution/08-termination-reporting.md @@ -0,0 +1,101 @@ +# 09-termination-reporting — 終了処理・報告 + +## 🎯 目的 + +ClaudeOS セッション終了時に、作業結果・検証結果・未完了事項・次回引継ぎを明確に残す。 + +--- + +## 🧾 終了処理 + +```text +1. 変更差分確認 +2. test / lint / build 結果確認 +3. state.json更新 +4. GitHub Project更新 +5. 必要なら commit +6. 必要なら push +7. 必要なら PR作成 +8. 終了報告作成 +``` + +--- + +## ✅ commit / push / PR ルール + +| 条件 | 対応 | +|---|---| +| 変更あり + 検証成功 | commit / push / PR | +| 変更あり + 検証失敗 | commit禁止、修復Issue作成 | +| docsのみ | 軽量検証後commit可 | +| Security未確認 | merge禁止 | +| CI未通過 | merge禁止 | + +--- + +## 📤 終了報告テンプレート + +```text +# ClaudeOS Session Report + +## Summary +- Project: +- Phase: +- Week: +- Session Duration: +- Loop Count: + +## Completed +- +- + +## Changed Files +- + +## Verification +- lint: +- test: +- build: +- CI: + +## KPI +- ci_success_rate: +- test_pass_rate: +- review_blocker_count: +- security_issue_count: +- score: + +## GitHub +- Issues updated: +- PR created: +- Project status: + +## Learning +### Failure Patterns +- + +### Success Patterns +- + +## Risks +- + +## Next Actions +1. +2. +3. + +## Final Decision +- stable: true / false +- next_session_mode: Monitor / Development / Verify / Improvement +``` + +--- + +## 🚫 終了時の禁止事項 + +- 検証失敗を隠す +- state.jsonを更新しない +- PRだけ作ってCI未確認 +- Projectステータスを放置 +- 次回アクションを残さない diff --git a/Claude/templates/claude/ClaudeOS/execution/github-actions-ci-manager.yml b/Claude/templates/claude/ClaudeOS/execution/github-actions-ci-manager.yml new file mode 100644 index 00000000..c510bb1c --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/execution/github-actions-ci-manager.yml @@ -0,0 +1,131 @@ +name: ClaudeOS CI Manager + +on: + push: + branches: + - main + - develop + - "feature/**" + - "fix/**" + pull_request: + branches: + - main + workflow_dispatch: + +permissions: + contents: read + issues: write + pull-requests: write + actions: read + +jobs: + build-test: + name: Build / Lint / Test / Build + runs-on: ubuntu-latest + + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Setup Node + uses: actions/setup-node@v4 + with: + node-version: "20" + cache: "npm" + + - name: Install Dependencies + run: | + npm ci || npm install + + - name: Lint + run: | + npm run lint --if-present + + - name: Test + run: | + npm test --if-present + + - name: Build + run: | + npm run build --if-present + + - name: KPI Success Marker + if: success() + run: | + echo "CI SUCCESS" > ci_result.txt + echo "status=success" >> "$GITHUB_OUTPUT" + + - name: Upload CI Result + if: always() + uses: actions/upload-artifact@v4 + with: + name: claudeos-ci-result + path: | + ci_result.txt + if-no-files-found: ignore + + check-release-milestone: + name: Validate 6-month Release Milestone + runs-on: ubuntu-latest + steps: + - name: Check Production Release Milestone + uses: actions/github-script@v7 + with: + script: | + const { data: milestones } = await github.rest.issues.listMilestones({ + owner: context.repo.owner, + repo: context.repo.repo, + state: 'open' + }); + const release = milestones.find(m => + /release|production|リリース|本番/i.test(m.title) + ); + if (!release) { + core.warning( + 'Production Release マイルストーンが未設定です。' + + 'プロジェクト開始から6ヶ月以内のマイルストーンを GitHub Projects に設定してください。' + ); + } else { + const due = release.due_on ? new Date(release.due_on) : null; + core.notice(`Production Release milestone: "${release.title}" due=${due ? due.toISOString().slice(0,10) : 'unset'}`); + } + + auto-repair-issue: + name: Create CI Repair Issue + needs: build-test + if: failure() + runs-on: ubuntu-latest + + steps: + - name: Create CI Failure Issue + uses: actions/github-script@v7 + with: + script: | + const title = `[P1] CI failure detected: ${context.workflow}`; + const body = ` + ## Reason + CI failure / KPI gap + + ## Workflow + - Name: ${context.workflow} + - Run ID: ${context.runId} + - Branch: ${context.ref} + + ## Acceptance + - 再現可能 + - 修正可能 + - テスト可能 + - CIが再成功する + + ## ClaudeOS Instruction + CIManager はこのIssueを確認し、最大5回まで修復を試行する。 + 同一エラーは2回までとし、超過時は別Issueへ切り替える。 + `; + + await github.rest.issues.create({ + owner: context.repo.owner, + repo: context.repo.repo, + title, + body, + labels: ["claudeos", "ci-failure", "P1"] + }); diff --git a/Claude/templates/claude/ClaudeOS/goals/hotfix.md b/Claude/templates/claude/ClaudeOS/goals/hotfix.md new file mode 100644 index 00000000..251d2f73 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/goals/hotfix.md @@ -0,0 +1,25 @@ +# Goal: Hotfix + +/goal " +本番環境の緊急バグを最小差分で修正する。 + +完了条件： +- バグ再現確認済み +- 最小差分で修正完了 +- 修正箇所のテスト追加 +- CI成功 +- 影響範囲レビュー完了 +- PR作成済み（hotfix/ ブランチ） + +制約： +- 関係ない箇所は一切触らない +- リファクタリング禁止 +- 新機能追加禁止 +- 修復試行 3 回まで +- 2時間以内 + +停止条件： +- バグ修正完了・CI成功 +- 修復上限到達 → Issue化して次アクションへ +- or stop after 10 turns +" diff --git a/Claude/templates/claude/ClaudeOS/goals/mvp-release.md b/Claude/templates/claude/ClaudeOS/goals/mvp-release.md new file mode 100644 index 00000000..88b55bae --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/goals/mvp-release.md @@ -0,0 +1,44 @@ +# Goal: MVP Release + +/goal " +MVP Release Candidate を完成させる。 + +優先順位： +1. 動作 +2. 安定性 +3. セキュリティ +4. 保守性 +5. UI改善 + +完了条件： +- 全主要機能動作 +- API疎通成功 +- 認証認可正常 +- DB CRUD成功 +- CI成功 +- Critical/High脆弱性ゼロ +- E2Eテスト成功 +- README/運用手順完成 +- Docker起動成功（docker-compose.yml がある場合のみ） +- ローカル環境再現可能 + +対象外： +- 過剰なUI改善 +- Enterprise拡張機能 +- AI最適化 +- マイクロサービス分離 +- 過剰なリファクタリング + +制約： +- 5時間以内 +- 修復ループ最大5回 +- 過剰リファクタ禁止 +- 新技術導入禁止 +- アーキテクチャ全面変更禁止 + +停止条件： +- MVP完成 +- リリース条件達成 +- 修復上限到達 +- or stop after 20 turns +" diff --git a/Claude/templates/claude/ClaudeOS/goals/production-release.md b/Claude/templates/claude/ClaudeOS/goals/production-release.md new file mode 100644 index 00000000..d859978c --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/goals/production-release.md @@ -0,0 +1,26 @@ +# Goal: Production Release + +/goal " +本番リリース準備を完成させる。 + +完了条件： +- STABLE N=5 達成（認証・DB 変更を含むため） +- 全 E2E テスト通過 +- セキュリティ最終スキャン Critical/High 0 件 +- パフォーマンス劣化なし +- Gate-3 チェックリスト全件実行済み +- README・運用手順・ロールバック手順完成 +- deploy.ready=true 設定済み +- 人間サインオフ取得待ち状態に到達 + +制約： +- 新機能追加禁止 +- 大規模リファクタ禁止 +- schema 変更禁止 +- 5時間以内 + +停止条件： +- リリース条件全達成 +- deploy.ready=true 設定完了 +- or stop after 15 turns +" diff --git a/Claude/templates/claude/ClaudeOS/goals/refactoring.md b/Claude/templates/claude/ClaudeOS/goals/refactoring.md new file mode 100644 index 00000000..05d59b52 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/goals/refactoring.md @@ -0,0 +1,24 @@ +# Goal: Refactoring + +/goal " +技術負債を解消し、保守性・可読性を向上させる。 + +完了条件： +- 対象の技術負債を特定・文書化 +- リファクタリング完了 +- 既存テスト全通過（機能変更なし） +- lint success +- CI成功 +- PR作成済み + +制約： +- 機能追加・変更禁止 +- API 仕様変更禁止 +- DB スキーマ変更禁止 +- テストが壊れる変更禁止 +- 5時間以内 + +停止条件： +- リファクタリング完了・テスト全通過 +- or stop after 20 turns +" diff --git a/Claude/templates/claude/ClaudeOS/goals/security-emergency.md b/Claude/templates/claude/ClaudeOS/goals/security-emergency.md new file mode 100644 index 00000000..d3b6d550 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/goals/security-emergency.md @@ -0,0 +1,24 @@ +# Goal: Security Emergency + +/goal " +Critical セキュリティ脆弱性を即時対応する。 + +完了条件： +- 脆弱性の影響範囲特定完了 +- 修正完了（最小差分） +- セキュリティスキャン Critical/High 0 件 +- 回帰テスト通過 +- CI成功 +- Post-mortem 記録済み +- PR作成済み + +制約： +- Agent Teams パターン B を即時起動 +- Security Agent を最優先で使用 +- 影響範囲外は一切触らない +- 1時間以内に初期対応完了 + +停止条件： +- 脆弱性解消・CI成功 +- or stop after 8 turns +" diff --git a/Claude/templates/claude/ClaudeOS/governance/17-project-governance.md b/Claude/templates/claude/ClaudeOS/governance/17-project-governance.md new file mode 100644 index 00000000..12ced20e --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/governance/17-project-governance.md @@ -0,0 +1,68 @@ +# 17-project-governance — プロジェクトガバナンス + +## 🎯 目的 + +Issue 駆動開発・PR 必須・CI ゲートによりプロジェクトの健全性を維持する。 + +--- + +## 📋 Issue 駆動開発 + +- Issue なし作業禁止 +- 重複 Issue 禁止 +- P1 未解決なら P3 抑制 + +| レベル | 対象 | +|---|---| +| P1 | CI / セキュリティ / データ影響 | +| P2 | 品質 / UX / テスト | +| P3 | 軽微改善 | + +--- + +## 🔁 GitHub Projects 状態遷移 + +```text +Inbox → Backlog → Ready → Design → Development → Verify → Deploy Gate → Done / Blocked +``` + +- セッション開始・終了時、各ループ終了時に更新 +- 接続不可なら「未接続」または「不明」と明記 + +--- + +## 📖 Git / GitHub ルール + +- main 直接 push 禁止 +- branch または WorkTree 必須 +- PR 必須（Draft 可） +- CI 成功のみ merge 許可 + +### PR 本文の最低限 + +- 変更内容 +- テスト結果 +- 影響範囲 +- 残課題 + +--- + +## 🌿 WorkTree 運用 + +向いている場面: +- 1 Issue = 1 WorkTree +- 複数機能の並列開発 + +不要な場面: +- 1 ファイルの小修正 +- ドキュメント更新のみ + +--- + +## 📖 README 更新基準 + +以下のいずれかが変わったら更新する: +- 利用者が触る機能 +- セットアップ手順 +- アーキテクチャ +- 品質ゲート diff --git a/Claude/templates/claude/ClaudeOS/governance/18-release-policy.md b/Claude/templates/claude/ClaudeOS/governance/18-release-policy.md new file mode 100644 index 00000000..239d2d6b --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/governance/18-release-policy.md @@ -0,0 +1,68 @@ +# 18-release-policy — リリースポリシー + +## 🎯 目的 + +リリース判断基準・フェーズ制御・デプロイ手順を定義し、安全なリリースを保証する。 + +--- + +## ✅ STABLE 判定条件（全必須） + +- test success +- lint success +- build success +- CI success +- review OK +- security OK +- error 0 +- 検証チェックリスト Gate-1 実行済み +- 検証チェックリスト Gate-2 実行済み（PR 作成時必須） + +| 変更規模 | 連続成功回数 | +|---|---| +| 小規模 | N=2 | +| 通常 | N=3 | +| 重要（認証・DB） | N=5 | + +**STABLE 未達は merge / deploy 禁止。** + +--- + +## 📆 週次フェーズ制御（6 か月プロジェクト） + +| 週 | フェーズ | 行動重点 | +|---|---|---| +| 1–8 | Build | 実装優先 | +| 9–16 | Quality | テスト・レビュー強化 | +| 17–20 | Stabilize | 新機能凍結・CI 安定化 | +| 21–24 | Release | 変更最小化・セキュリティ最終確認 | + +--- + +## 🚫 Release 期（Stabilize / Release フェーズ）追加禁止 + +- 新機能追加 +- 大規模リファクタ +- schema 変更 + +--- + +## 🚀 デプロイポリシー + +- CTO が「デプロイ準備完了」と判断したら `deploy.ready=true` を設定し手順書を自動生成 +- 実際のデプロイ実行は**人間（ユーザー）が手動**で行う +- デプロイ完了後: `maintenance.phase_mode="maintenance"` を設定 → 保守フェーズへ移行 + +--- + +## 📋 リリース判断チェックリスト（Gate-3） + +```text +□ 全 STABLE 条件クリア +□ E2E テスト全通過 +□ セキュリティスキャン Critical/High 0 件 +□ パフォーマンス劣化なし +□ README / 運用手順完成 +□ ロールバック手順確認 +□ 人間サインオフ取得 +``` diff --git a/Claude/templates/claude/ClaudeOS/governance/19-security-policy.md b/Claude/templates/claude/ClaudeOS/governance/19-security-policy.md new file mode 100644 index 00000000..508aad51 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/governance/19-security-policy.md @@ -0,0 +1,43 @@ +# 19-security-policy — セキュリティポリシー + +## 🎯 目的 + +ClaudeOS 全セッションで Security First を徹底し、脆弱性ゼロを維持する。 + +--- + +## 🔐 Security First 原則 + +- Security Critical 検出 → **即時対応（最優先）** +- Agent Teams パターン B を自動発動 +- 未解消 Critical/High は merge 禁止 + +--- + +## 🛡 必須確認項目 + +| カテゴリ | 確認内容 | +|---|---| +| Secrets | .env 漏洩 / API キーハードコード / トークン露出 | +| 認証・認可 | JWT 検証 / RBAC / 権限昇格 / IDOR | +| 入力検証 | XSS / SQLi / Command Injection / Path Traversal | +| 通信 | HTTPS 強制 / TLS バージョン / HSTS / Secure Cookie | +| 依存関係 | npm audit / CVE Scan / Dependabot アラート | + +--- + +## 🔁 Security Agent 起動タイミング + +- Verify フェーズ: security-reviewer 必須参加 +- PR 作成前: secrets scan 必須 +- Release 前: 最終セキュリティスキャン + +--- + +## 🚫 禁止事項（セキュリティ関連） + +- secrets のコミット +- HTTP での認証情報送信 +- 権限チェックなしの API エンドポイント +- セキュリティ例外の無断承認 +- force push による審査回避 diff --git a/Claude/templates/claude/ClaudeOS/governance/20-audit-policy.md b/Claude/templates/claude/ClaudeOS/governance/20-audit-policy.md new file mode 100644 index 00000000..3b6a92b2 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/governance/20-audit-policy.md @@ -0,0 +1,58 @@ +# 20-audit-policy — 監査ポリシー + +## 🎯 目的 + +変更証跡の完全性を保証し、ISO/J-SOX 規格準拠・監査レポートの自動生成を実現する。 + +--- + +## 🗄 CMDB-Agent 運用 + +**起動タイミング**: Monitor フェーズ末尾 + +```text +[🗄️ CMDB-Agent / 構成管理] 影響範囲分析: +- 変更のある構成アイテム差分を確認 +- 影響範囲を次フェーズに引き渡す +``` + +--- + +## 📋 Audit-Agent 運用 + +**起動タイミング**: Verify フェーズ末尾 + Release 直前 + +```text +[📋 Audit-Agent / 監査] 証跡確認・規格準拠: +- 変更証跡の完全性を確認 +- 規格非準拠があれば Issue 起票後に CTO へエスカレーション +``` + +--- + +## 📜 変更証跡の必須要素 + +- commit hash + 変更内容 +- Issue 番号との紐付け +- テスト結果（Pass/Fail） +- レビュー承認記録（PR merge 記録） +- CI 実行結果 + +--- + +## 🔁 監査ログ出力 + +```text +## 検証サマリー +### 実行した検証（件数・証跡 URL） +### 未実行の検証（件数・項目番号） +### 未実行理由 +``` + +--- + +## 🚫 禁止事項 + +- Post-mortem 未記録の P1 クローズ +- 変更証跡なしの deploy +- 監査ログの改ざん・削除 diff --git a/Claude/templates/claude/ClaudeOS/quality/09-webui-testing.md b/Claude/templates/claude/ClaudeOS/quality/09-webui-testing.md new file mode 100644 index 00000000..380fc4b2 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/quality/09-webui-testing.md @@ -0,0 +1,343 @@ +# 10 — WebUI ベース システム開発 全テスト検証・デバッグ（最終指示） + +残りの時間で以下のテスト検証・デバッグができますか？ +時間許す限りでOKです。まずは検証したうえでCTOの判断で実行してみてください。 +終了後のコミット、プッシュ、PR、マージを実行してください。 + +--- + +# 🚀 ClaudeCodeでのWebUIベース システム開発 +## フロントエンド／バックエンド 全テスト検証・デバッグ項目一覧 + +--- + +# 🎨 フロントエンド 全テスト検証・デバッグ項目 + +--- + +## 1. 画面表示テスト（UI Rendering） + +1. 全画面が正常表示される +2. CSS崩れがない +3. フォント崩れがない +4. アイコン表示正常 +5. ダークモード対応確認 +6. 解像度変更時の崩れ確認 +7. ブラウザズーム対応 +8. 125%/150% DPI対応 +9. スクロール表示確認 +10. モーダル表示正常 +11. ツールチップ表示正常 +12. テーブル列崩れ確認 +13. サイドメニュー開閉確認 +14. アコーディオン動作確認 +15. ローディングUI表示確認 +16. 404画面表示確認 +17. 500エラー画面確認 +18. 長文表示確認 +19. 日本語表示崩れ確認 +20. Unicode/絵文字表示確認 + +--- + +# 📱 レスポンシブ・端末対応 + +21. Windows Edge確認 +22. Chrome確認 +23. Firefox確認 +24. iPad表示確認 +25. Android表示確認 +26. 画面回転対応 +27. タッチ操作確認 +28. キーボード操作確認 +29. タブ移動確認 +30. モバイルメニュー確認 + +--- + +# ⚡ JavaScript動作確認 + +31. JSエラー有無 +32. Console Error確認 +33. Promise失敗時処理 +34. 非同期通信成功確認 +35. 非同期通信失敗確認 +36. APIタイムアウト確認 +37. ボタン連打確認 +38. 二重送信防止 +39. イベント重複発火確認 +40. localStorage動作 +41. sessionStorage動作 +42. Cookie保存確認 +43. ブラウザ戻る対応 +44. 画面リロード確認 +45. SPAルーティング確認 +46. キャッシュ更新確認 +47. ServiceWorker確認 +48. WebSocket確認 +49. リアルタイム更新確認 +50. JSメモリリーク確認 + +--- + +# 🧪 入力フォーム検証 + +51. 必須チェック +52. 空文字確認 +53. NULL送信確認 +54. 数値入力制限 +55. 文字数制限 +56. 禁止文字確認 +57. メール形式確認 +58. 電話番号形式確認 +59. 日付形式確認 +60. CSVアップロード確認 +61. ファイルサイズ制限 +62. 拡張子制限 +63. ドラッグ＆ドロップ確認 +64. 日本語IME入力確認 +65. Enter送信誤動作確認 +66. バリデーション表示確認 +67. リアルタイム検証確認 +68. エラーメッセージ確認 +69. 入力復元確認 +70. 多重Submit確認 + +--- + +# 🔐 フロントエンドセキュリティ + +71. XSS対策確認 +72. CSRF対策確認 +73. CSP確認 +74. Cookie Secure確認 +75. HttpOnly確認 +76. Token漏洩確認 +77. JWT保存方法確認 +78. URL直打ち確認 +79. 権限外画面遷移確認 +80. DevTools改ざん確認 +81. HTML改ざん確認 +82. JS難読化確認 +83. 秘密情報埋め込み確認 +84. APIキー露出確認 +85. HTTPS強制確認 + +--- + +# 🚀 フロントエンド性能試験 + +86. 初回表示速度 +87. API応答速度 +88. 画像読込速度 +89. JS読込速度 +90. CSS最適化確認 +91. LazyLoad確認 +92. Bundleサイズ確認 +93. Lighthouse確認 +94. FCP確認 +95. LCP確認 +96. CLS確認 +97. FPS確認 +98. CPU使用率確認 +99. メモリ使用量確認 +100. 長時間稼働確認 + +--- + +# 🧠 UX・運用系確認 + +101. 操作直感性確認 +102. エラー時誘導確認 +103. トースト通知確認 +104. 成功メッセージ確認 +105. 多言語化確認 +106. アクセシビリティ確認 +107. 色覚対応確認 +108. 音声読み上げ確認 +109. 運用マニュアル整合 +110. 操作ログ出力確認 + +--- + +# ⚙️ バックエンド 全テスト検証・デバッグ項目 + +--- + +# 🧩 APIテスト + +111. GET正常系 +112. POST正常系 +113. PUT正常系 +114. DELETE正常系 +115. HTTPステータス確認 +116. JSON形式確認 +117. NULL応答確認 +118. 不正JSON確認 +119. Content-Type確認 +120. APIタイムアウト確認 +121. APIリトライ確認 +122. API認証確認 +123. API認可確認 +124. APIレート制限確認 +125. API例外処理確認 +126. APIログ確認 +127. API監査ログ確認 +128. OpenAPI整合確認 +129. Swagger整合確認 +130. APIバージョン確認 + +--- + +# 🗄 DBテスト + +131. DB接続確認 +132. 接続プール確認 +133. CRUD確認 +134. トランザクション確認 +135. Rollback確認 +136. 排他制御確認 +137. Index動作確認 +138. SQL性能確認 +139. N+1問題確認 +140. 大量データ確認 +141. SQL Injection対策 +142. 文字コード確認 +143. NULLデータ確認 +144. 日付保存確認 +145. タイムゾーン確認 +146. Backup確認 +147. Restore確認 +148. Migration確認 +149. ORM整合確認 +150. DB障害時確認 + +--- + +# 🔐 バックエンドセキュリティ + +151. JWT認証確認 +152. Session認証確認 +153. OAuth確認 +154. SAML確認 +155. Entra ID連携確認 +156. HENNGE連携確認 +157. LDAP/AD連携確認 +158. 権限昇格確認 +159. IDOR確認 +160. Command Injection確認 +161. Path Traversal確認 +162. SSRF確認 +163. RCE確認 +164. ファイルアップロード脆弱性 +165. Virus Scan確認 +166. 秘密情報管理確認 +167. .env漏洩確認 +168. HTTPS証明書確認 +169. TLSバージョン確認 +170. Security Header確認 + +--- + +# ⚡ バックエンド性能試験 + +171. 同時接続確認 +172. 負荷試験 +173. ストレス試験 +174. Soak Test +175. CPU使用率確認 +176. メモリリーク確認 +177. GC確認 +178. Queue確認 +179. Redis確認 +180. Cache確認 +181. 非同期Job確認 +182. Worker停止確認 +183. Failover確認 +184. Auto Recovery確認 +185. Kubernetes確認 +186. Docker確認 +187. Container Restart確認 +188. ログ肥大化確認 +189. Disk使用量確認 +190. Thread枯渇確認 + +--- + +# 🧪 バッチ・ジョブ系 + +191. 定期実行確認 +192. Cron確認 +193. 多重起動防止 +194. リトライ確認 +195. 失敗通知確認 +196. Mail通知確認 +197. Teams通知確認 +198. ログローテーション +199. 日跨ぎ確認 +200. 月末処理確認 + +--- + +# 🔍 運用監視・ログ確認 + +201. アプリログ確認 +202. エラーログ確認 +203. 監査ログ確認 +204. 操作ログ確認 +205. Syslog確認 +206. SIEM連携確認 +207. メトリクス確認 +208. Prometheus確認 +209. Grafana確認 +210. アラート通知確認 + +--- + +# 🔥 障害試験（超重要） + +211. DB停止時 +212. API停止時 +213. Redis停止時 +214. NW断時 +215. DNS障害時 +216. SSL期限切れ時 +217. ディスクFull時 +218. CPU100%時 +219. メモリ枯渇時 +220. Worker異常停止時 +221. サーバ再起動時 +222. VM移行時 +223. Windows Update後 +224. Linux Patch後 +225. 時刻同期ズレ確認 + +--- + +# 🤖 ClaudeCode時代に追加すべきAI開発系検証 + +226. 自動生成コード品質確認 +227. AI生成SQL確認 +228. AI生成API確認 +229. AI生成HTML確認 +230. AI生成JS確認 +231. 型安全確認 +232. Linter確認 +233. Formatter確認 +234. UnitTest自動生成確認 +235. E2E自動化確認 +236. Playwright確認 +237. CI/CD確認 +238. GitHub Actions確認 +239. CodeRabbit確認 +240. Dependabot確認 +241. Secret Scan確認 +242. SBOM確認 +243. OSSライセンス確認 +244. CLAUDE.md整合確認 +245. Agent Team競合確認 +246. WorkTree競合確認 +247. AutoFix暴走確認 +248. Loop暴走確認 +249. Token消費監視 +250. AI誤修復確認 diff --git a/Claude/templates/claude/ClaudeOS/quality/10-security-testing.md b/Claude/templates/claude/ClaudeOS/quality/10-security-testing.md new file mode 100644 index 00000000..f143cfcc --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/quality/10-security-testing.md @@ -0,0 +1,81 @@ +# 10-security-testing — セキュリティ テスト検証・デバッグ指示 + +## 🎯 目的 + +OWASP Top10 を基準にセキュリティ全領域を検査し、Critical/High 脆弱性ゼロを維持する。 + +--- + +## 🔐 認証・認可検証 + +1. MFA +2. JWT +3. Session +4. RBAC +5. Admin 権限 +6. Password Policy +7. Token 期限 +8. Logout + +--- + +## 🛡 脆弱性検証（OWASP Top10 必須） + +1. SQL Injection +2. XSS +3. CSRF +4. SSRF +5. Directory Traversal +6. Command Injection +7. File Upload 攻撃 +8. Clickjacking +9. Open Redirect +10. XXE + +--- + +## 🌐 通信セキュリティ + +1. HTTPS 強制 +2. TLS 確認 +3. HSTS +4. Secure Cookie +5. CSP Header +6. CORS 制御 + +--- + +## 📜 ログ・監査 + +1. 監査ログ +2. 改ざん耐性 +3. マスキング +4. SIEM 連携 +5. 異常検知 + +--- + +## 🐞 セキュリティデバッグツール + +```bash +OWASP ZAP / BurpSuite +npm audit / pip-audit +Dependabot +SAST / DAST +CVE Scan +``` + +--- + +## 🚨 AI 生成コード重点確認 + +- AI 生成 SQL・正規表現・認可条件・ファイル操作は必ず security-reviewer 対象とする +- XSS / CSRF / IDOR / Path Traversal / SSRF は AI 生成コードで特に重点確認 + +--- + +## 🚫 禁止事項 + +- Critical/High 未解消のまま merge +- セキュリティ例外の無断承認 +- Secret のハードコード diff --git a/Claude/templates/claude/ClaudeOS/quality/11-infrastructure-testing.md b/Claude/templates/claude/ClaudeOS/quality/11-infrastructure-testing.md new file mode 100644 index 00000000..b126ad27 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/quality/11-infrastructure-testing.md @@ -0,0 +1,81 @@ +# 11-infrastructure-testing — インフラ テスト検証・デバッグ指示 + +## 🎯 目的 + +サーバ・ネットワーク・ストレージ・監視の全インフラ層を検証し、可用性と耐障害性を確認する。 + +--- + +## 🖥 サーバ検証 + +1. Linux +2. Windows Server +3. systemd +4. Cron +5. Docker +6. Kubernetes +7. VM +8. NTP + +--- + +## 🌐 ネットワーク検証 + +1. DNS +2. Ping +3. HTTPS +4. Firewall +5. VPN +6. Proxy +7. LoadBalancer +8. Port 確認 + +--- + +## 💾 ストレージ検証 + +1. Disk 容量 +2. IOPS +3. Backup +4. Restore +5. Snapshot +6. RAID +7. NAS +8. SMB/NFS + +--- + +## 📈 監視・運用検証 + +1. CPU 監視 +2. Memory 監視 +3. Disk 監視 +4. Alert 通知 +5. Grafana +6. Prometheus +7. Zabbix +8. 自動復旧 + +--- + +## 🔥 障害試験（重要） + +| シナリオ | 確認内容 | +|---|---| +| DB 停止時 | API フォールバック動作 | +| API 停止時 | フロントエンドのエラー表示 | +| Redis 停止時 | キャッシュ迂回動作 | +| NW 断時 | タイムアウト・リトライ | +| Disk Full 時 | ログローテーション動作 | +| Container Restart | 自動復旧確認 | + +--- + +## 🐞 インフラデバッグ + +```bash +journalctl / dmesg +OOM 確認 / Docker Logs +tcpdump / Wireshark +SSH Logs / Kernel Panic +``` diff --git a/Claude/templates/claude/ClaudeOS/quality/12-database-testing.md b/Claude/templates/claude/ClaudeOS/quality/12-database-testing.md new file mode 100644 index 00000000..fb9edcd7 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/quality/12-database-testing.md @@ -0,0 +1,71 @@ +# 12-database-testing — データベース テスト検証・デバッグ指示 + +## 🎯 目的 + +DB の正確性・性能・セキュリティを全層で検証し、データ損失・不整合ゼロを維持する。 + +--- + +## 🗄 DB 基本検証 + +1. CRUD +2. Transaction +3. Commit/Rollback +4. FK 制約 +5. Index +6. View +7. Procedure + +--- + +## ⚡ パフォーマンス検証 + +1. Slow Query +2. Full Scan +3. Query Plan +4. Lock +5. Deadlock +6. Connection Pool +7. Cache Hit 率 + +--- + +## 🔄 データ整合性検証 + +1. NULL 制御 +2. 型不一致 +3. 文字コード +4. 日付型 +5. 重複データ +6. Migration +7. Backup/Restore + +--- + +## 🔐 DB セキュリティ検証 + +1. 認証 +2. 権限制御 +3. SQL Injection +4. 暗号化 +5. 監査ログ +6. 接続元制限 + +--- + +## 🐞 DB デバッグ + +```bash +EXPLAIN / Query Trace +Replication / WAL/Binlog +Buffer 確認 / Fragmentation +Connection Leak +``` + +--- + +## 🚫 禁止事項 + +- Migration 未確認のスキーマ変更 +- トランザクション外の複数テーブル更新 +- SQL Injection 対策なしのクエリ生成 diff --git a/Claude/templates/claude/ClaudeOS/quality/13-e2e-playwright.md b/Claude/templates/claude/ClaudeOS/quality/13-e2e-playwright.md new file mode 100644 index 00000000..dc603ef1 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/quality/13-e2e-playwright.md @@ -0,0 +1,106 @@ +# 13-e2e-playwright — E2E テスト・CI/CD 統合指示 + +## 🎯 目的 + +Playwright を用いた E2E テストと CI/CD 連携により、全エンドツーエンドの品質を自動保証する。 + +--- + +## 🚀 E2E テスト（Playwright 必須） + +以下を実施すること。 + +1. ログイン +2. CRUD +3. 承認フロー +4. CSV アップロード +5. PDF 出力 +6. モバイル UI +7. 権限制御 +8. エラー画面 +9. タイムアウト +10. 多重操作 + +--- + +## 🔄 CI/CD 連携指示 + +GitHub Actions と完全連携。以下を自動実行。 + +```yaml +Lint +UnitTest +E2E（Playwright） +SecurityScan +Build +DeployCheck +RegressionTest +``` + +--- + +## 🧠 自動修復ルール + +1. エラー解析 +2. 根本原因分析（RCA） +3. 修復 +4. 再テスト +5. RegressionTest +6. ログ記録 + +**上限制御:** +- CI 自動修復: 最大 5 回 +- 同一原因エラー 2 回連続 → Issue 化して次タスクへ +- 修復試行 3 回到達 → Blocked + +--- + +## 🤖 AI レビュー統合フロー + +```text +開発 + ↓ +① /coderabbit:review committed --base main ← 静的解析（高速・広範） + ↓ +② /codex:review --base main --background ← 設計・ロジック深層レビュー + ↓ +両方の指摘を統合して修正 + ↓ +E2E テスト実行（本ファイル） + ↓ +PR 作成 → CodeRabbit PR レビュー（自動） + ↓ +Critical/High 0 件 → マージ +``` + +| AI | テスト連携での役割 | +|---|---| +| ClaudeCode | テスト実行・デバッグ・修復・5カテゴリ検証 | +| Codex | 静的解析・改善提案・設計整合性確認 | +| CodeRabbit | PR 差分レビュー・品質ゲート | + +--- + +## 📊 レポート出力 + +```text +- テスト結果（Pass/Fail 件数） +- 失敗項目（番号・内容） +- 原因分析（RCA） +- 修復内容 +- 再発防止策 +- セキュリティ影響 +- パフォーマンス影響 +- 修復成功率 +``` + +--- + +## 🎯 最終目標 + +「人間がレビュー承認のみを行う品質」を達成する。 + +- 高品質 WebUI +- 自律型デバッグ +- セキュア設計 +- ITSM / ISO27001 / ISO20000 準拠レベル diff --git a/Claude/templates/claude/ClaudeOS/templates/session-report-template.md b/Claude/templates/claude/ClaudeOS/templates/session-report-template.md new file mode 100644 index 00000000..362f6863 --- /dev/null +++ b/Claude/templates/claude/ClaudeOS/templates/session-report-template.md @@ -0,0 +1,75 @@ +# ClaudeOS Session Report + +## 📊 Summary + +- Project: +- Phase: +- Week: +- Session Duration: +- Loop Count: +- Goal Type: (mvp-release / hotfix / security-emergency / etc.) + +## ✅ Completed + +- +- + +## 📁 Changed Files + +- + +## 🔍 Verification + +- lint: +- test: +- build: +- CI: +- Gate-1: +- Gate-2: + +## 📈 KPI + +- ci_success_rate: +- test_pass_rate: +- security_critical: +- blocker_count: + +## 📋 GitHub + +- Issues updated: +- PR created: +- Project status: + +## 🧬 Learning + +### Failure Patterns + +- + +### Success Patterns + +- + +## ⚠️ Risks + +- + +## 🔜 Next Actions + +1. +2. +3. + +## 📊 検証サマリー + +### 実行した検証（件数・証跡 URL） + +### 未実行の検証（件数・項目番号） + +### 未実行理由 + +## 🏁 Final Decision + +- stable: true / false +- next_session_mode: Monitor / Development / Verify / Improvement +- goal_achieved: true / false diff --git a/Claude/templates/claude/START_PROMPT.md b/Claude/templates/claude/START_PROMPT.md index e7302de7..07a71181 100644 --- a/Claude/templates/claude/START_PROMPT.md +++ b/Claude/templates/claude/START_PROMPT.md @@ -1,1932 +1,59 @@ -# 🚀 ClaudeOS v9.0 — Goal-Driven + Agent Teams + Agent View 完全統合版 +# 🚀 ClaudeOS Boot Loader v9.0 -## 🎯 目的 +## 📁 System Startup -このフォルダは ClaudeOS v9.0 を用途別に分割したプロンプト／設計ファイル群です。 - -`/goal` コマンドでゴールを設定し CTO に全権委任する。Agent Teams で並列に動き、Agent View で監視する。 - ---- - -## 📁 推奨読み込み順 +以下の順で `.claude/ClaudeOS/` 配下のファイルを Read すること。 ```text -_header.md -01-session-startup.md -02-core-architecture.md -03-state-json.md -04-agent-teams.md -05-codex-debug.md -06-ci-automation.md -07-ai-dev-factory.md -08-operations.md -09-termination-reporting.md -10-webui-final-verification.md -_footer.md -``` +ClaudeOS/core/00-goal-system.md +ClaudeOS/core/01-session-startup.md +ClaudeOS/core/02-core-architecture.md +ClaudeOS/core/03-state-json.md +ClaudeOS/core/04-agent-teams.md ---- +ClaudeOS/execution/05-operations.md +ClaudeOS/execution/06-ci-automation.md +ClaudeOS/execution/07-ai-dev-factory.md +ClaudeOS/execution/08-termination-reporting.md -## 🧠 ClaudeOS v9.0 の本質 +ClaudeOS/quality/09-webui-testing.md +ClaudeOS/quality/10-security-testing.md +ClaudeOS/quality/11-infrastructure-testing.md +ClaudeOS/quality/12-database-testing.md +ClaudeOS/quality/13-e2e-playwright.md -```text -AI IDE ではない。AI 開発組織そのもの。 -/goal で目標を設定し、CTO に全権委任する。 -Agent Teams で並列に動き、Agent View で監視する。 -固定ループではなく、状況に応じて最適解を自律選択する。 +ClaudeOS/ai-review/14-codex-review.md +ClaudeOS/ai-review/15-coderabbit-review.md +ClaudeOS/ai-review/16-ai-quality-gate.md -止まらない。ただし暴走しない。 -必ず検証する。Goal 達成後は適切に終了する。 +ClaudeOS/governance/17-project-governance.md +ClaudeOS/governance/18-release-policy.md +ClaudeOS/governance/19-security-policy.md +ClaudeOS/governance/20-audit-policy.md ``` ---- - -## 🔥 最重要原則 - -- `/goal` でゴールを設定してから開発を開始する -- 止まらない。ただし暴走しない -- 必ず検証する。未検証 merge 禁止 -- Security は常に最優先 -- Release 期は新機能禁止 -- 同一原因エラー 2 回 → Issue 化して次タスクへ - ---- - -## ⏱ 基本制約 - -| 項目 | 内容 | -|---|---| -| ゴール管理 | `/goal` コマンド（v2.1.139+ 公式機能） | -| セッション監視 | Agent View（`claude agents`） | -| 実行時間 | 最大 5 時間（300 分） | -| CI 修復 | 最大 3 回 | -| 同一原因エラー | 最大 2 回（3 回目は Issue 化） | -| プロジェクト期間 | CTO 判断（無期限可） | -| 実行フロー | /goal 駆動動的判断（フォールバック: Monitor → Development → Verify → Improvement） | - ---- - -## 🔥 最上位指令（必須実行） - -> **以降、全てを CTO の判断に任せます。CTO 全権委任で自律開発を続けてください。** - -- 🎯 **まず `/goal` でゴール条件を設定すること**（`or stop after 20 turns` を含める） -- 👁 **`claude agents` で Agent View を起動しセッション状態を監視すること** -- ⏱ **セッション開始時刻を必ず確認し、5 時間を厳守すること** -- 🤖 **Agent Teams を状況に応じて自律判断で spawn すること**（パターン A/B/C） -- ⚡ **Auto Mode による自律開発を実行すること** -- 📊 全プロセスや状況を可視化すること -- 📖 README.md は表とアイコン多用、ダイアグラム図も活用して常に更新すること -- 📋 **GitHub Projects も常に更新すること** - ---- - -# 01-session-startup — セッション開始・復元ルール (v9.0) +## 🎯 Goal 選択 -## 🎯 目的 - -ClaudeOS v9.0 起動時に、`/goal` 設定・前回状態・GitHub・CI・Project の状況を必ず復元し、CTO の動的判断材料を整える。 - ---- - -## ✅ セッション開始時の必須処理 +`state.json` の `goal_type` を読み、対応ファイルを Read すること。 ```text -1. state.json 読込（前回ゴール・KPI・blocked_issues 復元） -2. 週次フェーズ算出（start_date から自動計算） -3. GitHub Issues / Projects 状態取得 -4. CI 状態取得（gh run list --limit 5） -5. /goal 設定（達成条件 + or stop after N turns） -6. Agent View 起動（claude agents） -7. CTO 優先順位評価 → 最初のアクション決定 -8. 本セッションの作業方針を出力 +mvp-release → ClaudeOS/goals/mvp-release.md +production-release → ClaudeOS/goals/production-release.md +hotfix → ClaudeOS/goals/hotfix.md +security-emergency → ClaudeOS/goals/security-emergency.md +refactoring → ClaudeOS/goals/refactoring.md ``` ---- - -## 🎯 /goal 設定 - -```bash -#/goal -#"MVP Release Candidate を完成させる。完了条件: 全主要画面正常動作・API疎通成功・認証認可正常・DB CRUD成功・CI成功・Critical/High脆弱性ゼロ・E2Eテスト成功・README/運用手順完成・Docker起動成功・ローカル環境再現可能。停止条件: MVP完成・CI成功・リリース条件達成・修復ループ上限到達" -/goal " -MVP Release Candidate を完成させる。 - -優先順位： -1. 動作 -2. 安定性 -3. セキュリティ -4. 保守性 -5. UI改善 - -完了条件： -- 全主要機能動作 -- CI成功 -- Critical/High脆弱性ゼロ -- Docker再現成功（docker-compose.yml がある場合のみ） -- README完成 -- E2E成功 - -制約： -- 5時間以内 -- 修復ループ最大5回 -- 過剰リファクタ禁止 -- 新技術導入禁止 -- アーキテクチャ全面変更禁止 - -停止条件： -- MVP完成 -- リリース条件達成 -- 修復上限到達 -" -``` - ---- - -## 📤 必須出力 - -セッション開始時は必ず以下を出力する。 - -```text -[Session Restore Report v9.0] - -Project: -- name: -- start_date: -- release_deadline: -- week_phase: Week N → Build/Quality/Stabilize/Release - -/goal: -- current: (設定中の条件) -- status: active / not set - -GitHub: -- open_issues: -- active_prs: -- latest_ci_status: - -KPI: -- ci_success_rate: -- test_pass_rate: -- security_critical: -- blocker_count: - -blocked_issues: (あれば列挙) - -CTO Decision: -- 優先アクション: (§5 CTO優先順位テーブルに基づく) -- reason: -``` - ---- - -## 🚦 CTO 優先順位（v9.0 Dynamic Orchestration） - -| 優先度 | 状態 | 行動 | -|---|---|---| -| 1 | Security Critical | 即時対応（Agent Teams パターン B） | -| 2 | CI 失敗中 | 原因分析 + 最小差分修復 | -| 3 | Blocker Issue | 解除 | -| 4 | /goal 直結 Issue | 実装（パターン A 検討） | -| 5 | 検証不足 | 品質強化（パターン B） | -| 6 | 改善 | 余裕がある場合のみ | - ---- - -# 02-core-architecture — ClaudeOS v9.0 Core Architecture - -## 🧠 システム概要 - -ClaudeOS v9.0 は AI を単なる開発補助ではなく、AI 開発組織そのものとして統合動作させる。 -`/goal` コマンドで目標を設定し、CTO に全権委任する。Agent Teams で並列に動き、Agent View で監視する。 - -``` -止まらない。ただし暴走しない。 -必ず検証する。Goal 達成後は適切に終了する。 -``` - ---- - -## 🎯 統合対象 - -- `/goal` 駆動の自律継続開発（v2.1.139+ 公式機能） -- Agent Teams による並列協調開発（パターン A/B/C） -- Agent View（`claude agents`）によるセッション監視 -- 完全自律開発（CTO 委任） -- 5 時間セッション最適化 -- KPI 連動動的判断 -- 6 か月フェーズ制御 -- state.json 意思決定 AI -- GitHub Actions 自動修復 -- GitHub Projects 完全同期 -- AI Dev Factory -- Codex / CodeRabbit Review 補助 -- 終了報告と引き継ぎ - ---- - -## 📆 6 か月フェーズ制御 - -```text -現在週 = (today - start_date) / 7 -``` - -| 週 | フェーズ | 主目的 | Agent Teams | -|---|---|---|---| -| 1–8 | Build | 機能開発・基盤構築 | パターン A 多用 | -| 9–16 | Quality | 品質強化・テスト拡充 | パターン B 多用 | -| 17–20 | Stabilize | 安定化・バグ収束 | パターン B | -| 21–24 | Release | リリース準備・検証完了 | パターン B + Audit | - ---- - -## ⚖️ 時間配分 - -| フェーズ | Dev | Verify | Improve | -|---|---:|---:|---:| -| Build | 45 | 25 | 15 | -| Quality | 30 | 40 | 15 | -| Stabilize | 20 | 50 | 15 | -| Release | 5 | 55 | 20 | - -残り時間は Monitor / Reporting / Safety Buffer に割り当てる。 - ---- - -## 🔁 実行フロー（v9.0 動的判断） - -```text -/goal 設定 → state.json Read → CTO 優先順位評価 -→ 最適行動選択（Fix/Build/Verify/Improve） -→ Agent Teams spawn（必要時） -→ /goal 達成判定（Haiku）→ 次ターン or 終了 -``` - -フォールバック: `Monitor → Development → Verify → Improvement` - ---- - -## 📈 KPI 制御（v9.0） - -| 状態 | score | 行動 | -|---|---|---| -| security_critical > 0 | +5 | Security 最優先 | -| CI 失敗 | +3 | Verify / Repair | -| test_pass_rate < 0.8 | +2 | QA 強化 | -| blocker_count > 0 | +3 | Blocker 解除 | - -score ≥ 5 → 強制継続 / ≥ 3 → 継続 / ≥ 1 → 軽量 / 0 → 終了 - ---- - -## 🚫 強制ルール - -- Release 期は新機能禁止 -- Security は最優先 -- 未検証 merge 禁止 -- 同一原因エラーは **2 回まで**（3 回目は Issue 化） -- CI 修復は最大 **3 回まで** -- CLAUDE.md / settings.json / hooks の自己書き換え禁止 -- force push 禁止 - ---- - -# 03-state-json — state.json 仕様 (v9.0) - -## 🎯 目的 - -state.json は ClaudeOS の意思決定・継続判断・失敗学習・進捗復元の中核ファイル。 -v9.0 では `/goal` 条件・blocked_issues・learning パターンを正式に管理する。 - ---- - -## 🧠 state.json 完全版（v9.0） - -```json -{ - "project": { - "name": "project-name", - "start_date": "2026-01-01", - "release_deadline": "2026-07-01", - "phase_mode": "development" - }, - "goal": "Issue #XX-#YY 実装完了", - "phase": "Monitor", - "kpi": { - "success_rate_target": 0.9, - "ci_success_rate": 0.0, - "test_pass_rate": 0.0, - "security_critical": 0, - "blocker_count": 0 - }, - "execution": { - "max_duration_minutes": 300, - "repair_count": 0, - "max_repair": 3, - "same_error_limit": 2, - "loop_count": 0, - "phase": "Monitor", - "last_session_summary": "" - }, - "automation": { - "auto_issue_generation": true, - "self_evolution": true - }, - "stable": { - "stable_achieved": false, - "consecutive_success": 0 - }, - "completed_issues": [], - "blocked_issues": [], - "learning": { - "failure_patterns": [], - "success_patterns": [] - }, - "quality_gates": { - "lint": { "warning_threshold": 10, "error_threshold": 0 }, - "coverage": { "line_min": 70, "changed_files_min": 80 } - } -} -``` - ---- - -## 🔄 更新タイミング - -| タイミング | 更新内容 | -|---|---| -| セッション開始 | Read（前回状態復元） | -| Issue 完了時 | `completed_issues` 追記 | -| CI 状態変化時 | `kpi.ci_success_rate` 更新 | -| ブロッカー発生時 | `blocked_issues` 追記 | -| Verify 完了時 | `kpi.test_pass_rate` / `stable` 更新 | -| 学習発生時 | `learning.failure_patterns` / `success_patterns` 追記 | -| セッション終了時 | Write（最終状態保存）| - -毎ターン更新は不要。フェーズ遷移時のみ。 - ---- - -## 🧬 学習ルール（v9.0） - -### learning.failure_patterns - -以下を記録する（上限 20 件）： - -- 同一エラーで 2 回詰まったケース -- blocked_issues の原因 -- verify_subagent_missing 発生 - -### learning.success_patterns - -以下を記録する（上限 20 件）： - -- STABLE 達成時のセッションサマリー -- 修復成功手順 -- 有効だった Agent Teams パターン - ---- - -## 🚨 安全ルール - -- state.json が壊れている場合は `state.backup.json` を作成する -- JSON 構文エラー時は自動修復せず、修復 Issue を作成する -- `release_deadline` は原則変更禁止 -- `same_error_limit: 2` — 同一原因エラーは 2 回で Issue 化 - ---- - -# 04-agent-teams — Agent Teams 設計 (v9.0) - -## 🎯 目的 - -ClaudeOS v9.0 を単体 AI ではなく、複数役割を持つ仮想開発組織として運用する。 -`/goal` で設定した目標に対し、CTO が状況に応じてパターン A/B/C を自律選択する。 - ---- - -## 🧑‍💼 基本チーム構成 - -| Agent | 役割 | -|---|---| -| CTO | 全体判断・優先順位・/goal 管理・リリース責任 | -| Manager | Issue 管理・進捗管理・Project 同期 | -| Architect | 設計・技術選定・構造レビュー | -| DevAPI | API / Backend 実装 | -| DevUI | Frontend / UI 実装 | -| QA | テスト設計・品質保証 | -| Tester | 実行検証・再現確認 | -| CIManager | GitHub Actions / CI 修復 | -| Security | 脆弱性・権限・秘密情報確認 | -| ReleaseManager | リリース判定・最終報告 | -| CMDB-Agent | 構成管理・依存関係マップ・変更影響分析 | -| Audit-Agent | 変更証跡・ISO/J-SOX 規格準拠・監査レポート | - ---- - -## 🤝 Agent Teams パターン（v9.0 新設） - -### パターン A: 並列実装（複数機能の同時開発） - -``` -Lead: CTO（統制・統合） -Teammate 1: Backend 実装（API / DB / ロジック） -Teammate 2: Frontend 実装（UI / UX） -Teammate 3: テスト設計・検証 -``` - -使用場面: 複数機能の並列実装 - -### パターン B: 品質強化（CI 失敗修復・リリース前） - -``` -Lead: CTO（統制・判断） -Teammate 1: バグ修復・CI 修復 -Teammate 2: セキュリティレビュー -Teammate 3: 回帰テスト -``` - -使用場面: CI 失敗 + Security + テスト同時対応 - -### パターン C: 調査・設計（アーキテクチャ検討） - -``` -Lead: CTO（統制・意思決定） -Teammate 1: 技術調査 -Teammate 2: アーキテクチャ設計 -Teammate 3: Devil's Advocate（反証・リスク指摘） -``` - -使用場面: 大規模設計検討・多観点が必要な場面 - ---- - -## 👁 Agent View（v9.0） +## ⚡ 起動後必須実行 ```bash claude agents ``` -| アイコン | 状態 | -|---|---| -| ✽ | Working（実行中） | -| ✻ | Needs Input（入力待ち） | -| ✙ | Idle（アイドル） | -| ✔ | Completed（完了） | -| ✘ | Failed（失敗） | - -操作: Space（Peek・返信）/ Enter（Attach・直接接続） - -**Agent View は監視・観測のみ担当。意思決定は CTO が行う。** - ---- - -## ⚖️ Sub-agent vs Agent Teams - -| 基準 | Sub-agent（Task） | Agent Teams | -|---|---|---| -| コンテキスト | 結果を呼び出し元に返す | 各自独立ウィンドウ | -| 通信 | 親エージェントへ報告のみ | Teammate 間で直接通信可 | -| トークンコスト | 低 | 高 | -| 使用場面 | Lint 修正・単機能・docs 更新 | 複数機能並列・多観点協調 | - -**Agent Teams 使用条件:** - -| 場面 | 判断 | -|---|---| -| 複数機能の並列実装 | ✅ パターン A | -| CI + Security + テスト同時 | ✅ パターン B | -| 大規模設計検討 | ✅ パターン C | -| 1 ファイル修正 / Lint / docs | ❌ Sub-agent で十分 | - ---- - -## 🔁 Agent ログフォーマット - -```text -[👔 CTO / 最高技術責任者] 判断: -[💻 Developer / デベロッパー] 実装: -[🧪 QA / 品質保証] 検証: -[🔒 Security / セキュリティ] リスク: -[⚙️ DevOps / 運用基盤] CI状態: -[🗄️ CMDB-Agent / 構成管理] 影響範囲分析: -[📋 Audit-Agent / 監査] 証跡確認・規格準拠: -``` - ---- - -## 🚫 禁止事項 - -- Agent 判断なしの merge -- QA 確認なしの Done 移動 -- Security 未確認の release -- Release 期の新機能追加 -- 同一原因エラーの無限修復（2 回で停止） - ---- - -# 05-codex-debug — Codex Debug 補助設計 - -## 🎯 目的 - -Codex を実装・デバッグ・レビュー補助として利用し、ClaudeOS のコンテキスト消費と修復負荷を下げる。 - ---- - -## 🧩 Codex の担当領域 - -| 領域 | 役割 | -|---|---| -| Debug | エラー原因の切り分け | -| Review | PR差分レビュー | -| Refactor | 小規模リファクタリング案 | -| Test | テスト不足の指摘 | -| Explain | ログ・スタックトレース解釈 | -| Preview | 実装前の影響確認 | - ---- - -## 🔁 利用タイミング - -```text -1. CI失敗 -2. テスト失敗 -3. lint失敗 -4. PRレビュー前 -5. 同一エラー2回目 -6. 大きな設計変更前 -``` - ---- - -## 🧠 Codex依頼プロンプト雛形 - -```text -あなたは ClaudeOS の Codex Debug Agent です。 - -対象: -- Repository: -- Branch: -- Issue: -- Error Log: -- Changed Files: - -依頼: -1. 原因を特定してください -2. 影響範囲を示してください -3. 最小修正案を提示してください -4. 再発防止テストを提示してください -5. 修正してよい範囲と触ってはいけない範囲を分けてください - -制約: -- 大規模改修は禁止 -- 既存仕様を壊さない -- セキュリティ低下は禁止 -- 修正案は小さく保つ -``` - ---- - -## 🚫 Codex に任せすぎない領域 - -- 最終merge判断 -- release判断 -- セキュリティ例外承認 -- state.json の恒久ルール変更 -- GitHub Projects の最終ステータス確定 - ---- - -# 06-ci-automation — GitHub Actions / CI 自動化 - -## 🎯 目的 - -CIをClaudeOSの品質ゲートとして扱い、失敗時は自動でIssue化し、CIManagerが修復対象として扱えるようにする。 - ---- - -## 🔁 CI対象 - -- npm install / npm ci -- lint -- test -- build -- artifact出力 -- CI失敗Issue作成 - ---- - -## 🚦 CI修復ルール - -| 条件 | 対応 | -|---|---| -| CI失敗 | Issue自動生成 | -| 同一エラー1回目 | 修復 | -| 同一エラー2回目 | Codex Debugへ依頼 | -| 同一エラー3回目 | 修復停止・別Issue化 | -| 修復5回到達 | 打ち切り | - ---- - -## 🚫 禁止事項 - -- CI未通過のmerge -- テスト未実行のDone移動 -- 同一エラーの無限修復 -- ログを残さない修正 - ---- - -# 07-ai-dev-factory — AI Dev Factory - -## 🎯 目的 - -ClaudeOS が backlog / TODO / CI / KPI / Review から自動的にIssue候補を生成し、開発対象を枯渇させない。 - ---- - -## 🏭 Issue自動生成条件 - -- CI失敗 -- KPI未達 -- テスト不足 -- セキュリティ指摘 -- backlog.md の未処理項目 -- TODOコメントの蓄積 -- docs/roadmap.md との差分 -- 既存Issueのブロッカー - ---- - -## 📝 Issueテンプレート - -```text -Title: [P1] 問題概要 - -Reason: -CI failure / KPI gap / test gap / security risk - -Context: -- 発生箇所: -- 関連ファイル: -- 関連Issue: -- 関連PR: - -Acceptance: -- 再現可能 -- 修正可能 -- テスト可能 -- CI通過 -- 影響範囲が説明されている - -Priority: -P1 / P2 / P3 - -Owner: -ClaudeOS / CIManager / QA / Security -``` - ---- - -## 📊 優先順位 - -| 優先度 | 条件 | -|---|---| -| P1 | Security / CI停止 / Release阻害 | -| P2 | テスト不足 / 品質低下 | -| P3 | 改善 / リファクタリング | -| P4 | 将来案 / 調査 | - ---- - -## 🚫 Release期の制約 - -Release期に生成された新機能Issueは原則Backlogへ回す。 - -ただし、以下は例外。 - -- Security修正 -- Release阻害バグ -- データ破損リスク -- ビルド不能 - ---- - -# 08-operations — 運用ルール (v9.0) - -## 🎯 目的 - -ClaudeOS v9.0 を `/goal` 駆動・動的判断モードで安全に運用する。 - ---- - -## 🔁 基本実行フロー（v9.0 動的判断） - -```text -/goal 設定 → CTO 優先順位評価 → 最適行動選択 → 実行 → /goal 達成判定 -``` - -フォールバック: `Monitor → Development → Verify → Improvement` - ---- - -## 👔 CTO 優先順位（v9.0） - -| 優先度 | 状態 | 行動 | -|---|---|---| -| 1 | Security Critical | 即時対応 | -| 2 | CI 失敗中 | 修復 | -| 3 | Blocker Issue | 解除 | -| 4 | /goal 直結 Issue | 実装 | -| 5 | 検証不足 | 品質強化 | -| 6 | 改善 | 余裕時のみ | - ---- - -## 🟢 Monitor - -確認対象: - -- state.json -- GitHub Issues -- GitHub Pull Requests -- GitHub Projects -- GitHub Actions -- backlog.md -- TODO.md -- docs/roadmap.md - -出力: - -```text -Monitor Report: -- current_phase: -- open_issues: -- active_prs: -- ci_status: -- blockers: -- next_target: -``` - ---- - -## 🔨 Development - -実施内容: - -- Issue選定 -- ブランチ作成 -- 最小単位実装 -- 必要テスト追加 -- 変更ログ作成 - -禁止: - -- Release期の新機能開発 -- 仕様外の大規模改修 -- テストなし修正 - ---- - -## ✅ Verify - -確認対象: - -- lint -- unit test -- integration test -- build -- security check -- PR review -- Codex review - -判定: - -```text -pass → Improvement or Done -fail → CIManager / Codex Debug -``` - ---- - -## 🧹 Improvement - -実施内容: - -- 小規模リファクタリング -- テスト補強 -- ドキュメント更新 -- state.json学習更新 -- Project同期 - ---- - -## 📋 GitHub Projects ステータス - -```text -Backlog → Todo → In Progress → Review → Verify → Done -``` - -| トリガー | 状態 | -|---|---| -| Issue生成 | Backlog | -| 開発開始 | In Progress | -| PR作成 | Review | -| CI実行 | Verify | -| 完了 | Done | - ---- - -## 🚨 Safety Guard（v9.0 Stop Conditions） - -``` -同一エラー同一原因 2 回連続 → Issue 化して次タスクへ -修復試行 3 回到達 → Blocked -コンテキスト圧迫警告 → 即終了処理 -``` - -- 残 60 分 → 最終ループ -- 残 15 分 → Verify のみ -- 残 5 分 → 終了処理 -- Security 最優先 - ---- - -# 09-termination-reporting — 終了処理・報告 - -## 🎯 目的 - -ClaudeOS セッション終了時に、作業結果・検証結果・未完了事項・次回引継ぎを明確に残す。 - ---- - -## 🧾 終了処理 - -```text -1. 変更差分確認 -2. test / lint / build 結果確認 -3. state.json更新 -4. GitHub Project更新 -5. 必要なら commit -6. 必要なら push -7. 必要なら PR作成 -8. 終了報告作成 -``` - ---- - -## ✅ commit / push / PR ルール - -| 条件 | 対応 | -|---|---| -| 変更あり + 検証成功 | commit / push / PR | -| 変更あり + 検証失敗 | commit禁止、修復Issue作成 | -| docsのみ | 軽量検証後commit可 | -| Security未確認 | merge禁止 | -| CI未通過 | merge禁止 | - ---- - -## 📤 終了報告テンプレート - -```text -# ClaudeOS Session Report - -## Summary -- Project: -- Phase: -- Week: -- Session Duration: -- Loop Count: - -## Completed -- -- - -## Changed Files -- - -## Verification -- lint: -- test: -- build: -- CI: - -## KPI -- ci_success_rate: -- test_pass_rate: -- review_blocker_count: -- security_issue_count: -- score: - -## GitHub -- Issues updated: -- PR created: -- Project status: - -## Learning -### Failure Patterns -- - -### Success Patterns -- - -## Risks -- - -## Next Actions -1. -2. -3. - -## Final Decision -- stable: true / false -- next_session_mode: Monitor / Development / Verify / Improvement -``` - ---- - -## 🚫 終了時の禁止事項 - -- 検証失敗を隠す -- state.jsonを更新しない -- PRだけ作ってCI未確認 -- Projectステータスを放置 -- 次回アクションを残さない - ---- - -# 10 — WebUI ベース システム開発 全テスト検証・デバッグ（最終指示） - -残りの時間で以下のテスト検証・デバッグができますか？ -時間許す限りでOKです。まずは検証したうえでCTOの判断で実行してみてください。 -終了後のコミット、プッシュ、PR、マージを実行してください。 - ---- - -# 🚀 ClaudeCodeでのWebUIベース システム開発 -## フロントエンド／バックエンド 全テスト検証・デバッグ項目一覧 - ---- - -# 🎨 フロントエンド 全テスト検証・デバッグ項目 - ---- - -## 1. 画面表示テスト（UI Rendering） - -1. 全画面が正常表示される -2. CSS崩れがない -3. フォント崩れがない -4. アイコン表示正常 -5. ダークモード対応確認 -6. 解像度変更時の崩れ確認 -7. ブラウザズーム対応 -8. 125%/150% DPI対応 -9. スクロール表示確認 -10. モーダル表示正常 -11. ツールチップ表示正常 -12. テーブル列崩れ確認 -13. サイドメニュー開閉確認 -14. アコーディオン動作確認 -15. ローディングUI表示確認 -16. 404画面表示確認 -17. 500エラー画面確認 -18. 長文表示確認 -19. 日本語表示崩れ確認 -20. Unicode/絵文字表示確認 - ---- - -# 📱 レスポンシブ・端末対応 - -21. Windows Edge確認 -22. Chrome確認 -23. Firefox確認 -24. iPad表示確認 -25. Android表示確認 -26. 画面回転対応 -27. タッチ操作確認 -28. キーボード操作確認 -29. タブ移動確認 -30. モバイルメニュー確認 - ---- - -# ⚡ JavaScript動作確認 - -31. JSエラー有無 -32. Console Error確認 -33. Promise失敗時処理 -34. 非同期通信成功確認 -35. 非同期通信失敗確認 -36. APIタイムアウト確認 -37. ボタン連打確認 -38. 二重送信防止 -39. イベント重複発火確認 -40. localStorage動作 -41. sessionStorage動作 -42. Cookie保存確認 -43. ブラウザ戻る対応 -44. 画面リロード確認 -45. SPAルーティング確認 -46. キャッシュ更新確認 -47. ServiceWorker確認 -48. WebSocket確認 -49. リアルタイム更新確認 -50. JSメモリリーク確認 - ---- - -# 🧪 入力フォーム検証 - -51. 必須チェック -52. 空文字確認 -53. NULL送信確認 -54. 数値入力制限 -55. 文字数制限 -56. 禁止文字確認 -57. メール形式確認 -58. 電話番号形式確認 -59. 日付形式確認 -60. CSVアップロード確認 -61. ファイルサイズ制限 -62. 拡張子制限 -63. ドラッグ＆ドロップ確認 -64. 日本語IME入力確認 -65. Enter送信誤動作確認 -66. バリデーション表示確認 -67. リアルタイム検証確認 -68. エラーメッセージ確認 -69. 入力復元確認 -70. 多重Submit確認 - ---- - -# 🔐 フロントエンドセキュリティ - -71. XSS対策確認 -72. CSRF対策確認 -73. CSP確認 -74. Cookie Secure確認 -75. HttpOnly確認 -76. Token漏洩確認 -77. JWT保存方法確認 -78. URL直打ち確認 -79. 権限外画面遷移確認 -80. DevTools改ざん確認 -81. HTML改ざん確認 -82. JS難読化確認 -83. 秘密情報埋め込み確認 -84. APIキー露出確認 -85. HTTPS強制確認 - ---- - -# 🚀 フロントエンド性能試験 - -86. 初回表示速度 -87. API応答速度 -88. 画像読込速度 -89. JS読込速度 -90. CSS最適化確認 -91. LazyLoad確認 -92. Bundleサイズ確認 -93. Lighthouse確認 -94. FCP確認 -95. LCP確認 -96. CLS確認 -97. FPS確認 -98. CPU使用率確認 -99. メモリ使用量確認 -100. 長時間稼働確認 - ---- - -# 🧠 UX・運用系確認 - -101. 操作直感性確認 -102. エラー時誘導確認 -103. トースト通知確認 -104. 成功メッセージ確認 -105. 多言語化確認 -106. アクセシビリティ確認 -107. 色覚対応確認 -108. 音声読み上げ確認 -109. 運用マニュアル整合 -110. 操作ログ出力確認 - ---- - -# ⚙️ バックエンド 全テスト検証・デバッグ項目 - ---- - -# 🧩 APIテスト - -111. GET正常系 -112. POST正常系 -113. PUT正常系 -114. DELETE正常系 -115. HTTPステータス確認 -116. JSON形式確認 -117. NULL応答確認 -118. 不正JSON確認 -119. Content-Type確認 -120. APIタイムアウト確認 -121. APIリトライ確認 -122. API認証確認 -123. API認可確認 -124. APIレート制限確認 -125. API例外処理確認 -126. APIログ確認 -127. API監査ログ確認 -128. OpenAPI整合確認 -129. Swagger整合確認 -130. APIバージョン確認 - ---- - -# 🗄 DBテスト - -131. DB接続確認 -132. 接続プール確認 -133. CRUD確認 -134. トランザクション確認 -135. Rollback確認 -136. 排他制御確認 -137. Index動作確認 -138. SQL性能確認 -139. N+1問題確認 -140. 大量データ確認 -141. SQL Injection対策 -142. 文字コード確認 -143. NULLデータ確認 -144. 日付保存確認 -145. タイムゾーン確認 -146. Backup確認 -147. Restore確認 -148. Migration確認 -149. ORM整合確認 -150. DB障害時確認 - ---- - -# 🔐 バックエンドセキュリティ - -151. JWT認証確認 -152. Session認証確認 -153. OAuth確認 -154. SAML確認 -155. Entra ID連携確認 -156. HENNGE連携確認 -157. LDAP/AD連携確認 -158. 権限昇格確認 -159. IDOR確認 -160. Command Injection確認 -161. Path Traversal確認 -162. SSRF確認 -163. RCE確認 -164. ファイルアップロード脆弱性 -165. Virus Scan確認 -166. 秘密情報管理確認 -167. .env漏洩確認 -168. HTTPS証明書確認 -169. TLSバージョン確認 -170. Security Header確認 - ---- - -# ⚡ バックエンド性能試験 - -171. 同時接続確認 -172. 負荷試験 -173. ストレス試験 -174. Soak Test -175. CPU使用率確認 -176. メモリリーク確認 -177. GC確認 -178. Queue確認 -179. Redis確認 -180. Cache確認 -181. 非同期Job確認 -182. Worker停止確認 -183. Failover確認 -184. Auto Recovery確認 -185. Kubernetes確認 -186. Docker確認 -187. Container Restart確認 -188. ログ肥大化確認 -189. Disk使用量確認 -190. Thread枯渇確認 - ---- - -# 🧪 バッチ・ジョブ系 - -191. 定期実行確認 -192. Cron確認 -193. 多重起動防止 -194. リトライ確認 -195. 失敗通知確認 -196. Mail通知確認 -197. Teams通知確認 -198. ログローテーション -199. 日跨ぎ確認 -200. 月末処理確認 - ---- - -# 🔍 運用監視・ログ確認 - -201. アプリログ確認 -202. エラーログ確認 -203. 監査ログ確認 -204. 操作ログ確認 -205. Syslog確認 -206. SIEM連携確認 -207. メトリクス確認 -208. Prometheus確認 -209. Grafana確認 -210. アラート通知確認 - ---- - -# 🔥 障害試験（超重要） - -211. DB停止時 -212. API停止時 -213. Redis停止時 -214. NW断時 -215. DNS障害時 -216. SSL期限切れ時 -217. ディスクFull時 -218. CPU100%時 -219. メモリ枯渇時 -220. Worker異常停止時 -221. サーバ再起動時 -222. VM移行時 -223. Windows Update後 -224. Linux Patch後 -225. 時刻同期ズレ確認 - ---- - -# 🤖 ClaudeCode時代に追加すべきAI開発系検証 - -226. 自動生成コード品質確認 -227. AI生成SQL確認 -228. AI生成API確認 -229. AI生成HTML確認 -230. AI生成JS確認 -231. 型安全確認 -232. Linter確認 -233. Formatter確認 -234. UnitTest自動生成確認 -235. E2E自動化確認 -236. Playwright確認 -237. CI/CD確認 -238. GitHub Actions確認 -239. CodeRabbit確認 -240. Dependabot確認 -241. Secret Scan確認 -242. SBOM確認 -243. OSSライセンス確認 -244. CLAUDE.md整合確認 -245. Agent Team競合確認 -246. WorkTree競合確認 -247. AutoFix暴走確認 -248. Loop暴走確認 -249. Token消費監視 -250. AI誤修復確認 - ---- - -# 11 — ClaudeCode テスト検証・デバッグ統合指示書 - -WebUI ベース システム開発用 完全版 - ---- - -## 🎯 目的 - -本プロジェクトにおいて ClaudeCode は以下を実施すること。 - -- WebUI ベースシステムの品質保証 -- 全レイヤー横断テスト -- 自動デバッグ・自動修復 -- セキュリティ検査 -- パフォーマンス分析 -- ログ解析・根本原因分析（RCA） -- 修復後の再検証 -- CI/CD 連携 -- 自律的品質改善 - -本指示は以下 5 カテゴリを完全分離して実施すること。 - -1. フロントエンド -2. バックエンド -3. セキュリティ -4. インフラ -5. データベース - ---- - -## 🧠 基本動作ルール - -ClaudeCode は以下を遵守すること。 - -- 常に日本語で出力 -- テスト → 分析 → 修復 → 再テスト の順で動作 -- 原因不明エラーを放置しない -- 一時回避ではなく恒久対策を優先 -- ログを必ず解析 -- 修復後は必ずリグレッションテスト -- CI エラーは最大 5 回まで自動修復（同一原因 2 回で Issue 化 → CLAUDE.md §12 に従う） -- 修復不能時は詳細レポート出力 -- 変更内容を必ず記録 -- セキュリティを最優先 -- パフォーマンス劣化を検知 -- state.json に状態保存 -- GitHub Actions と連動 -- Playwright による E2E を必須化 - ---- - -## 📁 テストカテゴリ構成 - -```text -tests/ -├── frontend/ -├── backend/ -├── security/ -├── infrastructure/ -└── database/ -``` - ---- - -## ① フロントエンド テスト検証・デバッグ指示 - -### 🎨 UI/UX テスト - -以下を完全確認すること。 - -1. レイアウト崩れ -2. レスポンシブ対応 -3. Edge / Chrome / Firefox / Safari 互換 -4. ダークモード -5. CSS 競合 -6. フォント崩れ -7. モーダル表示 -8. サイドメニュー動作 -9. ツールチップ表示 -10. コンポーネント整列 - -### 🧠 JavaScript 検証 - -1. API 通信 -2. 非同期処理 -3. イベント二重実行 -4. DOM 更新 -5. 状態管理 -6. 例外処理 -7. Promise 失敗処理 -8. Null 耐性 -9. LocalStorage 動作 -10. SPA ルーティング - -### 📂 ファイル処理検証 - -1. CSV アップロード -2. Excel アップロード -3. PDF 出力 -4. ダウンロード -5. 大容量ファイル -6. 不正拡張子拒否 -7. MIME タイプ検証 -8. ドラッグ＆ドロップ - -### ⚡ パフォーマンス検証 - -1. 初回表示速度 -2. 描画速度 -3. メモリリーク -4. FPS 低下 -5. 不要レンダリング -6. Lazy Load -7. キャッシュ最適化 - -### 🐞 フロントエンドデバッグ - -```bash -Console Error -Network Error -CORS Error -SourceMap -DOM Leak -CSS 競合 -WebSocket -``` - ---- - -## ② バックエンド テスト検証・デバッグ指示 - -### 🔧 API 検証 - -1. GET -2. POST -3. PUT -4. DELETE -5. StatusCode -6. JSON 形式 -7. Timeout -8. Retry -9. Exception -10. Validation - -### 🔄 業務ロジック検証 - -1. ワークフロー -2. 承認フロー -3. 状態遷移 -4. 排他制御 -5. 同時更新 -6. データ整合性 -7. トランザクション -8. Rollback - -### 📩 外部連携検証 - -1. Microsoft Graph -2. Teams 通知 -3. Mail 送信 -4. LDAP/AD -5. Entra ID -6. OneDrive -7. SharePoint -8. OAuth -9. Webhook - -### ⚡ パフォーマンス検証 - -1. API 高負荷 -2. CPU 使用率 -3. メモリ使用量 -4. Queue 処理 -5. 非同期ジョブ -6. キャッシュ - -### 🐞 バックエンドデバッグ - -```bash -Server Logs -StackTrace -SQL Logs -Deadlock -Memory Leak -Thread 枯渇 -Session 異常 -``` - ---- - -## ③ セキュリティ テスト検証・デバッグ指示 - -### 🔐 認証・認可検証 - -1. MFA -2. JWT -3. Session -4. RBAC -5. Admin 権限 -6. Password Policy -7. Token 期限 -8. Logout - -### 🛡 脆弱性検証 - -必ず OWASP Top10 を基準に検査。 - -1. SQL Injection -2. XSS -3. CSRF -4. SSRF -5. Directory Traversal -6. Command Injection -7. File Upload 攻撃 -8. Clickjacking -9. Open Redirect -10. XXE - -### 🌐 通信セキュリティ - -1. HTTPS 強制 -2. TLS 確認 -3. HSTS -4. Secure Cookie -5. CSP Header -6. CORS 制御 - -### 📜 ログ・監査 - -1. 監査ログ -2. 改ざん耐性 -3. マスキング -4. SIEM 連携 -5. 異常検知 - -### 🐞 セキュリティデバッグツール - -```bash -OWASP ZAP / BurpSuite -npm audit / pip-audit -Dependabot -SAST / DAST -CVE Scan -``` - ---- - -## ④ インフラ テスト検証・デバッグ指示 - -### 🖥 サーバ検証 - -1. Linux -2. Windows Server -3. systemd -4. Cron -5. Docker -6. Kubernetes -7. VM -8. NTP - -### 🌐 ネットワーク検証 - -1. DNS -2. Ping -3. HTTPS -4. Firewall -5. VPN -6. Proxy -7. LoadBalancer -8. Port 確認 - -### 💾 ストレージ検証 - -1. Disk 容量 -2. IOPS -3. Backup -4. Restore -5. Snapshot -6. RAID -7. NAS -8. SMB/NFS - -### 📈 監視・運用検証 - -1. CPU 監視 -2. Memory 監視 -3. Disk 監視 -4. Alert 通知 -5. Grafana -6. Prometheus -7. Zabbix -8. 自動復旧 - -### 🐞 インフラデバッグ - -```bash -journalctl / dmesg -OOM 確認 / Docker Logs -tcpdump / Wireshark -SSH Logs / Kernel Panic -``` - ---- - -## ⑤ データベース テスト検証・デバッグ指示 - -### 🗄 DB 基本検証 - -1. CRUD -2. Transaction -3. Commit/Rollback -4. FK 制約 -5. Index -6. View -7. Procedure - -### ⚡ パフォーマンス検証 - -1. Slow Query -2. Full Scan -3. Query Plan -4. Lock -5. Deadlock -6. Connection Pool -7. Cache Hit 率 - -### 🔄 データ整合性検証 - -1. NULL 制御 -2. 型不一致 -3. 文字コード -4. 日付型 -5. 重複データ -6. Migration -7. Backup/Restore - -### 🔐 DB セキュリティ検証 - -1. 認証 -2. 権限制御 -3. SQL Injection -4. 暗号化 -5. 監査ログ -6. 接続元制限 - -### 🐞 DB デバッグ - -```bash -EXPLAIN / Query Trace -Replication / WAL/Binlog -Buffer 確認 / Fragmentation -Connection Leak -``` - ---- - -## 🚀 E2E テスト（Playwright 必須） - -Playwright を必須利用すること。 - -以下を実施。 - -1. ログイン -2. CRUD -3. 承認フロー -4. CSV アップロード -5. PDF 出力 -6. モバイル UI -7. 権限制御 -8. エラー画面 -9. タイムアウト -10. 多重操作 - ---- - -## 🔄 CI/CD 連携指示 - -GitHub Actions と完全連携。以下を自動実行。 - -```yaml -Lint -UnitTest -E2E（Playwright） -SecurityScan -Build -DeployCheck -RegressionTest -``` - ---- - -## 🧠 自動修復ルール - -ClaudeCode は以下を実施。 - -1. エラー解析 -2. 根本原因分析（RCA） -3. 修復 -4. 再テスト -5. RegressionTest -6. ログ記録 - -**上限制御**（CLAUDE.md §12 に従う）: -- CI 自動修復: 最大 5 回 -- 同一原因エラー 2 回連続 → Issue 化して次タスクへ -- 修復試行 3 回到達 → Blocked - ---- - -## 📊 レポート出力 - -必ず以下を出力。 - -```text -- テスト結果（Pass/Fail 件数） -- 失敗項目（番号・内容） -- 原因分析（RCA） -- 修復内容 -- 再発防止策 -- セキュリティ影響 -- パフォーマンス影響 -- 修復成功率 -``` - ---- - -## 📁 推奨ログ構成 - -```text -logs/ -├── frontend/ -├── backend/ -├── security/ -├── infrastructure/ -├── database/ -└── ci/ -``` - ---- - -## 🤖 AI レビュー統合（Codex + CodeRabbit） - -詳細手順は `05-codex-debug.md` / `08-operations.md` を参照。 -ここでは **テスト実行フローにおける利用方法** のみ記述する。 - -### 開発フロー統合順序 - -```text -開発 - ↓ -① /coderabbit:review committed --base main ← 静的解析（高速・広範） - ↓ -② /codex:review --base main --background ← 設計・ロジック深層レビュー - ↓ -両方の指摘を統合して修正 - ↓ -テスト実行（本ファイルの 5 カテゴリ） - ↓ -PR 作成 - ↓ -CodeRabbit PR レビュー（自動） - ↓ -Critical/High 0 件 → マージ -``` - -### AI 役割分担 - -| AI | テスト連携での役割 | -|---|---| -| ClaudeCode | テスト実行・デバッグ・修復・5カテゴリ検証 | -| Codex | 静的解析・改善提案・設計整合性確認 | -| CodeRabbit | PR 差分レビュー・品質ゲート | - -### 品質ゲート（マージ可能条件） - -```text -Codex エラー: 0 件 -CodeRabbit Critical/High: 0 件 -テスト成功率: 100% -セキュリティ検査: PASS -パフォーマンス劣化: なし -``` - ---- - -## 🎯 最終目標 - -ClaudeCode は以下を達成すること。 - -- 高品質 WebUI -- 自律型デバッグ -- 自動品質改善 -- セキュア設計 -- 高可用性・高パフォーマンス -- 運用可能品質 -- ITSM / ISO27001 / ISO20000 準拠レベル - -**「人間がレビュー承認のみを行う品質」を最終目標とする。** - ---- - -## 🚀 完全実装・最終フェーズ指示（全セッション共通） - -### /goal テンプレート（MVP Release Candidate 完成版） - -以下の形式で `/goal` を設定すること: - -```text -/goal "MVP Release Candidate を完成させる。 - -以下を実施対象とする： -- フロントエンド実装 -- バックエンド実装 -- データベース実装 -- セキュリティ実装 -- インフラ構成 -- CI/CD構築 -- テスト -- ドキュメント整備 - -以下を完了条件とする： -1. 全主要画面が正常動作 -2. API疎通成功 -3. 認証認可正常 -4. DB CRUD成功 -5. CI成功 -6. Critical/High脆弱性ゼロ -7. E2Eテスト成功 -8. README/運用手順完成 -9. Docker起動成功（docker-compose.yml がある場合のみ） -10. ローカル環境で再現可能 - -以下は今回対象外： -- 過剰なUI改善 -- Enterprise拡張機能 -- AI最適化 -- マイクロサービス分離 -- 過剰なリファクタリング - -以下の場合は停止する： -- MVP完成 -- CI成功 -- リリース条件達成 -- 修復ループ上限到達" -``` - -### 必須実行事項 - -| 項目 | 指示 | -|---|---| -| 🤖 Agent Teams | パターン A（並列実装）・B（品質強化）を最大活用すること | -| ⚡ Auto Mode | 自律開発を実行すること（人間の介入なし） | -| 📊 可視化 | 全プロセス・状況をリアルタイムで可視化すること | -| 📖 ドキュメント | README.md・GitHub Projects を常に最新化すること | -| 🐰 CodeRabbit | 全 PR に必須適用。Critical/High 指摘はマージ前に必ず修正 | -| 🛡️ Codex Review | Development フェーズ後・PR 作成前に必須実行 | -| 🧪 テスト検証 | `11-test-debug-integration.md` の 5 カテゴリを全て実施すること | - -### 完了条件 - -```text -1. 全主要画面が正常動作 -2. API疎通成功 -3. 認証認可正常 -4. DB CRUD成功 -5. CI成功 -6. Critical/High脆弱性ゼロ -7. E2Eテスト成功 -8. README/運用手順完成 -9. Docker起動成功（docker-compose.yml がある場合のみ） -10. ローカル環境で再現可能 -``` - -### 停止条件 - -```text -- MVP完成 -- CI成功 -- リリース条件達成 -- 修復ループ上限到達 -``` - ---- - -## 🏁 ClaudeOS v9.0 — セッション開始・終了プロトコル - -### セッション開始時（必須） - -```bash -# 1. 状態確認 -cat state.json 2>/dev/null || echo "{}" -gh issue list --state open --limit 20 -gh run list --limit 5 -gh pr list --state open - -# 2. /goal 設定 -/goal "MVP Release Candidate を完成させる。完了条件: 全主要画面正常動作・API疎通成功・認証認可正常・DB CRUD成功・CI成功・Critical/High脆弱性ゼロ・E2Eテスト成功・README/運用手順完成・Docker起動成功(docker-compose.ymlがある場合のみ)・ローカル環境再現可能。停止条件: MVP完成・CI成功・リリース条件達成・修復ループ上限到達" - -# 3. Agent View 起動 -claude agents -``` - -> **以降、全てを CTO の判断に任せます。CTO 全権委任で自律開発を続けてください。** - -- 🎯 `/goal` のゴール条件に向けて CTO が動的判断で最適行動を自律選択する -- ⏱ セッション開始時刻を必ず確認し、5 時間を厳守すること -- 🤖 Agent Teams（パターン A/B/C）を状況に応じて自律 spawn すること -- ⚡ Auto Mode による自律開発を実行すること -- 📋 GitHub Projects・README.md を常に更新すること - -**プロジェクト期間は CTO 全権委任で決定（最優先）:** -- 6 か月はデフォルト目安であり、強制制約ではない。CTO 判断で短縮・延長・無期限すべて可 -- 実行は Linux Cron（月〜土、1 セッション最大 5 時間） -- CTO が「デプロイ準備完了」と判断したら `deploy.ready=true` を設定し手順書を自動生成する -- 実際のデプロイは人間（ユーザー）が手動で実行。デプロイ完了後は無期限の保守フェーズへ移行 - -### 自動停止条件 - -```text -/goal 達成（Haiku が条件充足を判定） -同一原因エラー 2 回連続 → Issue 化して次タスクへ -修復試行 3 回到達 → Blocked -5 時間到達 → 終了処理 -コンテキスト圧迫 → 即終了処理 -Token 枯渇 → 安全終了 -Security Critical → 即時対応 -``` +## 🔥 最上位原則 +- Goal Driven +- Security First +- Verify Mandatory +- Stop Infinite Repair +- CTO Final Decision diff --git a/Claude/templates/linux/cron-launcher.sh b/Claude/templates/linux/cron-launcher.sh index 53a9298e..b65b9e0f 100644 --- a/Claude/templates/linux/cron-launcher.sh +++ b/Claude/templates/linux/cron-launcher.sh @@ -31,6 +31,10 @@ PROJECTS_BASE="${PROJECTS_BASE:-$HOME/Projects}" PROJECT_DIR="$PROJECTS_BASE/$PROJECT" REPORT_SCRIPT="${CLAUDEOS_REPORT_SCRIPT:-$CLAUDEOS_HOME/report-and-mail.py}" +# ClaudeOS goals/ の共通テンプレートパス（全プロジェクトから参照） +CLAUDEOS_GOALS_DIR="${CLAUDEOS_GOALS_DIR:-$PROJECTS_BASE/ClaudeCode-StartUpTools-New/Claude/templates/claude/ClaudeOS/goals}" +export CLAUDEOS_GOALS_DIR + mkdir -p "$SESSIONS_DIR" "$LOGS_DIR" chmod 700 "$CLAUDEOS_HOME" "$SESSIONS_DIR" "$LOGS_DIR" 2>/dev/null || true @@ -168,6 +172,7 @@ STATE_FILE="$PROJECT_DIR/state.json" RESUME_PHASE="Monitor" RESUME_CONSECUTIVE=0 RESUME_SUMMARY="" +RESUME_GOAL_TYPE="mvp-release" if [[ -f "$STATE_FILE" ]] && command -v python3 >/dev/null 2>&1; then RESUME_PHASE=$(python3 -c " @@ -192,6 +197,14 @@ try: print(s[:300] if s else '(none)') except: print('(none)') " 2>/dev/null || echo "(none)") + RESUME_GOAL_TYPE=$(python3 -c " +import json,sys +try: + d=json.load(open('$STATE_FILE')) + print(d.get('goal_type','mvp-release')) +except: print('mvp-release') +" 2>/dev/null || echo "mvp-release") + export CLAUDEOS_GOAL_TYPE="$RESUME_GOAL_TYPE" # --- 保守モード分岐 --- # project.phase_mode が "maintenance" なら セッション時間・フェーズを保守用に切替 @@ -263,7 +276,7 @@ if [[ -f "$STATE_FILE" ]]; then if [[ "${PHASE_MODE:-development}" == "maintenance" ]]; then MAINT_NOTE=" [maintenance mode: max ${DURATION_MIN}min, loop=maintenance-loop.md, KPI=SLA/MTTR]" fi - RESUME_HEADER="[Cron Session Resume] phase=${RESUME_PHASE} phase_mode=${PHASE_MODE:-development}${MAINT_NOTE} consecutive_success=${RESUME_CONSECUTIVE} last_summary=${RESUME_SUMMARY} + RESUME_HEADER="[Cron Session Resume] phase=${RESUME_PHASE} phase_mode=${PHASE_MODE:-development}${MAINT_NOTE} goal_type=${RESUME_GOAL_TYPE} goals_dir=${CLAUDEOS_GOALS_DIR} consecutive_success=${RESUME_CONSECUTIVE} last_summary=${RESUME_SUMMARY} " PROMPT_ARG="${RESUME_HEADER}${PROMPT_ARG}"