141 lines
3.5 KiB
Markdown
141 lines
3.5 KiB
Markdown
|
# 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分で決める！
|