Update AGENTS.md with comprehensive DEBUG environment variable documentation

[Copilot]

Overview

Enhanced the DEBUG logging documentation in AGENTS.md to provide comprehensive guidance on using the DEBUG environment variable for troubleshooting and development.

Changes

The "Debug Output Control" section now includes:

Additional Pattern Examples

1. Exact namespace matching - Target a specific logger without wildcards:

   DEBUG=cli:compile_command gh aw compile

2. Suffix wildcard matching - Match all loggers ending with a specific suffix:

   DEBUG=*:compiler gh aw compile

3. Middle wildcard matching - Match loggers with both prefix and suffix:

   DEBUG=cli:*:command gh aw compile

4. Namespace exclusion - Exclude an entire namespace:

   DEBUG=*,-cli:* gh aw compile

New Pattern Matching Rules Section

Added a dedicated section documenting all supported pattern types:

• Wildcard matching (*)
• Prefix wildcards (namespace:*)
• Suffix wildcards (*:suffix)
• Middle wildcards (prefix:*:suffix)
• Exact namespace matching
• Exclusion patterns (-pattern)
• Pattern combination with commas

Clarifications

• Updated comments to be more descriptive (e.g., "Enable specific package (prefix wildcard)")
• Added note that spaces in comma-separated patterns require shell quoting
• Clarified that colors are auto-disabled when piping to files/commands

Testing

All documented patterns were tested and verified to work correctly:

• ✅ Prefix wildcard: DEBUG=cli:*
• ✅ Exclusion: DEBUG=*,-cli:*
• ✅ Multiple patterns with spaces: DEBUG="cli:* , workflow:*"
• ✅ Exact matching: DEBUG=cli:compile_command
• ✅ All unit and integration tests pass

The documentation is now comprehensive and aligned with the actual implementation in pkg/logger/logger.go.

Original prompt

Update AGENTS.md on how to set the DEBUG variable value to get additional logging.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.