Summary

This PR adds comprehensive documentation for Claude developers working with the Claude Code repository. The new CLAUDE.md file serves as a guide for understanding the repository structure, automation systems, and plugin architecture.

Key Changes

• Repository overview — Explains the dual purpose of the repository (issue tracking and plugins)
• Scripts documentation — Details TypeScript/Bun scripts for issue lifecycle automation, including usage examples and security-hardened CLI wrappers
• Issue lifecycle system — Documents the two-layer automation system with lifecycle labels, timeouts, and the sweep mechanism
• GitHub Actions workflows — Reference table of all active workflows, their triggers, and purposes
• Claude commands — Lists automated commands used in workflows (triage, dedupe, oncall, etc.)
• Plugin structure — Defines the standard plugin layout and key rules for plugin development

Notable Details

• Includes practical command examples for running scripts locally with proper environment variables
• Documents the safety net in the sweep mechanism that prevents closing issues with recent non-bot comments
• Specifies the upvote threshold (10+) that exempts issues from stale/autoclose enforcement
• Clarifies the distinction between component directories (at plugin root) vs. the manifest location (inside .claude-plugin/)

https://claude.ai/code/session_013gPtnTGqMX4oouicQt4DrE