3.5 KiB
3.5 KiB
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: 基礎確立
- P*仕様確定
- 最小エンコーダー（Box専用）
- ラウンドトリップテスト
Week 2: 実用最小版
- CLI実装（encode/decode/verify）
- 基本的なソースマップ
- エラー位置変換
Week 3: 開発ツール
- VS Code拡張α版
- プロジェクト辞書
- ベンチマーク自動化
Week 4: 品質保証
- Property Testingフル稼働
- 実プロジェクトでの検証
- パフォーマンス最適化
📊 計測指標
必須達成目標
| 項目 | 目標 | 測定方法 |
|---|---|---|
| 圧縮率 | 90% | トークン数比較 |
| 可逆性 | 100% | AST同一性 |
| MIR等価 | 100% | ハッシュ一致 |
| 変換速度 | <100ms/1000行 | ベンチマーク |
品質指標
- デバッグ体験スコア（開発者調査）
- IDE統合満足度
- 学習曲線（新規ユーザー）
🎯 マイルストーン
M1: PoC完成（1週間）
- Boxのみ対応
- 基本的な圧縮動作
- MIR等価性確認
M2: α版リリース（2週間）
- 主要構文対応
- CLI完成
- 基本的なドキュメント
M3: β版リリース（1ヶ月）
- VS Code拡張
- 完全な言語カバレッジ
- 実プロジェクト適用
M4: 正式版（2ヶ月）
- 性能最適化完了
- ドキュメント完備
- エコシステム確立
今すぐやること: P*正規化ルールを30分で決める！