refactor(projman): extract skills and consolidate commands #336

lmiranda · 2026-01-30T20:03:24Z

lmiranda commented

2026-01-30 20:03:24 +00:00

Summary

Major refactoring of projman plugin architecture to improve maintainability and reduce duplication.

Skills Extraction (17 new files)

Extracted reusable knowledge from commands and agents into plugins/projman/skills/:

branch-security.md - Branch protection rules and security modes
dependency-management.md - Issue dependency ordering and execution
git-workflow.md - Git operations and branch management
input-detection.md - Argument parsing for commands
issue-conventions.md - Issue formatting and labeling standards
lessons-learned.md - Wiki-based lessons system
mcp-tools-reference.md - Available MCP tools reference
planning-workflow.md - Sprint planning methodology
progress-tracking.md - Sprint progress monitoring
repo-validation.md - Repository validation procedures
review-checklist.md - Code review standards
runaway-detection.md - Preventing runaway agent behavior
setup-workflows.md - Setup command procedures
sprint-approval.md - Sprint approval workflows
task-sizing.md - Issue complexity estimation
test-standards.md - Testing requirements
wiki-conventions.md - Wiki organization patterns

Command Consolidation (17 → 12 commands)

/setup: consolidates initial-setup, project-init, project-sync via --full/--quick/--sync flags
/debug: consolidates debug-report, debug-review via report/review modes
/test: consolidates test-check, test-gen via run/gen modes
/sprint-status: absorbs sprint-diagram via --diagram flag

Architecture Cleanup

Removed plugin-level mcp-servers/ symlinks (6 plugins) - now use root .mcp.json only
Removed plugin README.md files (12 files, ~2000 lines) - not needed by Claude Code
Updated all documentation to reflect new command structure
Fixed documentation drift in CONFIGURATION.md, COMMANDS-CHEATSHEET.md

Stats

70 files changed
+3,436 lines (new skills, consolidated commands)
-8,873 lines (removed duplication, READMEs, symlinks)
Net: -5,437 lines removed

Test Plan

Verify /setup --full workflow works correctly
Verify /setup --quick workflow works correctly
Verify /setup --sync workflow works correctly
Verify /debug report generates diagnostic report
Verify /debug review investigates issues
Verify /test run executes tests
Verify /test gen <target> generates tests
Verify /sprint-status --diagram generates Mermaid diagram
Verify all skill files are loaded by commands/agents

🤖 Generated with Claude Code

## Summary Major refactoring of projman plugin architecture to improve maintainability and reduce duplication. ### Skills Extraction (17 new files) Extracted reusable knowledge from commands and agents into `plugins/projman/skills/`: - `branch-security.md` - Branch protection rules and security modes - `dependency-management.md` - Issue dependency ordering and execution - `git-workflow.md` - Git operations and branch management - `input-detection.md` - Argument parsing for commands - `issue-conventions.md` - Issue formatting and labeling standards - `lessons-learned.md` - Wiki-based lessons system - `mcp-tools-reference.md` - Available MCP tools reference - `planning-workflow.md` - Sprint planning methodology - `progress-tracking.md` - Sprint progress monitoring - `repo-validation.md` - Repository validation procedures - `review-checklist.md` - Code review standards - `runaway-detection.md` - Preventing runaway agent behavior - `setup-workflows.md` - Setup command procedures - `sprint-approval.md` - Sprint approval workflows - `task-sizing.md` - Issue complexity estimation - `test-standards.md` - Testing requirements - `wiki-conventions.md` - Wiki organization patterns ### Command Consolidation (17 → 12 commands) - `/setup`: consolidates `initial-setup`, `project-init`, `project-sync` via `--full`/`--quick`/`--sync` flags - `/debug`: consolidates `debug-report`, `debug-review` via `report`/`review` modes - `/test`: consolidates `test-check`, `test-gen` via `run`/`gen` modes - `/sprint-status`: absorbs `sprint-diagram` via `--diagram` flag ### Architecture Cleanup - Removed plugin-level `mcp-servers/` symlinks (6 plugins) - now use root `.mcp.json` only - Removed plugin `README.md` files (12 files, ~2000 lines) - not needed by Claude Code - Updated all documentation to reflect new command structure - Fixed documentation drift in CONFIGURATION.md, COMMANDS-CHEATSHEET.md ### Stats - **70 files changed** - **+3,436 lines** (new skills, consolidated commands) - **-8,873 lines** (removed duplication, READMEs, symlinks) - **Net: -5,437 lines** removed ## Test Plan - [ ] Verify `/setup --full` workflow works correctly - [ ] Verify `/setup --quick` workflow works correctly - [ ] Verify `/setup --sync` workflow works correctly - [ ] Verify `/debug report` generates diagnostic report - [ ] Verify `/debug review` investigates issues - [ ] Verify `/test run` executes tests - [ ] Verify `/test gen <target>` generates tests - [ ] Verify `/sprint-status --diagram` generates Mermaid diagram - [ ] Verify all skill files are loaded by commands/agents 🤖 Generated with [Claude Code](https://claude.ai/code)

lmiranda added the Type/Refactor label 2026-01-30 20:03:24 +00:00

lmiranda added 1 commit 2026-01-30 20:03:25 +00:00

refactor(projman): extract skills and consolidate commands 2e65b60725

Major refactoring of projman plugin architecture:

Skills Extraction (17 new files):
- Extracted reusable knowledge from commands and agents into skills/
- branch-security, dependency-management, git-workflow, input-detection
- issue-conventions, lessons-learned, mcp-tools-reference, planning-workflow
- progress-tracking, repo-validation, review-checklist, runaway-detection
- setup-workflows, sprint-approval, task-sizing, test-standards, wiki-conventions

Command Consolidation (17 → 12 commands):
- /setup: consolidates initial-setup, project-init, project-sync (--full/--quick/--sync)
- /debug: consolidates debug-report, debug-review (report/review modes)
- /test: consolidates test-check, test-gen (run/gen modes)
- /sprint-status: absorbs sprint-diagram via --diagram flag

Architecture Cleanup:
- Remove plugin-level mcp-servers/ symlinks (6 plugins)
- Remove plugin README.md files (12 files, ~2000 lines)
- Update all documentation to reflect new command structure
- Fix documentation drift in CONFIGURATION.md, COMMANDS-CHEATSHEET.md

Commands are now thin dispatchers (~20-50 lines) that reference skills.
Agents reference skills for domain knowledge instead of inline content.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

lmiranda merged commit 3437ece76e into development

2026-01-30 20:03:58 +00:00

lmiranda deleted branch refactor/projman-skills-commands-consolidation

2026-01-30 20:03:58 +00:00

lmiranda referenced this issue from a commit

2026-01-30 20:03:59 +00:00

Merge pull request 'refactor(projman): extract skills and consolidate commands' (#336) from refactor/projman-skills-commands-consolidation into development

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

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