CLAUDE.md@CLAUDE/development git:20260127.402f445A

Immutable. This exact content is served forever at /api/v1/blob/ef56f415848de598.

# CLAUDE/development/ - Development Process Documentation

## Purpose

This directory contains documentation for **developers working on the hooks daemon repository itself**, NOT for users implementing hooks in their projects.

## Distinction

- **User Documentation**: `/CLAUDE/` root level (ARCHITECTURE.md, HANDLER_DEVELOPMENT.md, LLM-INSTALL.md)
  - How to use the daemon
  - How to create handlers
  - How to install and configure

- **Development Documentation**: `/CLAUDE/development/` (this directory)
  - How to contribute to the daemon codebase
  - Release management process
  - Testing and QA workflows
  - Code review guidelines

## Files in This Directory

- **RELEASING.md** - Complete release process using `/release` skill
- **TESTING.md** - Testing standards, QA automation, coverage requirements
- **CONTRIBUTING_GUIDE.md** - Code review, PR process, branch strategy
- **DEBUGGING.md** - Debugging the daemon itself (not user hooks)

## When to Use This Directory

Add documentation here when:
- Documenting internal development workflows
- Explaining how to modify the daemon core
- Describing release/deployment processes
- Internal architecture decisions that affect contributors

## When NOT to Use This Directory

Don't put documentation here for:
- User-facing features or APIs → `/CLAUDE/` root
- Handler development → `/CLAUDE/HANDLER_DEVELOPMENT.md`
- Installation guides → `/CLAUDE/LLM-INSTALL.md`
- Bug reporting → `/BUG_REPORTING.md`

## Navigation

- Parent: `/CLAUDE/` - User-facing LLM documentation
- Sibling: `/CLAUDE/UPGRADES/` - Version migration guides
- Related: `/CONTRIBUTING.md` - High-level contribution guidelines