# .claude Directory

This directory contains Claude Code configuration for the <PROJECT_NAME> project.

---

## Contents

| File | Purpose |
|------|---------|
| `project-constants.md` | Pre-computed values for task tracker integration |
| `settings.local.json` | Local permissions and MCP server configuration |
| `agents/` | Project-specific agent definitions |
| `skills/` | Workflow skill definitions (slash commands) |

---

## Project Constants

The `project-constants.md` file contains pre-computed values that are injected into agents and skills:

- Task tracker configuration (project key, board ID, assignee)
- Repository paths
- Global exclusions for codebase exploration

**Update this file when:**
- Task tracker configuration changes
- Team members change
- Repository locations change

---

## Settings

The `settings.local.json` file configures:

### Permissions

Allowed bash commands and operations that Claude Code can perform without prompting.

### MCP Servers

Model Context Protocol servers that extend Claude Code's capabilities:

| Server | Purpose |
|--------|---------|
| jira | JIRA integration (if using JIRA) |
| github | GitHub integration |
| greptile | Code review automation |
| context7 | Documentation lookup |

### Additional Directories

Other directories Claude Code should have access to (e.g., related repositories).

---

## Agents

The `agents/` directory contains agent definitions. Each agent:

- Has a specific role (developer, architect, reviewer, etc.)
- Receives project constants automatically
- Follows project standards
- Reports completion status

See `agents/README.md` for the agent authoring guide.

---

## Skills

The `skills/` directory contains workflow skills (slash commands). Each skill:

- Defines a multi-step workflow
- Has tool health checks
- Includes context recovery instructions
- May orchestrate other agents

See `skills/README.md` for the skill authoring guide.

---

## Setup Steps

1. **Configure project constants:**
   ```bash
   # Edit project-constants.md with your values
   vim .claude/project-constants.md
   ```

2. **Configure permissions:**
   ```bash
   # Edit settings.local.json for your environment
   vim .claude/settings.local.json
   ```

3. **Select agents:**
   ```bash
   # Remove agents you don't need
   rm .claude/agents/bot-*.md  # If not building bot services
   ```

4. **Test configuration:**
   ```bash
   # Start Claude Code and test a skill
   claude
   /docs
   ```

---

## Customization

### Adding a New Agent

1. Copy an existing agent as template
2. Update frontmatter (name, description, model, color)
3. Update role definition and completion requirements
4. Test with `/dev-task`

### Adding a New Skill

1. Create new directory under `skills/`
2. Create `skill.md` with frontmatter and workflow
3. Include tool health checks
4. Include context recovery instructions
5. Test the skill

---

## Related Documentation

- [development-workflow.md](../development-workflow.md) - Workflow specification
- [CLAUDE.md](../CLAUDE.md) - Project guidance
- [workflow-quick-reference.md](../workflow-quick-reference.md) - Command reference
