ha-mcp AGENTS.md

CLAUDE.md

Guidance for Claude Code when working with this repository.

Repository Structure

This repository uses a worktree-based development workflow.

Documentation Setup:

• This file is AGENTS.md (the canonical source)
• CLAUDE.md is a symlink pointing to AGENTS.md
• Read either file - they're the same content
• Commit changes to AGENTS.md, the symlink will automatically reflect them

Directory Structure:

<repo-root>/                           # Main repository (checkout master here)
├── AGENTS.md                          # This file (canonical source)
├── CLAUDE.md -> AGENTS.md             # Symlink for convenience
├── worktree/                          # Git worktrees (gitignored)
│   ├── issue-42/                      # Feature branch worktree
│   └── fix-something/                 # Fix branch worktree
├── local/                             # Scratch work (gitignored)
└── .claude/skills/                    # Slash-command skills

Quick command: Use /wt <branch-name> skill to create worktree automatically.

Worktree Workflow

Creating Worktrees

ALWAYS create worktrees in the worktree/ subdirectory, not at the repository root.

git worktree add worktree/issue-42 -b issue-42
git worktree add worktree/feat-new-feature -b feat/new-feature

Cleanup: git worktree remove worktree/<name> or git worktree prune for stale references.

Skills

All workflow automation is implemented as skills in .claude/skills/ and invoked with /skill-name <args>:

Skill	Command	Purpose
issue-analysis	/issue-analysis <number>	Deep issue analysis — codebase exploration, implementation planning, architectural assessment. Posts structured comment and applies labels.
issue-to-pr-resolver	/issue-to-pr-resolver <number>	End-to-end issue implementation: worktree creation → implementation with tests → draft PR → iterative CI/review resolution until merge-ready.
my-pr-checker	/my-pr-checker <number>	Review and manage YOUR OWN PRs — check CI, resolve review threads, fix issues, iterate until all checks pass.
contrib-pr-review	/contrib-pr-review <number>	Review external contributor PRs for safety, quality, and readiness.
wt	/wt <branch-name>	Create git worktree in worktree/ subdirectory with up-to-date master.
bat-adhoc	/bat-adhoc [scenario]	Ad-hoc bot acceptance testing with dynamically generated scenarios.
bat-story-eval	/bat-story-eval --baseline v6.6.1	Diff-based story evaluation: two-version comparison, regression detection.