@takuma-hirai/hirai-method 0.1.0

package/.claude/commands/approve-org-money.md

@@ -0,0 +1,267 @@
+---
+name: approve_org_money
+description: "稟議承認の作成 - 新規申請・リプレイスの稟議書をMarkdownで自動生成"
+category: workflow
+complexity: enhanced
+model: opus
+---
+
+# /approve_org_money - 稟議書作成
+
+## 概要
+
+新規サービス/ツール導入またはリプレイス（乗り換え）の稟議書を対話形式で作成するコマンド。
+金額比較表・移行期間コスト・年間コスト試算を自動計算し、Markdownで出力する。
+
+## 使用方法
+
+```
+/approve_org_money [サービス名/ツール名]
+```
+
+引数なしの場合は対話で確認する。
+
+## 実行フロー
+
+### A-1: 申請種別の確認
+
+ユーザーに以下を確認:
+
+1. **申請種別**: 新規申請 or リプレイス
+2. **サービス/ツール名**: 何を導入するか
+3. **出力フォルダ名**: 稟議書の保存先フォルダ名（デフォルト: サービス名）
+
+### A-2: 共通情報のヒアリング（新規・リプレイス共通）
+
+以下の項目を対話で収集する:
+
+| #   | 項目               | 説明                                    | 必須 |
+| --- | ------------------ | --------------------------------------- | ---- |
+| 1   | サービス/ツール名  | 導入するサービスの正式名称              | 必須 |
+| 2   | カテゴリ           | SaaS / インフラ / ハードウェア / その他 | 必須 |
+| 3   | 初回決済額（税込） | 初期費用・セットアップ費用等            | 必須 |
+| 4   | 月額換算額（税込） | 月額にならした金額                      | 必須 |
+| 5   | 契約プラン         | プラン名・ライセンス数等                | 必須 |
+| 6   | 更新日             | 契約更新日（年次/月次/更新なし）        | 必須 |
+| 7   | 契約期間           | 月単位 or 年単位（自動更新の有無）      | 必須 |
+| 8   | 導入背景・理由     | なぜ今導入が必要か                      | 必須 |
+| 9   | 期待効果           | 導入により何が改善されるか              | 推奨 |
+| 10  | 決済方法           | クレジットカード / 請求書 / その他      | 推奨 |
+| 11  | 利用者             | 利用する部署・人数                      | 推奨 |
+| 12  | 備考               | その他特記事項                          | 任意 |
+
+### A-3: リプレイス追加情報のヒアリング（リプレイスの場合のみ）
+
+リプレイスの場合、A-2に加えて以下を収集:
+
+| #   | 項目                           | 説明                       | 必須 |
+| --- | ------------------------------ | -------------------------- | ---- |
+| R1  | 現行サービス名                 | 置き換え元のサービス名     | 必須 |
+| R2  | 現行月額（税込）               | 現在支払っている月額       | 必須 |
+| R3  | 現行年額（税込）               | 現在の年間コスト           | 必須 |
+| R4  | リプレイス完了予定日           | 移行完了目標日             | 必須 |
+| R5  | 移行期間                       | 並行稼働の開始日〜完了日   | 必須 |
+| R6  | リプレイス完了後の月額（税込） | 移行完了後に支払う月額     | 必須 |
+| R7  | 現行サービスの解約条件         | 解約通知期限・違約金等     | 推奨 |
+| R8  | リプレイス理由                 | 現行サービスの課題・不満点 | 必須 |
+
+### A-4: コスト計算
+
+#### 新規申請の場合
+
+以下を自動計算:
+
+- **初年度コスト**: 初回決済額 + (月額 x 残月数)
+- **年間コスト**: 月額 x 12
+- **3年間総コスト**: 初回決済額 + (月額 x 36)
+
+#### リプレイスの場合
+
+以下を自動計算:
+
+**並行稼働期間コスト表**（月次）:
+
+| 月          | 現行サービス | 新サービス | 合計    | 備考           |
+| ----------- | ------------ | ---------- | ------- | -------------- |
+| 移行1ヶ月目 | ¥XX,XXX      | ¥XX,XXX    | ¥XX,XXX | 並行稼働       |
+| 移行2ヶ月目 | ¥XX,XXX      | ¥XX,XXX    | ¥XX,XXX | 並行稼働       |
+| ...         | ...          | ...        | ...     | ...            |
+| 移行完了後  | ¥0           | ¥XX,XXX    | ¥XX,XXX | 新サービスのみ |
+
+**コスト比較サマリ**:
+
+- 現行の年間コスト
+- 移行期間の追加コスト（並行稼働分）
+- リプレイス完了後の年間コスト
+- 年間削減額 or 年間増加額
+- 移行コスト回収期間（増加の場合はN/A）
+
+### A-5: 稟議書生成
+
+収集した情報とコスト計算結果を元に稟議書を生成する。
+
+## 出力テンプレート
+
+### 新規申請テンプレート
+
+```markdown
+# 稟議書: [サービス名] 新規導入
+
+| 項目       | 内容                   |
+| ---------- | ---------------------- |
+| 申請種別   | 新規申請               |
+| 申請日     | YYYY-MM-DD             |
+| サービス名 | [サービス名]           |
+| カテゴリ   | [SaaS / インフラ / 他] |
+
+## 1. 導入背景・理由
+
+[導入背景・理由を記載]
+
+## 2. 期待効果
+
+[期待効果を記載]
+
+## 3. コスト詳細
+
+| 項目       | 金額（税込） |
+| ---------- | ------------ |
+| 初回決済額 | ¥XX,XXX      |
+| 月額       | ¥XX,XXX      |
+| 契約プラン | [プラン名]   |
+| 契約期間   | [期間]       |
+| 更新日     | [更新日]     |
+
+### 年間コスト試算
+
+| 期間                   | 金額（税込） |
+| ---------------------- | ------------ |
+| 初年度（初回費用含む） | ¥XX,XXX      |
+| 2年目以降（年額）      | ¥XX,XXX      |
+| 3年間総額              | ¥XX,XXX      |
+
+## 4. 契約情報
+
+| 項目     | 内容         |
+| -------- | ------------ |
+| 決済方法 | [決済方法]   |
+| 利用者   | [部署・人数] |
+
+## 5. 備考
+
+[備考]
+```
+
+### リプレイステンプレート
+
+```markdown
+# 稟議書: [新サービス名] 導入（[現行サービス名] リプレイス）
+
+| 項目           | 内容                   |
+| -------------- | ---------------------- |
+| 申請種別       | リプレイス             |
+| 申請日         | YYYY-MM-DD             |
+| 新サービス名   | [新サービス名]         |
+| 現行サービス名 | [現行サービス名]       |
+| カテゴリ       | [SaaS / インフラ / 他] |
+
+## 1. リプレイス背景・理由
+
+### 現行サービスの課題
+
+[現行サービスの課題・不満点]
+
+### 新サービス導入の理由
+
+[導入背景・理由]
+
+## 2. 期待効果
+
+[期待効果を記載]
+
+## 3. コスト詳細
+
+### 現行サービス
+
+| 項目 | 金額（税込） |
+| ---- | ------------ |
+| 月額 | ¥XX,XXX      |
+| 年額 | ¥XX,XXX      |
+
+### 新サービス
+
+| 項目       | 金額（税込） |
+| ---------- | ------------ |
+| 初回決済額 | ¥XX,XXX      |
+| 月額       | ¥XX,XXX      |
+| 契約プラン | [プラン名]   |
+| 契約期間   | [期間]       |
+| 更新日     | [更新日]     |
+
+### コスト比較
+
+| 比較項目 | 現行    | 新サービス | 差額     |
+| -------- | ------- | ---------- | -------- |
+| 月額     | ¥XX,XXX | ¥XX,XXX    | ¥±XX,XXX |
+| 年額     | ¥XX,XXX | ¥XX,XXX    | ¥±XX,XXX |
+
+## 4. 移行計画
+
+| 項目                 | 内容                     |
+| -------------------- | ------------------------ |
+| リプレイス完了予定日 | YYYY-MM-DD               |
+| 移行期間             | YYYY-MM-DD 〜 YYYY-MM-DD |
+| 現行サービス解約条件 | [解約条件]               |
+
+### 並行稼働期間のコスト
+
+| 月      | 現行サービス | 新サービス | 月額合計 | 備考         |
+| ------- | ------------ | ---------- | -------- | ------------ |
+| YYYY-MM | ¥XX,XXX      | ¥XX,XXX    | ¥XX,XXX  | 並行稼働開始 |
+| YYYY-MM | ¥XX,XXX      | ¥XX,XXX    | ¥XX,XXX  | 並行稼働     |
+| YYYY-MM | ¥0           | ¥XX,XXX    | ¥XX,XXX  | 移行完了     |
+
+### 移行コストサマリ
+
+| 項目                         | 金額（税込）             |
+| ---------------------------- | ------------------------ |
+| 並行稼働期間の追加コスト     | ¥XX,XXX                  |
+| リプレイス完了後の年間コスト | ¥XX,XXX                  |
+| 年間コスト増減               | ¥±XX,XXX（XX%削減/増加） |
+| 移行コスト回収期間           | XXヶ月 / N/A             |
+
+## 5. 契約情報
+
+| 項目     | 内容         |
+| -------- | ------------ |
+| 決済方法 | [決済方法]   |
+| 利用者   | [部署・人数] |
+
+## 6. 備考
+
+[備考]
+```
+
+## 出力先
+
+```
+doc_draft/approve_org_money/
+└── [フォルダ名]/
+    └── approval.md
+```
+
+## コスト計算ルール
+
+1. **金額はすべて税込表記**
+2. **月額換算**: ユーザーが入力した月額をそのまま使用（年額プランの場合は年額÷12で算出）
+3. **並行稼働コスト**: 移行期間の月数 x (現行月額 + 新サービス月額) で算出
+4. **年間削減額**: 現行年額 - 新サービス年額
+5. **回収期間**: 並行稼働追加コスト ÷ 月間削減額（削減がない場合はN/A）
+6. **3年間総コスト**: 初回決済額 + (月額 x 36) で算出
+
+## 注意事項
+
+- 金額はすべて税込で入力してもらう
+- 不明な項目は「未定」として記載し、後から更新可能
+- リプレイスの並行稼働期間は月単位で計算（日割りは行わない）
+- 生成後にユーザーが内容を確認し、修正があれば対話で更新する

package/.claude/commands/build.md

@@ -0,0 +1,234 @@
+---
+name: build
+description: "構築開始 - タスク分解に基づき実装・PR作成・レビュー依頼を実行"
+category: workflow
+complexity: enhanced
+model: opus
+mcp-servers: [asana, slack, github, salesforce]
+---
+
+# /build - 構築フェーズ
+
+## 概要
+
+AIネイティブ開発フローのフェーズC「構築」を実行するコマンド。
+タスク分解に基づき、実装・コミット・PR作成を自動実行します。
+
+## トリガー
+
+- `/design` 完了後
+- 設計書の承認後
+- 工数承認後
+
+## 使用方法
+
+```
+/build [Asana依頼名]
+```
+
+または
+
+```
+/build
+# → doc_draft/design/ から最新のタスク分解を自動検出
+```
+
+## 実行フロー
+
+### C-1: 構築開始
+
+1. タスク分解.md を読み込み
+2. 実装計画を確認
+
+### C-2: Asanaサブタスク作成
+
+タスク分解に基づき、Asanaにサブタスクを自動作成
+
+- 予定時間を設定
+- 担当者を割り当て
+
+### C-3: ai-agent担当タスク実行
+
+各タスクに対して:
+
+1. `.ai/rules/` 配下のコーディングルールを読み込み
+   - `apex-naming.md` - 命名規則
+   - `apex-documentation.md` - ドキュメンテーション規則
+   - `security-checklist.md` - セキュリティチェックリスト
+2. 設計書に基づき実装（コーディングルール準拠）
+3. テストコード作成（コーディングルール準拠）
+4. コミット
+
+### C-4: エンジニア担当タスク通知
+
+手動タスクについてエンジニアへ通知
+
+### C-5: コーディングルールチェック
+
+PR作成前に `/lint-rules` 相当のチェックを実行:
+
+1. 新規作成ファイルを対象にルールチェック
+2. 違反があれば自動修正
+3. 修正後に再コミット
+
+チェック項目:
+
+- **命名規則**: クラス名、メソッド名、変数名
+- **ドキュメンテーション**: クラス/メソッドのコメント
+- **セキュリティ**: SOQL インジェクション、XSS、アクセス制御
+
+### C-5.5: オブジェクト設計書自動更新
+
+PR作成前にオブジェクトメタデータの変更を検出し、設計書を自動更新:
+
+1. `git diff --name-only HEAD~1` でオブジェクトメタデータの変更を検出
+   - 対象パス: `force-app/main/default/objects/`
+2. 変更されたオブジェクトに対して設計書を自動生成
+   ```bash
+   python3 ai_scripts/generate_object_doc.py <ObjectApiName>
+   ```
+3. 生成された設計書を `doc/detailed-design/objects/` に配置
+4. 変更があれば自動コミット
+   ```
+   docs: オブジェクト設計書を自動更新 (<ObjectApiName>)
+   ```
+
+**注意:**
+
+- `generate_object_doc.py` はメタデータXMLを解析し、項目一覧・入力規則・関連トリガー/フロー/Apexクラスを含む設計書を生成
+- 変更がない場合はスキップ
+
+### C-6: PR作成
+
+全タスク完了後:
+
+1. PRをGitHubに作成
+2. エンジニアへSlack通知
+
+### C-7: コードレビュー
+
+エンジニアによるレビュー:
+
+- 修正依頼 → 修正 → 再レビュー
+- 承認 → マージ
+
+## 出力物
+
+```
+force-app/main/default/
+├── classes/
+│   ├── [実装クラス].cls
+│   └── [テストクラス].cls
+├── triggers/
+│   └── [トリガー].trigger
+└── lwc/
+    └── [コンポーネント]/
+
+doc/detailed-design/objects/
+└── [オブジェクトAPI名].md  ← C-5.5で自動生成
+
+GitHub
+└── Pull Request
+
+Asana
+└── サブタスク（予定時間付き）
+```
+
+## 実装ガイドライン
+
+### Apex
+
+```apex
+// バルク処理を考慮
+// SOQL ループ禁止、コレクション化
+// CRUD/FLS/Sharing を明示的に考慮
+```
+
+### LWC
+
+```javascript
+// コロケーション（コンポーネントとテストを同一フォルダに配置）
+// @wire と imperative 呼び出しを適切に使い分け
+// アクセシビリティを考慮
+```
+
+### テスト
+
+```apex
+// テスト名は日本語で明確に
+// 正常系・異常系・境界値をカバー
+// @isTest アノテーション使用
+```
+
+## MCP連携
+
+| MCP          | 用途                         |
+| ------------ | ---------------------------- |
+| `asana`      | サブタスク作成、進捗更新     |
+| `slack`      | レビュー依頼通知、完了通知   |
+| `github`     | コミット、PR作成、レビュー   |
+| `salesforce` | メタデータ確認、デプロイ検証 |
+
+## コミットメッセージ規約
+
+```
+<type>: <subject>
+
+<body>
+
+Refs: Asana#<task-id>
+```
+
+**type:**
+
+- `feat`: 新機能
+- `fix`: バグ修正
+- `refactor`: リファクタリング
+- `test`: テスト
+- `docs`: ドキュメント
+
+## PR テンプレート
+
+```markdown
+## 概要
+
+<!-- 変更内容の概要 -->
+
+## 関連タスク
+
+- Asana: [タスク名](URL)
+- 設計書: `doc_draft/design/[Asana依頼名]/`
+
+## 変更内容
+
+- [ ] 機能1
+- [ ] 機能2
+
+## テスト
+
+- [ ] 単体テスト
+- [ ] 統合テスト
+
+## レビュー観点
+
+- [ ] ガバナ制限の考慮
+- [ ] バルク処理対応
+- [ ] CRUD/FLS/Sharing
+```
+
+## 注意事項
+
+- 実装は必ず設計書に基づく
+- テストカバレッジ75%以上を維持
+- セキュリティ脆弱性を導入しない
+- 既存コードを勝手に変更しない
+
+## 完了条件
+
+1. 全タスクが完了
+2. PRがマージされる
+3. Asanaサブタスクが完了
+
+## 次のステップ
+
+マージ完了後、リリースノート自動作成（展望）

package/.claude/commands/commit.md

@@ -0,0 +1,97 @@
+---
+description: Conventional Commits 形式の commit メッセージを diff から自動生成。CLAUDE.md "Autonomous Progression" 準拠、Co-Authored-By 不要、scope 自動検出。
+---
+
+# /commit — Conventional Commits 自動生成
+
+`git diff` を分析し、CLAUDE.md "Autonomous Progression" の commit 規約に沿った commit message を生成します。
+
+## 使い方
+
+```
+/commit                       # staged (なければ全変更) を自動 commit 提案
+/commit <scope ヒント>         # scope を強制指定 (例: /commit harness)
+```
+
+引数で scope を指定可能。指定がなければ変更ファイルパスから自動推定。
+
+## 動作
+
+1. `git status --short` で変更内容を確認
+2. **staged が空なら明示的に staging しない** — ユーザーが意図的に staging したファイルを尊重し、空なら全部 staging すべきか確認する
+3. `git diff --cached` (or `git diff` if nothing staged) で diff を取得
+4. 変更を分析:
+   - `src/lib/` → scope=lib
+   - `src/components/` → scope=ui
+   - `src/app/api/` → scope=api
+   - `supabase/migrations/` → scope=db
+   - `.claude/` → scope=harness
+   - `docs/` → scope=docs
+   - `.github/` `package.json` 等 → scope=repo
+5. type を推定:
+   - `feat:` 新機能・新エンドポイント・新ページ
+   - `fix:` バグ修正(既存挙動の修正)
+   - `refactor:` 機能変更を伴わない構造改善
+   - `docs:` ドキュメントのみ
+   - `test:` テスト追加/修正
+   - `chore:` 設定・依存更新
+   - `perf:` パフォーマンス改善
+   - `ci:` CI/CD 設定
+   - `style:` フォーマットのみ(コード意味に影響なし)
+6. **複数の論理単位**が含まれていたら警告し、commit を分割する案を提示
+7. 関連 issue 番号を以下から推定:
+   - 現在のブランチ名 (`feature/issue-42-foo` → `(#42)`)
+   - diff 内の `(#NN)` 言及
+   - `docs/tasks/list.md` の進行中タスク
+8. メッセージを生成して提示し、**ユーザー承認後に commit**
+
+## 出力フォーマット
+
+```
+<type>(<scope>): <subject> (#<issue>)
+
+- <変更点 1>
+- <変更点 2>
+
+Closes #<issue>
+```
+
+例(本リポの commit log から):
+```
+fix(harness): close Bash delegation gap + use afplay for reliable Stop sound
+chore(repo): ignore .claude/skills/ + output/ artifacts
+docs(sync): align design docs with Phase 11 W2 + #33-#41 reality
+fix(css): scope .rich-source-link block style + inline rescue (#37 hotfix)
+fix(related): handle multi-chunk source embeddings (#33 follow-up)
+```
+
+## 制約・原則
+
+- **CLAUDE.md "Autonomous Progression" 準拠**:
+  - subject は **70 文字以内**、命令形・現在形(add/fix not added/fixed)
+  - 大文字始まり禁止 (`feat:Add` ではなく `feat: add`)
+  - 末尾 `.` を付けない
+- **Co-Authored-By を絶対に追加しない**(`~/.claude/settings.json` でグローバル無効化済)
+- **`--no-verify` 禁止** — pre-commit hook が失敗したら原因を直す
+- **意図せず staged にない変更を含めない** — `git add -A` を勝手に走らせない
+- 関連 issue 不明時は `(#?)` ではなく**省略**(後で `git commit --amend` で追加可能)
+
+## サブエージェント連携
+
+複雑な diff(多数ファイル / 言語混在 / 設計変更含む)では以下を活用:
+
+- **typescript-reviewer**(グローバル ~/.claude/agents/) — TS/JS の意味的レビュー
+- **code-reviewer**(グローバル) — 一般品質チェック
+- **debugger**(グローバル、本セッションで追加) — 既存挙動が壊れた疑いがあれば
+
+## 注意点
+
+- staged 0 件でユーザーが「全部入れて」と明示したら `git add -A` で staging
+- pre-commit hook が失敗 → fix → **新しい commit を作成**(`--amend` 禁止、CLAUDE.md の git ガード方針)
+- 100 行を超える diff は内容サマリのみ提示、メッセージ生成精度を優先
+
+## 関連
+
+- テンプレート: [`.gitmessage`](../../.gitmessage)
+- 規約: [CLAUDE.md "Autonomous Progression"](../../CLAUDE.md#autonomous-progression自律進行ルール)
+- 不変ルール: [CLAUDE.md](../../CLAUDE.md) の Development Policy

package/.claude/commands/context-fetch.md

@@ -0,0 +1,113 @@
+---
+name: context-fetch
+description: "関連情報取得 - Asana/Slack/GitHubから並列で情報を収集"
+category: skill
+complexity: basic
+model: haiku
+mcp-servers: [asana, slack, github]
+---
+
+# /context-fetch - 関連情報取得スキル
+
+## 概要
+
+Asana・Slack・GitHubから関連情報を並列で取得するヘルパースキル。
+`/requirement` や `/design` コマンドから内部的に呼び出されます。
+
+## 使用方法
+
+```
+/context-fetch [Asanaタスク名またはURL]
+```
+
+オプション:
+
+```
+/context-fetch [タスク] --source asana,slack,github
+/context-fetch [タスク] --depth shallow|deep
+```
+
+## 実行フロー
+
+### 1. Asana情報取得
+
+- タスク詳細
+- コメント履歴
+- 関連タスク
+- 添付ファイル
+
+### 2. Slack情報取得
+
+#### トークン確認
+
+Slackのメッセージ検索はUser Token（xoxp）が必要です。
+
+| トークン設定           | 検索機能    | 動作               |
+| ---------------------- | ----------- | ------------------ |
+| User Token（xoxp）あり | ✅ 利用可能 | 通常通り検索実行   |
+| Bot Token（xoxb）のみ  | ❌ 利用不可 | **検索をスキップ** |
+
+#### User Tokenが設定されている場合
+
+- タスク名に関連するスレッド検索
+- 関連チャンネルの議論
+- メンション・リンク
+
+#### Bot Tokenのみの場合（User Token未設定）
+
+```
+⚠️ Slackメッセージ検索をスキップしました（User Tokenが未設定のため）
+```
+
+検索はスキップし、他の情報取得（Asana/GitHub）は継続します。
+
+### 3. GitHub情報取得
+
+- 関連するPR/Issue
+- 既存コードの参照
+- コミット履歴
+
+## 出力フォーマット
+
+```markdown
+## コンテキスト情報
+
+### Asana
+
+| 項目       | 内容 |
+| ---------- | ---- |
+| タスク名   | xxx  |
+| ステータス | xxx  |
+| 担当者     | xxx  |
+| 期日       | xxx  |
+
+#### コメント
+
+- [日時] ユーザー: コメント内容
+
+### Slack
+
+#### 関連スレッド
+
+- [チャンネル名](URL) - スレッド概要
+
+### GitHub
+
+#### 関連コード
+
+- `path/to/file.cls` - 説明
+```
+
+## MCP連携
+
+| MCP      | 取得情報                         |
+| -------- | -------------------------------- |
+| `asana`  | タスク詳細、コメント、関連タスク |
+| `slack`  | スレッド検索、チャンネル履歴     |
+| `github` | コード検索、PR/Issue、コミット   |
+
+## 注意事項
+
+- 並列で情報取得を行い、効率化
+- 取得情報は構造化して返却
+- 機密情報は適切にフィルタリング