# Troubleshooting Guides

このディレクトリには、Nyash/Hakorune を使うときに遭遇しがちなトラブルと、その対処方法をまとめたガイドを置いているよ。

## 現在のガイド

- `stage3-local-keyword-guide.md`  
  - Stage‑3 キーワード（特に `local`）を使用するときに必要な環境変数と、エラー発生時の診断方法。
- `using-resolution.md`  
  - `using` 解決まわりのエラー（モジュール未解決、arity mismatch など）の原因と対処法。

## 置き場所のルール（提案）

- 開発者やユーザーが「実際にハマった時にすぐ読みたい」内容は、`docs/development/` ではなくここ（`guides/troubleshooting/`）に置く。
- フェーズ固有の一時メモは `docs/development/issues/` に置き、広く役立つノウハウになったらこちらに昇格させる、という二段構えにする。