@aramassa/ai-rules 0.9.3 → 0.9.4

package/artifact/prompts/development/plan-fix.prompt.md

@@ -1,10 +1,10 @@
 ---
 type: prompt
-category: workflow
-focus: plan-to-implementation
+name: plan-fix
+description: "VS Code Plan モードから Agent Coding への移行を自動化。計画完成後の Git/GitHub 操作を簡略化し、効率的な開発ワークフローを実現。"
+agent: agent
 ---
-
-## prompt plan-fix ワークフロー
+# prompt plan-fix ワークフロー
 
 ### 概要
 
@@ -21,8 +21,7 @@ VS Code の Plan モードで作成した計画が完成したら、この promp
 
 ### 前提条件
 
-- VS Code の Plan モードで `todo_plans/` に計画ファイルが作成済み
-- 計画の内容が十分に詳細化されている
+- 計画の内容が十分に詳細化されている（まだファイル化していなくてもよい）
 - Git リポジトリが初期化されている
 
 ### ワークフロー
@@ -42,25 +41,95 @@ git pull origin main
 - [ ] ローカルが最新の状態である
 - [ ] コンフリクトが発生していない
 
-#### Step 2: 計画の最終確認
-
-`todo_plans/` ディレクトリ内の計画ファイルを確認します。
+#### Step 2: 仮の GitHub Issue を起票して IssueNumber を取得
 
-**チェック項目**:
-- [ ] ファイル名が `YYYYMMDD_[機能名].md` 形式である
-- [ ] 背景、やること、実装計画が明確に記載されている
-- [ ] Phase 分けがされている
-- [ ] 受け入れ基準が記載されている
+このフローでは `todo_plans/${IssueNumber}/index.md` を正とし、**Issue 本文は必ず `index.md` と一致**させます。
+そのため、まず仮の内容で Issue を作成して IssueNumber を取得します。
 
-**計画の例**:
-```
-todo_plans/
-└── 20250115_cli_feature_implementation.md
+```bash
+# 仮の本文（後で index.md に置き換える）
+TEMP_BODY="(placeholder)\n\n※この Issue の本文は todo_plans/${IssueNumber}/index.md と同期する" \
+
+# Issue を作成して URL を取得（例: https://github.com/ORG/REPO/issues/123）
+ISSUE_URL=$(gh issue create \
+   --title "[機能名]: [機能概要]" \
+   --body "$TEMP_BODY" \
+   --label "enhancement")
+
+# URL 末尾から Issue 番号を取り出す
+ISSUE_NUMBER=$(basename "$ISSUE_URL")
+echo "$ISSUE_NUMBER"
 ```
 
-#### Step 3: GitHub Issue を起票
+**確認ポイント**:
+- [ ] Issue が正しく作成された
+- [ ] Issue 番号（`ISSUE_NUMBER`）が取得できた
+
+#### Step 3: `todo_plans/${IssueNumber}/` を作成し、index.md を作る（Issue 本文と同期）
+
+Issue 番号を使って、計画ディレクトリを作成します。
+
+**作成するファイル**:
+- `todo_plans/${ISSUE_NUMBER}/index.md`（必須：人間が読む用。要点のみ。Issue 本文と必ず一致させる）
+- `todo_plans/${ISSUE_NUMBER}/details.md`（任意：補足情報の例。長くてよい）
+- `todo_plans/${ISSUE_NUMBER}/*.md`（任意：補足は分割して複数ファイルを作ってよい。例: `testing.md`, `risks.md`, `notes.md`）
+
+```bash
+mkdir -p "todo_plans/${ISSUE_NUMBER}"
+
+# まずテンプレを作る（必要なら手で編集）
+cat > "todo_plans/${ISSUE_NUMBER}/index.md" <<'EOF'
+# 変更概要（3行）
+- 
+- 
+- 
+
+## 対象
+- パッケージ/モジュール: 
+
+## 動作確認
+- 
+
+## 稼働中システムへの影響
+- 
 
-計画ファイルを元に GitHub Issue を作成します。
+## 破壊的変更
+- なし / あり（内容: ）
+
+## 計画ファイル一覧
+- `index.md`: この Issue 本文（要点のみ）
+- `details.md`: 実装の詳細（背景、実装方針、Phase、受け入れ基準など）
+- その他の補足ファイル（必要に応じて作成）:
+  - `testing.md`: テスト戦略・テストケース
+  - `risks.md`: リスク評価と対策
+  - `notes.md`: 設計メモ・その他補足
+EOF
+
+cat > "todo_plans/${ISSUE_NUMBER}/details.md" <<'EOF'
+# 補足（自由記述）
+
+※補足はこのファイルに「全部」書く必要はありません。
+`todo_plans/${ISSUE_NUMBER}/` 配下に、用途別にファイルを増やしてOKです（例: `testing.md`, `risks.md`, `notes.md`）。
+
+## 背景
+
+## 実装方針
+
+## 実装計画（Phase）
+
+## 受け入れ基準
+
+## ロールバック/切り戻し
+EOF
+
+# Issue 本文を index.md に必ず一致させる
+gh issue edit "$ISSUE_NUMBER" --body-file "todo_plans/${ISSUE_NUMBER}/index.md"
+```
+
+**チェック項目**:
+- [ ] `todo_plans/${ISSUE_NUMBER}/index.md` が「要点のみ」で読める分量になっている
+- [ ] `index.md` から、(1) どんな変更か(3行) (2) 対象パッケージ/モジュール (3) 動作確認計画 (4) 稼働中影響 (5) 破壊的変更の有無 (6) 計画ファイル一覧 が分かる
+- [ ] Issue 本文が `index.md` と一致している（差分がない）
 
 **Issue 作成のポイント**:
 - タイトル: `[機能名]: [機能概要]` の形式に統一
@@ -111,7 +180,7 @@ git branch --show-current
 
 ```bash
 # 計画ファイルをステージング
-git add todo_plans/YYYYMMDD_[機能名].md
+git add todo_plans/${ISSUE_NUMBER}/index.md todo_plans/${ISSUE_NUMBER}/details.md
 
 # コミット
 git commit -m "Add implementation plan for [機能名]
@@ -192,18 +261,29 @@ git checkout main
 git pull origin main
 
 # Step 2: 計画ファイルを確認（手動）
-# todo_plans/YYYYMMDD_[機能名].md を確認
+# このフローでは Issue 本文 = todo_plans/${ISSUE_NUMBER}/index.md を保証する
 
-# Step 3: GitHub Issue を作成（Web UIまたはCopilot Chat経由）
+# Step 2: 仮の Issue を作って Issue 番号を取得
+TEMP_BODY="(placeholder)\n\n※この Issue の本文は todo_plans/${IssueNumber}/index.md と同期する"
+ISSUE_URL=$(gh issue create \
+   --title "[機能名]: [機能概要]" \
+   --body "$TEMP_BODY" \
+   --label "enhancement")
+ISSUE_NUMBER=$(basename "$ISSUE_URL")
 
-# Issue 番号を設定（例: #123）
-ISSUE_NUMBER=123
+# Step 3: todo_plans/${ISSUE_NUMBER}/ を作って index.md & details.md を作成
+mkdir -p "todo_plans/${ISSUE_NUMBER}"
+${EDITOR:-vi} "todo_plans/${ISSUE_NUMBER}/index.md"
+${EDITOR:-vi} "todo_plans/${ISSUE_NUMBER}/details.md"  # 任意。必要なら、他の *.md を追加してよい
+
+# Step 3.1: Issue 本文を index.md と同期
+gh issue edit "$ISSUE_NUMBER" --body-file "todo_plans/${ISSUE_NUMBER}/index.md"
 
 # Step 4: plan ブランチを作成
 git checkout -b plan/${ISSUE_NUMBER}
 
 # Step 5: 計画ファイルをコミット
-git add todo_plans/YYYYMMDD_[機能名].md
+git add todo_plans/${ISSUE_NUMBER}/index.md todo_plans/${ISSUE_NUMBER}/details.md
 git commit -m "Add implementation plan for [機能名]
 
 - [変更内容1]
@@ -224,7 +304,8 @@ echo "Next: Start Agent Coding with base branch plan/${ISSUE_NUMBER}"
 
 #### 計画ファイルの準備
 
-- **詳細度**: Agent が迷わず実装できるレベルの詳細度を確保
+- **index.md**: 人間が読む前提で、要点だけに絞る（Issue 本文と一致させる正本）
+- **補足ファイル**: 長い背景/Phase/受け入れ基準などは `todo_plans/${ISSUE_NUMBER}/` 配下に分割して置く（`details.md` はその一例）
 - **Phase 分け**: 1つの Phase が 2-3時間で完了する規模に分割
 - **受け入れ基準**: 検証可能な形で明記
 
@@ -308,9 +389,12 @@ git push -u origin plan/${ISSUE_NUMBER}
 ```bash
 git checkout plan/${ISSUE_NUMBER}
 # 計画ファイルを修正
-git add todo_plans/YYYYMMDD_[機能名].md
+git add todo_plans/${ISSUE_NUMBER}/index.md todo_plans/${ISSUE_NUMBER}/details.md
 git commit -m "Update implementation plan: [変更内容]"
 git push
+
+# Issue 本文を index.md に再同期
+gh issue edit "$ISSUE_NUMBER" --body-file "todo_plans/${ISSUE_NUMBER}/index.md"
 ```
 
 #### Q4: 複数の Agent タスクを並行して実行したい場合は？

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aramassa/ai-rules",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "description": "This repository collects guidelines and instructions for developing AI agents. It contains documents covering communication rules, coding standards, testing strategies, and general operational practices.",
   "workspaces": [
     "packages/extract",