hakorune/docs/development/roadmap/phases/phase-11.9/README.md

Phase 11.9: 文法統一化とAI連携強化

📋 概要

Nyashの文法知識が分散している問題を解決し、AIがNyashコードを正しく書けるよう支援する包括的な文法統一化フェーズ。

🔥 核心的な問題

現在のNyashは各層（Tokenizer/Parser/Interpreter/MIR/VM/JIT）で予約語・文法解釈がバラバラに実装されており、これが以下の問題を引き起こしている：

• 同じ me キーワードが各層で独自解釈される
• + 演算子の動作がInterpreter/VM/JITで微妙に異なる
• 新しい予約語追加時に6箇所以上の修正が必要
• AIが正しいコードを書けない（どの層の解釈に従うべきか不明）

🎯 フェーズの目的

1. 完全統一文法エンジン: すべての層が単一の文法定義を参照
2. セマンティクス一元化: 演算子・型変換・実行規則の完全統一
3. AIエラー削減: 文法間違いを90%以上削減
4. 保守性革命: 新機能追加が1箇所の修正で完了

📊 主要成果物

文法定義

• nyash-grammar-v1.yaml（統一文法定義）
• Grammar Runtime実装
• 文法検証ツール

コンポーネント統合

• Tokenizer文法統合
• Parser文法統合
• Interpreter統合
• MIR Builder連携

AI支援機能

• AI向け文法エクスポート
• AIコード検証器
• トレーニングデータ生成
• 文法aware ANCP

🔧 技術的アプローチ

アーキテクチャ

Grammar Definition (YAML)
    ↓
Grammar Runtime (Rust)
    ↓
Components (Tokenizer/Parser/Interpreter)

核心的な改善

# 文法定義の例
keywords:
  me:
    token: ME
    deprecated_aliases: ["this", "self"]
    ai_hint: "Always use 'me', never 'this'"

📅 実施時期

• 開始条件: Phase 11.8完了後
• 推定期間: 4-5週間
• 優先度: 高（AIとの協働開発に必須）

💡 期待される成果

1. 単一の真実の源: 文法がYAMLファイル1つに集約
2. AIフレンドリー: 明確な文法でAIの学習効率向上
3. 保守性向上: 新機能追加が簡単に
4. 品質向上: 統一的な検証で一貫性確保

🔗 関連ドキュメント

• 統一文法アーキテクチャ設計書 ← 🔥 核心設計
• 統一予約語システム仕様 ← 🎯 具体的実装
• AI深層考察: 統一文法アーキテクチャ ← 💡 Gemini/Codex分析
• 文法統一化詳細設計
• 統一文法定義YAML
• 実装計画
• AI-Nyash Compact Notation Protocol
• Phase 12: プラグインシステム

🌟 なぜ重要か？

「文法の揺らぎをゼロにし、AIが正しいNyashコードを書ける世界へ」

現在、AIがNyashコードを書く際の最大の障害は文法の不統一。 これを解決することで、開発効率が劇的に向上する。