This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
This repository stores custom Claude Code configuration including agents, commands, and settings. It is intended as a personal configuration store, not a build-able project.
agents/- Custom agent definitions in Markdown format with YAML frontmatter- Only
nameanddescriptionare required;tools,model, andcolorare optional - Agent body contains the system prompt/instructions
- Only
---
name: agent-name
description: When to use this agent (include examples)
tools: Comma-separated list of allowed tools (omit to inherit all tools)
model: sonnet | opus | haiku | fable | inherit | a full model ID (defaults to inherit)
color: purple | blue | green | etc.
---
System prompt content here...Additional optional frontmatter fields are also supported (disallowedTools, permissionMode, skills, mcpServers, hooks, memory, background, effort, isolation, initialPrompt) — see the subagents documentation for the full list.
- Agent files use kebab-case naming:
my-custom-agent.md - Descriptions should include usage examples in the format shown in existing agents
- Keep agent prompts focused and specific to their review/task domain
- When creating or editing agent files, use YAML literal block scalar syntax (
|) for multilinedescriptionfields instead of escaped\ncharacters