From 8ed0d8f20755c337ccb98e01080fb38a7e61cab7 Mon Sep 17 00:00:00 2001 From: lmiranda Date: Thu, 22 Jan 2026 08:10:33 -0500 Subject: [PATCH] docs: add debug commands to projman documentation - Add /debug-report and /debug-review to projman README - Add debug commands to COMMANDS-CHEATSHEET.md - Remove obsolete doc-guardian Stop hook references from cheatsheet - Update Architecture section with debug command files Co-Authored-By: Claude Opus 4.5 --- docs/COMMANDS-CHEATSHEET.md | 6 +++--- plugins/projman/README.md | 39 ++++++++++++++++++++++++++++++++++++- 2 files changed, 41 insertions(+), 4 deletions(-) diff --git a/docs/COMMANDS-CHEATSHEET.md b/docs/COMMANDS-CHEATSHEET.md index 44a1d54..e1baa9b 100644 --- a/docs/COMMANDS-CHEATSHEET.md +++ b/docs/COMMANDS-CHEATSHEET.md @@ -20,6 +20,8 @@ Quick reference for all commands in the Leo Claude Marketplace. | **projman** | `/project-sync` | | X | Sync config with git remote after repo move/rename | | **projman** | *SessionStart hook* | X | | Detects git remote vs .env mismatch, warns to run /project-sync | | **projman** | `/test-gen` | | X | Generate comprehensive tests for specified code | +| **projman** | `/debug-report` | | X | Run diagnostics and create structured issue in marketplace | +| **projman** | `/debug-review` | | X | Investigate diagnostic issues and propose fixes with approval gates | | **git-flow** | `/commit` | | X | Create commit with auto-generated conventional message | | **git-flow** | `/commit-push` | | X | Commit and push to remote in one operation | | **git-flow** | `/commit-merge` | | X | Commit current changes, then merge into target branch | @@ -40,7 +42,6 @@ Quick reference for all commands in the Leo Claude Marketplace. | **doc-guardian** | `/doc-audit` | | X | Full documentation audit - scans for doc drift | | **doc-guardian** | `/doc-sync` | | X | Synchronize pending documentation updates | | **doc-guardian** | *PostToolUse hook* | X | | Silently detects doc drift on Write/Edit | -| **doc-guardian** | *Stop hook* | X | | Offers to sync docs at session end | | **code-sentinel** | `/security-scan` | | X | Full security audit (SQL injection, XSS, secrets, etc.) | | **code-sentinel** | `/refactor` | | X | Apply refactoring patterns to improve code | | **code-sentinel** | `/refactor-dry` | | X | Preview refactoring without applying changes | @@ -78,7 +79,6 @@ Quick reference for all commands in the Leo Claude Marketplace. | **projman** | SessionStart | Checks git remote vs .env; warns if mismatch detected | | **pr-review** | SessionStart | Checks git remote vs .env; warns if mismatch detected | | **doc-guardian** | PostToolUse (Write/Edit) | Silently tracks documentation drift | -| **doc-guardian** | Stop | Prompts to sync if drift detected | | **code-sentinel** | PreToolUse (Write/Edit) | Scans for security issues; blocks critical vulnerabilities | | **project-hygiene** | PostToolUse (Write/Edit) | Cleans temp files, warns about misplaced files | @@ -214,4 +214,4 @@ Ensure credentials are configured in `~/.config/claude/gitea.env` or `~/.config/ --- -*Last Updated: 2026-01-21* +*Last Updated: 2026-01-22* diff --git a/plugins/projman/README.md b/plugins/projman/README.md index 8ff524f..e9d63e0 100644 --- a/plugins/projman/README.md +++ b/plugins/projman/README.md @@ -232,6 +232,39 @@ Generate tests for specified code. **When to use:** When adding new code that needs test coverage +## Debug Workflow Commands + +These commands enable a cross-repository debugging workflow between your project and the marketplace. + +### `/debug-report` +Run diagnostics and create structured issue in marketplace repository. + +**What it does:** +- Runs MCP tool diagnostics (validate_repo_org, get_labels, list_issues, etc.) +- Captures error messages and hypothesis +- Creates a structured issue in the marketplace repository +- Tags with `Source: Diagnostic` label + +**When to use:** When MCP tools fail in your project, run this to report the issue to the marketplace for investigation. + +### `/debug-review` +Investigate diagnostic issues and propose fixes with human approval. + +**What it does:** +- Fetches open diagnostic issues from marketplace +- Lets you select which issue to investigate +- Maps errors to relevant source files +- Reads code and analyzes root cause +- Proposes fixes with THREE mandatory approval gates +- Creates PR with fix after approval + +**Approval Gates:** +1. Analysis confirmation - Does the investigation match your understanding? +2. Fix approach - Proceed with proposed changes? +3. PR creation - Create pull request? + +**When to use:** In the marketplace repo, to investigate and fix issues reported by `/debug-report`. + ## Code Quality Commands The `/review` and `/test-check` commands complement the Executor agent by catching issues before work is marked complete. Run both commands before `/sprint-close` for a complete quality check. @@ -447,9 +480,13 @@ projman/ │ ├── sprint-close.md │ ├── labels-sync.md │ ├── initial-setup.md +│ ├── project-init.md +│ ├── project-sync.md │ ├── review.md │ ├── test-check.md -│ └── test-gen.md +│ ├── test-gen.md +│ ├── debug-report.md +│ └── debug-review.md ├── agents/ # Agent prompts │ ├── planner.md │ ├── orchestrator.md