# ANCP技術実装チェックリスト

Date: 2025-09-03

## 🔧 Codex先生の技術要件

### コア実装要件
- [ ] **AST正規化（P*）**
  - [ ] コメント処理ポリシー決定
  - [ ] 空白・改行の正規化ルール
  - [ ] import文の順序統一
  - [ ] 決定的（idempotent）動作の保証

- [ ] **トークン設計**
  - [ ] GPT/Claude/Geminiトークナイザー分析
  - [ ] 最適記号セット選定（BPE-friendly）
  - [ ] 予約語マッピングテーブル
  - [ ] エスケープシーケンス設計

- [ ] **ソースマップ2.0**
  - [ ] VLQ圧縮形式採用
  - [ ] 双方向マッピング
  - [ ] ノードID安定性保証
  - [ ] サイズ目標: P層の5%以下

### 検証インフラ
- [ ] **MIR等価性**
  - [ ] MIRハッシュ計算実装
  - [ ] P→MIR = F→P*→MIR証明
  - [ ] 差分ビルド検証

- [ ] **Property Testing**
  - [ ] ランダムAST生成器
  - [ ] エッジケース網羅
  - [ ] 10,000サンプル自動テスト

## 🎨 Gemini先生の実用要件

### 開発体験
- [ ] **IDE統合**
  - [ ] VS Code拡張（最優先）
  - [ ] F層ホバー→P層表示
  - [ ] リアルタイム変換
  - [ ] ブレークポイント対応

- [ ] **段階的導入**
  - [ ] fusion{}ブロック実装
  - [ ] ファイル単位の混在モード
  - [ ] プロジェクト移行ツール

- [ ] **ANCP辞書**
  - [ ] .ancprc形式設計
  - [ ] プロジェクト固有記号
  - [ ] 継承・オーバーライド

### 将来拡張
- [ ] **意味論的圧縮**
  - [ ] パターンマイニング
  - [ ] 頻出イディオム抽出
  - [ ] 高レベル抽象化記号

## 🚨 リスク対策（Codex警告）

### 曖昧性回避
- [ ] 文字列リテラル内エスケープ
- [ ] 正規表現パターン保護
- [ ] ネストラムダ明確化
- [ ] プラグイン構文登録API

### デバッグ保証
- [ ] エラー位置の逆引き
- [ ] スタックトレース変換
- [ ] ソースレベルデバッガ対応

### 互換性維持
- [ ] バージョニング戦略
- [ ] 後方互換性ポリシー
- [ ] マイグレーションツール

## 📋 実装優先順位

### Week 1: 基礎確立
1. P*仕様確定
2. 最小エンコーダー（Box専用）
3. ラウンドトリップテスト

### Week 2: 実用最小版
1. CLI実装（encode/decode/verify）
2. 基本的なソースマップ
3. エラー位置変換

### Week 3: 開発ツール
1. VS Code拡張α版
2. プロジェクト辞書
3. ベンチマーク自動化

### Week 4: 品質保証
1. Property Testingフル稼働
2. 実プロジェクトでの検証
3. パフォーマンス最適化

## 📊 計測指標

### 必須達成目標
| 項目 | 目標 | 測定方法 |
|------|------|----------|
| 圧縮率 | 90% | トークン数比較 |
| 可逆性 | 100% | AST同一性 |
| MIR等価 | 100% | ハッシュ一致 |
| 変換速度 | <100ms/1000行 | ベンチマーク |

### 品質指標
- デバッグ体験スコア（開発者調査）
- IDE統合満足度
- 学習曲線（新規ユーザー）

## 🎯 マイルストーン

### M1: PoC完成（1週間）
- Boxのみ対応
- 基本的な圧縮動作
- MIR等価性確認

### M2: α版リリース（2週間）
- 主要構文対応
- CLI完成
- 基本的なドキュメント

### M3: β版リリース（1ヶ月）
- VS Code拡張
- 完全な言語カバレッジ
- 実プロジェクト適用

### M4: 正式版（2ヶ月）
- 性能最適化完了
- ドキュメント完備
- エコシステム確立

---

**今すぐやること**: P*正規化ルールを30分で決める！