143 lines
4.8 KiB
Markdown
143 lines
4.8 KiB
Markdown
|
# 📚 言語進化ロードマップ - ドキュメント索引
|
|||
|
|
|
|||
|
|
**作成日**: 2025-10-02
|
|||
|
|
**対象**: Phase 16-30（言語機能・標準ライブラリの進化）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🎯 **メインドキュメント**
|
|||
|
|
|
|||
|
|
### **[README.md](./README.md)** - 言語進化ロードマップ v2.0 🌟
|
|||
|
|
**Phase 16-30の完全な実装計画**
|
|||
|
|
|
|||
|
|
- **「コアは最小・糖衣は最強」** 方針に基づく設計
|
|||
|
|
- **9の柱 + 糖衣5つ** - 全機能デシュガリング
|
|||
|
|
- **実装タイムライン** - 優先順位付き
|
|||
|
|
- **デシュガリング規則一覧** - 全16種
|
|||
|
|
|
|||
|
|
**こんな人向け**:
|
|||
|
|
- Phase 16-30で何を実装するか知りたい
|
|||
|
|
- 言語機能の全体像を把握したい
|
|||
|
|
- 実装優先順位を確認したい
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📖 **設計原則**
|
|||
|
|
|
|||
|
|
### **[desugaring-contract.md](./desugaring-contract.md)** - デシュガリング契約 📜
|
|||
|
|
**Hakoruneの最も重要な設計原則**
|
|||
|
|
|
|||
|
|
- **5つの不変ルール（赤線）** - 絶対に守るべき原則
|
|||
|
|
- **デシュガリング実例集** - 型システム、並行処理、糖衣構文、マクロ
|
|||
|
|
- **全16種のデシュガリング規則表** - すべてMIR命令増加なし
|
|||
|
|
- **契約違反の例** - やってはいけないこと
|
|||
|
|
|
|||
|
|
**こんな人向け**:
|
|||
|
|
- 新機能を実装する開発者
|
|||
|
|
- MIR14凍結の理由を知りたい
|
|||
|
|
- デシュガリングの具体例を見たい
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔍 **問題分析**
|
|||
|
|
|
|||
|
|
### **[discoverability-analysis.md](./discoverability-analysis.md)** - 発見性問題分析 🔎
|
|||
|
|
**なぜChatGPTが冗長なコードを書いてしまったのか**
|
|||
|
|
|
|||
|
|
- **問題の発見** - if連鎖 vs match式
|
|||
|
|
- **5つの根本原因** - ドキュメント導線、サンプル不足、AI学習データ不足、Linter不足等
|
|||
|
|
- **5つの解決策** - Cookbook/Recipe集、Linter、Quick Reference拡充等
|
|||
|
|
- **Phase 17で即座に着手** - 発見性問題の根本解決
|
|||
|
|
|
|||
|
|
**こんな人向け**:
|
|||
|
|
- なぜ「つよつよ機能」が使われないのか知りたい
|
|||
|
|
- Cookbook/Linter実装の背景を知りたい
|
|||
|
|
- 言語機能の発見性向上に興味がある
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📚 **関連ドキュメント**
|
|||
|
|
|
|||
|
|
### **外部リンク**
|
|||
|
|
- [アーキテクチャ戦略](../architecture-strategy.md) - Rust vs セルフホスト実装戦略
|
|||
|
|
- [Phase 16 Macro Revolution](../phases/phase-16-macro-revolution/README.md) - マクロシステム詳細
|
|||
|
|
- [MIR Instruction Set](../../../reference/mir/INSTRUCTION_SET.md) - MIR14命令セット詳細
|
|||
|
|
|
|||
|
|
### **歴史的資料**
|
|||
|
|
- [v1-original.md](./v1-original.md) - Claude初版（参考資料）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🗺️ **ドキュメント構造**
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
docs/private/roadmap/language-evolution/
|
|||
|
|
├── INDEX.md # このファイル（索引）
|
|||
|
|
├── README.md # メインドキュメント（v2.0）⭐
|
|||
|
|
├── desugaring-contract.md # デシュガリング契約（設計原則）
|
|||
|
|
├── discoverability-analysis.md # 発見性問題分析
|
|||
|
|
└── v1-original.md # Claude初版（参考資料）
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🎯 **読む順番（推奨）**
|
|||
|
|
|
|||
|
|
### **初めての人**
|
|||
|
|
1. **README.md** - 全体像を把握
|
|||
|
|
2. **desugaring-contract.md** - 設計原則を理解
|
|||
|
|
3. **discoverability-analysis.md** - 発見性問題を知る
|
|||
|
|
|
|||
|
|
### **新機能を実装する開発者**
|
|||
|
|
1. **desugaring-contract.md** - 設計原則を確認
|
|||
|
|
2. **README.md** - 実装計画を確認
|
|||
|
|
3. **Phase 16-30のタイムライン** - 優先順位を確認
|
|||
|
|
|
|||
|
|
### **Cookbook/Linter実装者**
|
|||
|
|
1. **discoverability-analysis.md** - 問題の本質を理解
|
|||
|
|
2. **README.md（Phase 17）** - Cookbook/Linter計画を確認
|
|||
|
|
3. **desugaring-contract.md** - デシュガリング規則を確認
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 💡 **重要な原則**
|
|||
|
|
|
|||
|
|
### **De-sugaring Contract（デシュガリング契約）**
|
|||
|
|
> **新構文は既存構文・既存Boxへ有限段で必ず落ちること。IR命令の追加は最後の手段。**
|
|||
|
|
|
|||
|
|
### **「コアは最小・糖衣は最強」**
|
|||
|
|
```
|
|||
|
|
MIR14命令セット（凍結）
|
|||
|
|
↓
|
|||
|
|
すべての新機能をデシュガリング
|
|||
|
|
↓
|
|||
|
|
Box/マクロ/標準ライブラリで実現
|
|||
|
|
↓
|
|||
|
|
VM/LLVM/WASM すべて恩恵！
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### **Everything is Box の真髄**
|
|||
|
|
- **型システム**: OptionBox, SumBox
|
|||
|
|
- **並行処理**: TaskGroupBox, SelectBox, ChannelBox
|
|||
|
|
- **テスト**: TestRunnerBox, BenchmarkBox
|
|||
|
|
- **プロファイル**: ProfileBox
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🎊 **まとめ**
|
|||
|
|
|
|||
|
|
このフォルダには、**Hakorune言語進化の完全な設計図**が含まれています。
|
|||
|
|
|
|||
|
|
**3つのドキュメント**で、Phase 16-30の全体像を把握できます：
|
|||
|
|
1. **README.md** - 実装計画（9の柱 + 糖衣5つ）
|
|||
|
|
2. **desugaring-contract.md** - 設計原則（5つの不変ルール）
|
|||
|
|
3. **discoverability-analysis.md** - 発見性問題と解決策
|
|||
|
|
|
|||
|
|
**これで、Hakoruneは次世代言語の標準を打ち立てる準備が整っています！** 🚀
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**作成者**: Claude Sonnet 4.5
|
|||
|
|
**作成日**: 2025-10-02
|
|||
|
|
**関連**: [言語進化ロードマップ v2.0](./README.md)
|