# 自動継続ドキュメント - AutoContinuation Policy v1.0

**開発コード**: CMO-01-AUTO  
**最終更新日**: 2026/03/09  
**バージョン**: 1.0 (Initial Release)

---

## 🤖 仕組みの概要

このドキュメントは **「進んでください」とポストするだけで、自動的にコーディングが進行する仕組み**を定義します。

### 基本原理
```
┌─────────────────────────────────────────────────────┐
│                    ユーザー                          │
│                  ポスト:"進んでください"              │
└─────────────────┬───────────────────────────────────┘
                  │
                  ▼
    ┌──────────────────────────────────────────────┐
    │       自動継続エンジン (AutoContinuation)      │
    ├──────────────────────────────────────────────┤
    │ 1. short_term_plan.md で次タスク検索          │
    ├──────────────────────────────────────────────┤
    │ 2. 優先度高い未着手タスクを選択                │
    ├──────────────────────────────────────────────┤
    │ 3. 実装ロジックをコード化                      │
    ├──────────────────────────────────────────────┤
    │ 4. Git にコミット + ドキュメント更新           │
    └──────────────────────────────────────────────┘
                  │
                  ▼
    ┌──────────────────────────────────────────────┐
    │              コーディング完了                  │
    └──────────────────────────────────────────────┘
```

---

## 📋 自動化ルール

### R1. タスク選択ロジック（優先度付け）

| 条件 | 実装対象 |
|------|-------------|
| **UI 欠落** (保存ボタン未実装) | 優先度：HIGH ⚡️ |
| **API 接続不足** (DatabaseHelper 未接続) | 優先度：HIGH ⚡️ |
| **PDF 帳票出力** (Printing パッケージ使用準備) | 優先度：MEDIUM 📄 |
| **DocumentDirectory 保存** | 優先度：MEDIUM 💾 |
| **エラーハンドリング強化** | 優先度：LOW 🔧 |
| **UI/UX 改善** | 優先度：LOW 🎨 |

### R2. チェックリストテンプレート（次タスク決定用）

```markdown
- [ ] UI 要素確認（保存ボタン・共有アイコンなど）
- [ ] DatabaseHelper API 接続完了
- [ ] エラーハンドリング完全化（try-catch 追加）
- [ ] PDF 帳票出力ロジック実装
- [ ] DocumentDirectory 自動保存実装
```

### R3. コミットポリシー

```bash
# タスク実装完了時
git add <ファイル名>
git commit -m "feat: <機能名>実装 - short_term_plan.md 参照"

# ドキュメント更新（必須）
git add README.md docs/<ドキュメント名>.md
git commit -m "docs: <機能名>実装完了の記録"
```

---

## 🎯 次タスク決定アルゴリズム

### ステップ 1: short_term_plan.md を読み込み

```yaml
未着手タスク一覧:
  - UI_欠落 (保存ボタン): priority=HIGH, status=TODO
  - API_不足 (insertSales): priority=HIGH, status=TODO
  - PDF_帳票出力：priority=MEDIUM, status=PENDING
```

### ステップ 2: 優先度が高いものを選択

**優先度 HIGH の条件**:
- UI 要素が欠落している
- API 接続が不十分
- エラーハンドリングがない

### ステップ 3: コード実装開始

```dart
// sales_screen.dart の例
Future<void> saveSalesData() async {
  // DatabaseHelper.insertSales 接続
  // エラーハンドリング強化
  // UI フィードバック表示
}
```

### ステップ 4: ドキュメント更新

- README.md の「実装完了セクション」に追加
- short_term_plan.md でタスクチェックオフ
- 変更履歴に記録

---

## 🔧 自動化スクリプト定義（未来用）

### シェルスクリプトによる自動実行（開発中）

```bash
#!/bin/bash
# auto_continue.sh

# 1. short_term_plan.md を読み込み
TASK=$(grep "TODO" docs/short_term_plan.md | head -1)

# 2. タスク名をパース
FUNC_NAME=$(echo $TASK | awk '{print $3}')

# 3. 実装スクリプトを実行（コード生成）
flutter pub run code_generator:$FUNC_NAME

# 4. Git コミット
git add lib/ docs/README.md
git commit -m "feat: $FUNC_NAME実装"

# 5. PR 作成または直接コミット
git push origin master
```

---

## 📊 自動化進捗ダッシュボード

| カテゴリ | 自動化レベル | 担当者 | ステータス |
|---------|--------------|--------|---------------|
| **タスク選択** | ✅ 自動 (AI) | AI エンジン | 進行中 |
| **コード生成** | ⚠️ 半自動 | 開発者 | 完了済み（manual） |
| **コミット** | ✅ 自動 | Git | 完了済み |
| **ドキュメント更新** | ✅ 自動（指示用） | 開発者 | 完了済み |

---

## 🚀 使用例：「進んでください」のフロー

```markdown
## ユーザーアクション

```
ユーザー: "進んでください"
```

## 自動化エンジン処理

1. **short_term_plan.md を読み込み**
   ```yaml
   Sprint 5 タスク:
     - [ ] 見積→請求転換 (priority=HIGH)
     - [ ] Inventory モデル (priority=MEDIUM)
     - [ ] PDF 領収書テンプレート (priority=LOW)
   ```

2. **優先度 HIGH のタスクを選択**
   → `見積→請求転換`

3. **実装コード生成**
   ```dart
   // estimate_screen.dart に転換ボタン追加
   // convertEstimateToInvoice() API 実装
   // invoice_screen.dart の作成
   ```

4. **Git コミット + ドキュメント更新**
   ```bash
   git add lib/ docs/README.md
   git commit -m "feat: 見積→請求転換 UI 実装"
   ```

## 結果

- ✅ 3 分以内に新機能実装完了
- ✅ short_term_plan.md でチェックオフ
- ✅ README.md に更新記録追加
```

---

## 📝 開発チームへの指示

### チームメンバー向けワークフロー

```
┌─────────────────────────────────────┐
│   1. "進んでください" をポスト      │
└─────────────────┬──────────────────┘
                  │
                  ▼
    ┌────────────────────────────────┐
    │   AI: 短時間プランを分析        │
    ├────────────────────────────────┤
    │   AI: 次タスクを決定           │
    ├────────────────────────────────┤
    │   AI: コードを生成・実装       │
    └────────────────────────────────┘
                  │
                  ▼
    ┌────────────────────────────────┐
    │   2-3 分後：完了報告            │
    └────────────────────────────────┘
```

### チェックオフルール

| チェック項目 | 条件 | アクション |
|-------------|------|---------------|
| **UI 確認** | ボタン/アイコン追加済 | ✅ Check |
| **API 接続** | DatabaseHelper 動作確認済 | ✅ Check |
| **エラーハンドリング** | try-catch 完了 | ✅ Check |
| **ドキュメント更新** | README.md + short_term_plan | ✅ Check |

---

## 🎯 次のスプリント（Sprint 5）の自動継続計画

### プリセットされたタスクリスト

```yaml
# docs/short_term_plan.md に登録済み
Sprint 5 タスクリスト:
  - 見積→請求転換 UI (priority=HIGH)
    * estimate_screen.dart → convertEstimateToInvoice()
    * invoice_screen.dart の作成
    
  - Inventory モデル (priority=MEDIUM)
    * inventory_model.dart の定義
    * DatabaseHelper CRUD API
    
  - PDF 領収書テンプレート (priority=LOW)
    * receipt_template.dart の設計
    
  - Google Sign-In (priority=PLANNING)
    * google_sign_in.dart の実装
```

### 自動化ポリシー（Sprint 5 以降）

1. **毎週月曜日**: short_term_plan.md で次タスク確定
2. **毎日 "進んでください"**: AI がコードを実装
3. **完了確認**: README.md + Git log を参照

---

## 📚 リンク情報

- [工程管理ガイド](./engineering_management.md) - 全体方針
- [短期計画](./short_term_plan.md) - 次タスクリスト
- [長期計画](./long_term_plan.md) - ミレストーン目標

---

**最終更新**: 2026/03/09  
**バージョン**: 1.0  
**作成者**: AutoContinuation System