47f4ca0e44
## Summary Documented the "init block vs fields-at-top" design discussion as a valuable example of AI-human collaboration in language design. ## Changes ### Paper G (AI Collaboration) - Added field-declaration-design.md documenting the entire discussion flow - Showcased how complex init block proposal evolved to simple "fields at top" rule - Demonstrates AI's tendency toward complexity vs human intuition for simplicity ### Paper H (AI Practical Patterns) - Added Pattern #17: "Gradual Refinement Pattern" (段階的洗練型) - Documents the process: Complex AI proposal → Detailed analysis → Human insight → Convergence - Field declaration design as a typical example ### Paper K (Explosive Incidents) - Added Incident #046: "init block vs fields-at-top incident" - Updated total count to 46 incidents - Shows how a single human comment redirected entire design approach ## Design Decision After analysis, decided that BoxIndex should remain a compiler-internal structure, not a core Box: - Core Boxes: User-instantiable runtime values (String, Integer, Array, Map) - Compiler internals: BoxIndex for name resolution (compile-time only) - Clear separation of concerns between language features and compiler tools ## Philosophy This discussion exemplifies key principles: - The best design needs no explanation - Constraints provide clarity, not limitation - "Everything is Box" doesn't mean "compiler internals are Boxes" - AI tends toward theoretical completeness; humans toward practical simplicity 🐱 Sometimes the simplest answer is right in front of us\!
Nyash User Guides 📚
Nyashプログラミング言語の利用者向けガイドとチュートリアルです。
🚀 はじめに
getting-started.md- Nyashを始めるためのクイックガイド
📖 サブディレクトリ
tutorials/
hello-world.md- 最初のNyashプログラムbasic-boxes.md- Box（クラス）の基礎delegation.md- デリゲーションの使い方p2p-apps.md- P2Pアプリケーション開発
examples/
- 実践的なサンプルコード集
- よくあるパターンの実装例
- ベストプラクティス
wasm-guide/
- WebAssemblyビルドガイド
- ブラウザープレイグラウンドの使い方
- Webアプリケーション開発
🎯 学習順序
getting-started.mdから始めるtutorials/のチュートリアルを順番にexamples/で実践的なコードを学ぶ- 特定用途（WASM等）は各ガイドへ