Files

Moe Charm fff9749f47 📚 Reorganize CLAUDE.md: slim down from 916 to 395 lines with proper doc links

- Keep essential information within 500 lines (now 395 lines)
- Maintain important syntax examples and development principles
- Move detailed information to appropriate docs files:
  - Development practices → docs/guides/development-practices.md
  - Testing guide → docs/guides/testing-guide.md
  - Claude issues → docs/tools/claude-issues.md
- Add proper links to all referenced documentation
- Balance between minimal entry point and practical usability

2025-08-31 06:22:48 +09:00

2.8 KiB

Raw Permalink Blame History

Claude実行環境の既知のバグ

🐛 Bash Glob展開バグ（Issue #5811）

問題： Claude Code v1.0.61-1.0.81でglob展開がパイプと一緒に使うと動作しない

# ❌ 失敗するパターン（asteriskが"glob"という文字列に置換される）
ls *.md | wc -l          # エラー: "ls: 'glob' にアクセスできません"
find . -name "*.rs"      # エラー: "glob"になる
ls src/backend/vm_*.rs   # エラー: "glob: そのようなファイルやディレクトリはありません"

# ✅ 回避策1: bash -c でラップ（最も簡単）
bash -c 'ls *.md | wc -l'
bash -c 'ls src/backend/vm_*.rs | xargs wc -l'
# → Claudeではなくbash自身がglob展開するので動作する

# ✅ 回避策2: findコマンドを使う（最も確実）
find src/backend -name "vm_*.rs" -exec wc -l {} \;

# ✅ 回避策3: 明示的にファイル名を列挙
wc -l src/backend/vm.rs src/backend/vm_values.rs

# ✅ 回避策4: ls + grepパターン  
ls src/backend/ | grep "^vm_" | xargs -I{} wc -l src/backend/{}

影響を受けるパターン：

*.md, *.rs - 通常のglob
src/*.py - パス付きglob
file[12].md - 文字クラス
file{1,2}.md - ブレース展開

根本原因： Claudeのコマンド再構築機能のバグ（patternではなくopフィールドを使用）

🚨 コンテキスト圧縮時の重要ルール

⚠️ コンテキスト圧縮を検出した場合の必須手順

コンテキスト圧縮 = 会話履歴が要約される現象（conversation summaryで検出可能）

🛑 絶対にやってはいけないこと

推測で作業を続行しない
不完全な情報で重要な変更をしない
ビルドチェックを飛ばさない
ユーザー確認なしに進行しない

✅ 必ず実行すべき手順

⏸️ 作業停止 - 「コンテキスト圧縮を検出しました」と報告

📊 状況確認 - 以下を必ずチェック：

git status                    # 現在の変更状況
git log --oneline -3         # 最近のcommit履歴
cargo check                  # ビルド状況

📋 現在タスク確認 - CURRENT_TASK.md を読み取り
🤝 明示的確認 - ユーザーに「次に何をしましょうか？」と確認

📍 現在状況の記録場所

進行中タスク: CURRENT_TASK.md
最後の安定状態: git commit hash
ビルド状況: cargo check の結果
重要な制約: CURRENT_TASK.md内の注意事項

💡 圧縮時によくある混乱の回避

「何をしていたか」→ CURRENT_TASK.mdで確認
「ビルドできるか」→ cargo checkで確認
「どこまで進んだか」→ git logで確認
「次は何か」→ ユーザーに明示的に確認

2.8 KiB Raw Permalink Blame History Unescape Escape