CLAUDE.md

1# CLAUDE.md
2 
3This file provides guidance to GitHub Copilot CLI when working with code in this repository.
4 
5## Project Overview
6 
7This is a **Copilot CLI plugin** - a collection of production-ready agents, skills, hooks, commands, rules, and MCP configurations. The project provides battle-tested workflows for software development using Copilot CLI.
8 
9## Running Tests
10 
11```bash
12# Run all tests
13node tests/run-all.js
14 
15# Run individual test files
16node tests/lib/utils.test.js
17node tests/lib/package-manager.test.js
18node tests/hooks/hooks.test.js
19```
20 
21## Architecture
22 
23The project is organized into several core components:
24 
25- **agents/** - Specialized subagents for delegation (planner, code-reviewer, tdd-guide, etc.)
26- **skills/** - Workflow definitions and domain knowledge (coding standards, patterns, testing)
27- **commands/** - Slash commands invoked by users (/tdd, /plan, /e2e, etc.)
28- **hooks/** - Trigger-based automations (session persistence, pre/post-tool hooks)
29- **rules/** - Always-follow guidelines (security, coding style, testing requirements)
30- **mcp-configs/** - MCP server configurations for external integrations
31- **scripts/** - Cross-platform Node.js utilities for hooks and setup
32- **tests/** - Test suite for scripts and utilities
33 
34## Key Commands
35 
36- `/tdd` - Test-driven development workflow
37- `/plan` - Implementation planning
38- `/e2e` - Generate and run E2E tests
39- `/code-review` - Quality review
40- `/build-fix` - Fix build errors
41- `/learn` - Extract patterns from sessions
42- `/skill-create` - Generate skills from git history
43 
44## Development Notes
45 
46- Package manager detection: npm, pnpm, yarn, bun (configurable via `PACKAGE_MANAGER` env var or project config)
47- Cross-platform: Windows, macOS, Linux support via Node.js scripts
48- Agent format: `.agent.md` with YAML frontmatter (name, description, tools) — no `model:` field
49- Skill format: Markdown with clear sections for when to use, how it works, examples
50- Hook format: `hooks.json` with `version: 1`, camelCase events, bash/powershell split
51 
52## Contributing
53 
54Follow the formats in CONTRIBUTING.md:
55- Agents: `.agent.md` with frontmatter (name, description, tools) — no `model:` field
56- Skills: Clear sections (When to Use, How It Works, Examples)
57- Commands: Markdown with description frontmatter
58- Hooks: `hooks/hooks.json` with `version: 1`, camelCase events
59 
60File naming: agents use `agent-name.agent.md`; skills/commands use lowercase with hyphens
61