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: 新しいセッションを開始するか、混乱している場合はエージェントに「previous instructions を忘れて」と依頼してください。
2. Explicit Instructions: パス、ファイル名、期待される結果について非常に具体的に指示してください。
3. Logs: エージェントに「ログを確認して」または「詳細出力でコマンドを実行して」と依頼してください。

Best Practices

1. Small Contexts: コードベース全体をコンテキストに入れないでください。grep または find を使用して最初に関連ファイルを見つけてください。
2. Iterative Development: 小さな変更を依頼し、確認してから進めてください。
3. Feedback Loop: エージェントが間違いを犯した場合、すぐに修正し、メモリにレッスンを「追加」するよう依頼してください (サポートされている場合) またはそれを CLAUDE.md に追加してください。

Reference

Claude Code Guide by zebbern に基づいています。

When to Use

このスキルは、概要で説明されているワークフローやアクションを実行する場合に適用されます。

Limitations

• このスキルは、タスクが上記で説明されたスコープと明確に一致する場合にのみ使用してください。
• 出力を環境固有の検証、テスト、またはエキスパートレビューの代替として扱わないでください。
• 必要な入力、権限、安全境界、または成功基準が不足している場合は、停止して明確化を求めてください。