feat: add debugging infrastructure and CLAUDE.md optimization #101

Merged
lmiranda merged 1 commits from feat/debugging-infrastructure into development 2026-01-22 18:36:15 +00:00
Owner

Summary

  • Add docs/DEBUGGING-CHECKLIST.md with systematic 7-step troubleshooting guide
  • Enhance SessionStart hooks to detect missing MCP venvs and warn users
  • Optimize CLAUDE.md with Installation Paths and Debugging sections
  • Add Plugin Commands by Category table to Quick Start
  • Condense Versioning section for better readability
  • Add scripts/check-venv.sh for programmatic venv checking

Files Changed (7)

File Changes
CLAUDE.md Optimized with new sections, commands table
docs/DEBUGGING-CHECKLIST.md NEW - 213 lines
docs/CANONICAL-PATHS.md Added new file references
plugins/projman/hooks/hooks.json Added venv check to SessionStart
plugins/pr-review/hooks/hooks.json Added venv check to SessionStart
plugins/projman/README.md Updated hook documentation
scripts/check-venv.sh NEW - venv checking script
  • Addresses #97 - Create debugging checklist
  • Addresses #98 - Automate venv creation (via warning hook)
  • Addresses #99 - Debug commands (already existed, documented)

Test Plan

  • Verify CLAUDE.md renders correctly
  • Verify DEBUGGING-CHECKLIST.md is accessible
  • Test SessionStart hook warns when venvs missing
  • Verify check-venv.sh script works

🤖 Generated with Claude Code

## Summary - Add `docs/DEBUGGING-CHECKLIST.md` with systematic 7-step troubleshooting guide - Enhance SessionStart hooks to detect missing MCP venvs and warn users - Optimize CLAUDE.md with Installation Paths and Debugging sections - Add Plugin Commands by Category table to Quick Start - Condense Versioning section for better readability - Add `scripts/check-venv.sh` for programmatic venv checking ## Files Changed (7) | File | Changes | |------|--------| | `CLAUDE.md` | Optimized with new sections, commands table | | `docs/DEBUGGING-CHECKLIST.md` | **NEW** - 213 lines | | `docs/CANONICAL-PATHS.md` | Added new file references | | `plugins/projman/hooks/hooks.json` | Added venv check to SessionStart | | `plugins/pr-review/hooks/hooks.json` | Added venv check to SessionStart | | `plugins/projman/README.md` | Updated hook documentation | | `scripts/check-venv.sh` | **NEW** - venv checking script | ## Related Issues - Addresses #97 - Create debugging checklist - Addresses #98 - Automate venv creation (via warning hook) - Addresses #99 - Debug commands (already existed, documented) ## Test Plan - [ ] Verify CLAUDE.md renders correctly - [ ] Verify DEBUGGING-CHECKLIST.md is accessible - [ ] Test SessionStart hook warns when venvs missing - [ ] Verify check-venv.sh script works --- 🤖 Generated with [Claude Code](https://claude.ai/code)
lmiranda added 1 commit 2026-01-22 18:35:27 +00:00
- Add docs/DEBUGGING-CHECKLIST.md with systematic troubleshooting guide
- Enhance SessionStart hooks to detect missing MCP venvs and warn users
- Add Installation Paths and Debugging sections to CLAUDE.md
- Add Plugin Commands by Category table to Quick Start
- Condense Versioning section for better readability
- Add scripts/check-venv.sh for programmatic venv checking
- Update docs/CANONICAL-PATHS.md with new files

Addresses issues #97, #98, #99

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
lmiranda merged commit ad0e14d07f into development 2026-01-22 18:36:15 +00:00
lmiranda deleted branch feat/debugging-infrastructure 2026-01-22 18:36:15 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: personal-projects/leo-claude-mktplace#101