Skip to content

shingo257/claude-code-best-practice

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

78 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

claude-code-best-practice

練習で Claude は上達する(practice makes claude perfect)

GitHub Stars

Claude Code マスコット

Claude Code クリエイター Claude Code クリエイター

コンセプト

注意: カスタムスラッシュコマンドはスキルに統合されました。.claude/commands/ 内のファイルも動作しますが、サポートファイル・呼び出し制御・サブエージェント実行に対応するスキル(.claude/skills/)の利用を推奨します。

拡張機能概要: 各機能の使い分けと重ね方は Extend Claude Code を参照してください。

私の経験

ワークフロー

  • CLAUDE.md は 150 行以内に抑える(100% 保証はない)
  • ワークフローにはエージェントよりコマンドを使う
  • 汎用 QA・バックエンドエンジニアではなく、スキル(段階的開示)付きの機能特化サブエージェントを使う
  • /memory、/rules、constitution.md は何も保証しない
  • 手動で /compact はコンテキスト 50% 前後で
  • 必ずプランモードから始める
  • サブタスクはコンテキスト 50% 未満で完了できる小ささにする
  • 小さなタスクならバニラ cc の方がどのワークフローより良い
  • タスク完了したらすぐコミットする

ユーティリティ

  • IDE より iTerm ターミナル(クラッシュ対策)
  • Wispr Flow で音声プロンプト(生産性 10 倍)
  • claude-code-voice-hooks で Claude のフィードバック
  • コンテキスト把握と高速コンパクト用のステータスライン
  • 並行開発には git worktrees
  • /config では dangerously—skip--permissions ではなく「許可を聞かないモード」を使う

デバッグ

  • /doctor
  • ログを見たいターミナルは Claude にバックグラウンドで動かしてもらう
  • MCP(Claude in Chrome、Playwright、Chrome DevTools)で Claude にコンソールログを見させる
  • 問題報告時はスクリーンショットを添える

コンテキストエンジニアリング

ワークフロー

キーワード

Claude:

btw(バックグラウンドタスク) "defaultMode": "bypassPermissions" ultrathink(非推奨)

コミュニティ用語:

Agentic Workflow AI Slop Closing the loop Context Bloat Context Engineering
Context Rot Dumb Zone Hallucination Harness One Shot
Orchestration Progressive Disclosure Rate Limit Jail Scaffolding Slot Machine Method(save→run→revert→retry)
Stop The Holy Trinity(Skills+Agents+Hooks) Token Burn Vibe Coding

CLAUDE CODE 機能のインスピレーション

コマンド + スキル + サブエージェント アーキテクチャ

コマンド・スキル・エージェントの流れ

要素 役割
Command 入口・ユーザー操作 /weather-orchestrator
Agent 事前読み込みしたスキルでワークフローを実行 weather エージェント
Skills 起動時に注入されるドメイン知識 weather-fetcher, weather-transformer

向いている用途: 複数ステップのワークフロー・ドメイン特化知識の注入・順次タスク・再利用可能なコンポーネント

うまくいく理由: 段階的開示・単一実行コンテキスト・責務の分離・再利用性

実装の詳細は weather-orchestration-architecture を参照。

設定

利用可能な settings.json の全オプションは reports/claude-settings.md を参照してください。

レポート

レポート 説明
Agent SDK vs CLI システムプロンプト Claude CLI と Agent SDK の出力差の理由(システムプロンプト構成と決定性)
ブラウザ自動化 MCP 比較 Playwright・Chrome DevTools・Claude in Chrome の自動テスト比較
Claude Code 設定リファレンス settings.json 設定オプションの一覧
モノレポでの CLAUDE.md 読み込み CLAUDE.md の祖先 vs 子孫の読み込み挙動
モノレポでのスキル発見 大規模モノレポでのスキルの発見・読み込み方法

About

practice made claude perfect

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Languages

  • Python 94.2%
  • Shell 5.8%