Claude Code Guide

Purpose

Claude Code(エージェント型コーディングツール)を最大限に活用するための包括的なリファレンスを提供することが目的です。このスキルはベストプラクティス、設定テンプレート、および高度な使用パターンをまとめたものです。

Configuration (CLAUDE.md)

新しいプロジェクトを開始する場合は、ルートディレクトリに CLAUDE.md ファイルを作成してエージェントをガイドします。

Template (General)

# Project Guidelines

## Commands

- Run app: `npm run dev`
- Test: `npm test`
- Build: `npm run build`

## Code Style

- Use TypeScript for all new code.
- Functional components with Hooks for React.
- Tailwind CSS for styling.
- Early returns for error handling.

## Workflow

- Read `README.md` first to understand project context.
- Before editing, read the file content.
- After editing, run tests to verify.

Advanced Features

Thinking Keywords

エージェントからより深い推論を引き出すために、プロンプトで以下のキーワードを使用してください:

• "Think step-by-step"(段階的に考える)
• "Analyze the root cause"(根本原因を分析する)
• "Plan before executing"(実行前に計画する)
• "Verify your assumptions"(仮定を検証する)

Debugging

エージェントが行き詰まったり、予期しない動作をしている場合:

1. Clear Context: 新しいセッションを開始するか、混乱している場合はエージェントに"forget previous instructions"(以前の指示を忘れる)と要求します。
2. Explicit Instructions: パス、ファイル名、望ましい結果について極めて具体的に指示します。
3. Logs: エージェントに"check the logs"(ログを確認する)または"run the command with verbose output"(詳細出力でコマンドを実行する)と要求します。

Best Practices

1. Small Contexts: コードベース全体をコンテキストに入れないでください。grep や find を使用して、まず関連するファイルを検索してください。
2. Iterative Development: 小さな変更を依頼し、検証してから先に進みます。
3. Feedback Loop: エージェントが間違いを犯した場合は、すぐに修正し、メモリに"lesson を追加"(サポートされている場合)するか CLAUDE.md に記録するよう依頼してください。

Reference

Based on Claude Code Guide by zebbern.