From 8781179fd0fccf9a2be1eac6880c9c23aba68e15 Mon Sep 17 00:00:00 2001 From: lmiranda Date: Wed, 4 Feb 2026 12:14:42 -0500 Subject: [PATCH] feat(marketplace): add lean/full profile switching for token optimization - Add marketplace-lean.json (6 plugins) and marketplace-full.json (12 plugins) - Add .mcp-lean.json (gitea only) and .mcp-full.json (5 servers) - Create scripts/switch-profile.sh for easy profile switching - Update sprint-status.md with conditional skill loading - Set lean profile as default (~14k token savings) Lean profile includes: projman, git-flow, pr-review, clarity-assist, code-sentinel, doc-guardian Co-Authored-By: Claude Opus 4.5 --- .claude-plugin/marketplace-full.json | 205 ++++++++++++++++++++++ .claude-plugin/marketplace-lean.json | 109 ++++++++++++ .claude-plugin/marketplace.json | 172 ++++-------------- .mcp-full.json | 24 +++ .mcp-lean.json | 8 + .mcp.json | 16 -- CHANGELOG.md | 27 ++- plugins/projman/commands/sprint-status.md | 74 ++++---- scripts/switch-profile.sh | 55 ++++++ 9 files changed, 504 insertions(+), 186 deletions(-) create mode 100644 .claude-plugin/marketplace-full.json create mode 100644 .claude-plugin/marketplace-lean.json create mode 100644 .mcp-full.json create mode 100644 .mcp-lean.json create mode 100755 scripts/switch-profile.sh diff --git a/.claude-plugin/marketplace-full.json b/.claude-plugin/marketplace-full.json new file mode 100644 index 0000000..a0521bc --- /dev/null +++ b/.claude-plugin/marketplace-full.json @@ -0,0 +1,205 @@ +{ + "name": "leo-claude-mktplace", + "owner": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "metadata": { + "description": "Project management plugins with Gitea and NetBox integrations", + "version": "7.0.0" + }, + "plugins": [ + { + "name": "projman", + "version": "3.4.0", + "description": "Sprint planning and project management with Gitea integration", + "source": "./plugins/projman", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/projman/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "development", + "tags": ["sprint", "agile", "gitea", "project-management"], + "license": "MIT" + }, + { + "name": "doc-guardian", + "version": "1.1.0", + "description": "Automatic documentation drift detection and synchronization", + "source": "./plugins/doc-guardian", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/doc-guardian/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "productivity", + "tags": ["documentation", "drift-detection", "sync"], + "license": "MIT" + }, + { + "name": "code-sentinel", + "version": "1.0.1", + "description": "Security scanning and code refactoring tools", + "source": "./plugins/code-sentinel", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/code-sentinel/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "security", + "tags": ["security-scan", "refactoring", "vulnerabilities"], + "license": "MIT" + }, + { + "name": "project-hygiene", + "version": "0.1.0", + "description": "Post-task cleanup hook that removes temp files and manages orphaned files", + "source": "./plugins/project-hygiene", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/project-hygiene/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "productivity", + "tags": ["cleanup", "automation", "hygiene"], + "license": "MIT" + }, + { + "name": "cmdb-assistant", + "version": "1.2.0", + "description": "NetBox CMDB integration with data quality validation and machine registration", + "source": "./plugins/cmdb-assistant", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/cmdb-assistant/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "infrastructure", + "tags": ["cmdb", "netbox", "dcim", "ipam", "data-quality", "validation"], + "license": "MIT" + }, + { + "name": "claude-config-maintainer", + "version": "1.2.0", + "description": "CLAUDE.md and settings.local.json optimization for Claude Code projects", + "source": "./plugins/claude-config-maintainer", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/claude-config-maintainer/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "development", + "tags": ["claude-md", "configuration", "optimization"], + "license": "MIT" + }, + { + "name": "clarity-assist", + "version": "1.2.0", + "description": "Prompt optimization and requirement clarification with ND-friendly accommodations", + "source": "./plugins/clarity-assist", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/clarity-assist/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "productivity", + "tags": ["prompts", "requirements", "clarification", "nd-friendly"], + "license": "MIT" + }, + { + "name": "git-flow", + "version": "1.2.0", + "description": "Git workflow automation with intelligent commit messages and branch management", + "source": "./plugins/git-flow", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/git-flow/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "development", + "tags": ["git", "workflow", "commits", "branching"], + "license": "MIT" + }, + { + "name": "pr-review", + "version": "1.1.0", + "description": "Multi-agent pull request review with confidence scoring and actionable feedback", + "source": "./plugins/pr-review", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/pr-review/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "development", + "tags": ["code-review", "pull-requests", "security", "quality"], + "license": "MIT" + }, + { + "name": "data-platform", + "version": "1.3.0", + "description": "Data engineering tools with pandas, PostgreSQL/PostGIS, and dbt integration", + "source": "./plugins/data-platform", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/data-platform/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "data", + "tags": ["pandas", "postgresql", "postgis", "dbt", "data-engineering", "etl"], + "license": "MIT" + }, + { + "name": "viz-platform", + "version": "1.1.0", + "description": "Visualization tools with Dash Mantine Components validation, Plotly charts, and theming", + "source": "./plugins/viz-platform", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/viz-platform/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "visualization", + "tags": ["dash", "plotly", "mantine", "charts", "dashboards", "theming", "dmc"], + "license": "MIT" + }, + { + "name": "contract-validator", + "version": "1.2.0", + "description": "Cross-plugin compatibility validation and Claude.md agent verification", + "source": "./plugins/contract-validator", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/contract-validator/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "development", + "tags": ["validation", "contracts", "compatibility", "agents", "interfaces", "cross-plugin"], + "license": "MIT" + } + ] +} diff --git a/.claude-plugin/marketplace-lean.json b/.claude-plugin/marketplace-lean.json new file mode 100644 index 0000000..b9db03e --- /dev/null +++ b/.claude-plugin/marketplace-lean.json @@ -0,0 +1,109 @@ +{ + "name": "leo-claude-mktplace", + "owner": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "metadata": { + "description": "Project management plugins with Gitea and NetBox integrations", + "version": "7.0.0" + }, + "plugins": [ + { + "name": "projman", + "version": "3.4.0", + "description": "Sprint planning and project management with Gitea integration", + "source": "./plugins/projman", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/projman/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "development", + "tags": ["sprint", "agile", "gitea", "project-management"], + "license": "MIT" + }, + { + "name": "git-flow", + "version": "1.2.0", + "description": "Git workflow automation with intelligent commit messages and branch management", + "source": "./plugins/git-flow", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/git-flow/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "development", + "tags": ["git", "workflow", "commits", "branching"], + "license": "MIT" + }, + { + "name": "pr-review", + "version": "1.1.0", + "description": "Multi-agent pull request review with confidence scoring and actionable feedback", + "source": "./plugins/pr-review", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/pr-review/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "development", + "tags": ["code-review", "pull-requests", "security", "quality"], + "license": "MIT" + }, + { + "name": "clarity-assist", + "version": "1.2.0", + "description": "Prompt optimization and requirement clarification with ND-friendly accommodations", + "source": "./plugins/clarity-assist", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/clarity-assist/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "productivity", + "tags": ["prompts", "requirements", "clarification", "nd-friendly"], + "license": "MIT" + }, + { + "name": "code-sentinel", + "version": "1.0.1", + "description": "Security scanning and code refactoring tools", + "source": "./plugins/code-sentinel", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/code-sentinel/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "security", + "tags": ["security-scan", "refactoring", "vulnerabilities"], + "license": "MIT" + }, + { + "name": "doc-guardian", + "version": "1.1.0", + "description": "Automatic documentation drift detection and synchronization", + "source": "./plugins/doc-guardian", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/doc-guardian/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "productivity", + "tags": ["documentation", "drift-detection", "sync"], + "license": "MIT" + } + ] +} diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index a0521bc..b9db03e 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -25,102 +25,6 @@ "tags": ["sprint", "agile", "gitea", "project-management"], "license": "MIT" }, - { - "name": "doc-guardian", - "version": "1.1.0", - "description": "Automatic documentation drift detection and synchronization", - "source": "./plugins/doc-guardian", - "author": { - "name": "Leo Miranda", - "email": "leobmiranda@gmail.com" - }, - "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/doc-guardian/README.md", - "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", - "hooks": ["./hooks/hooks.json"], - "category": "productivity", - "tags": ["documentation", "drift-detection", "sync"], - "license": "MIT" - }, - { - "name": "code-sentinel", - "version": "1.0.1", - "description": "Security scanning and code refactoring tools", - "source": "./plugins/code-sentinel", - "author": { - "name": "Leo Miranda", - "email": "leobmiranda@gmail.com" - }, - "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/code-sentinel/README.md", - "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", - "hooks": ["./hooks/hooks.json"], - "category": "security", - "tags": ["security-scan", "refactoring", "vulnerabilities"], - "license": "MIT" - }, - { - "name": "project-hygiene", - "version": "0.1.0", - "description": "Post-task cleanup hook that removes temp files and manages orphaned files", - "source": "./plugins/project-hygiene", - "author": { - "name": "Leo Miranda", - "email": "leobmiranda@gmail.com" - }, - "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/project-hygiene/README.md", - "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", - "hooks": ["./hooks/hooks.json"], - "category": "productivity", - "tags": ["cleanup", "automation", "hygiene"], - "license": "MIT" - }, - { - "name": "cmdb-assistant", - "version": "1.2.0", - "description": "NetBox CMDB integration with data quality validation and machine registration", - "source": "./plugins/cmdb-assistant", - "author": { - "name": "Leo Miranda", - "email": "leobmiranda@gmail.com" - }, - "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/cmdb-assistant/README.md", - "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", - "hooks": ["./hooks/hooks.json"], - "category": "infrastructure", - "tags": ["cmdb", "netbox", "dcim", "ipam", "data-quality", "validation"], - "license": "MIT" - }, - { - "name": "claude-config-maintainer", - "version": "1.2.0", - "description": "CLAUDE.md and settings.local.json optimization for Claude Code projects", - "source": "./plugins/claude-config-maintainer", - "author": { - "name": "Leo Miranda", - "email": "leobmiranda@gmail.com" - }, - "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/claude-config-maintainer/README.md", - "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", - "hooks": ["./hooks/hooks.json"], - "category": "development", - "tags": ["claude-md", "configuration", "optimization"], - "license": "MIT" - }, - { - "name": "clarity-assist", - "version": "1.2.0", - "description": "Prompt optimization and requirement clarification with ND-friendly accommodations", - "source": "./plugins/clarity-assist", - "author": { - "name": "Leo Miranda", - "email": "leobmiranda@gmail.com" - }, - "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/clarity-assist/README.md", - "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", - "hooks": ["./hooks/hooks.json"], - "category": "productivity", - "tags": ["prompts", "requirements", "clarification", "nd-friendly"], - "license": "MIT" - }, { "name": "git-flow", "version": "1.2.0", @@ -154,51 +58,51 @@ "license": "MIT" }, { - "name": "data-platform", - "version": "1.3.0", - "description": "Data engineering tools with pandas, PostgreSQL/PostGIS, and dbt integration", - "source": "./plugins/data-platform", - "author": { - "name": "Leo Miranda", - "email": "leobmiranda@gmail.com" - }, - "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/data-platform/README.md", - "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", - "hooks": ["./hooks/hooks.json"], - "category": "data", - "tags": ["pandas", "postgresql", "postgis", "dbt", "data-engineering", "etl"], - "license": "MIT" - }, - { - "name": "viz-platform", - "version": "1.1.0", - "description": "Visualization tools with Dash Mantine Components validation, Plotly charts, and theming", - "source": "./plugins/viz-platform", - "author": { - "name": "Leo Miranda", - "email": "leobmiranda@gmail.com" - }, - "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/viz-platform/README.md", - "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", - "hooks": ["./hooks/hooks.json"], - "category": "visualization", - "tags": ["dash", "plotly", "mantine", "charts", "dashboards", "theming", "dmc"], - "license": "MIT" - }, - { - "name": "contract-validator", + "name": "clarity-assist", "version": "1.2.0", - "description": "Cross-plugin compatibility validation and Claude.md agent verification", - "source": "./plugins/contract-validator", + "description": "Prompt optimization and requirement clarification with ND-friendly accommodations", + "source": "./plugins/clarity-assist", "author": { "name": "Leo Miranda", "email": "leobmiranda@gmail.com" }, - "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/contract-validator/README.md", + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/clarity-assist/README.md", "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", "hooks": ["./hooks/hooks.json"], - "category": "development", - "tags": ["validation", "contracts", "compatibility", "agents", "interfaces", "cross-plugin"], + "category": "productivity", + "tags": ["prompts", "requirements", "clarification", "nd-friendly"], + "license": "MIT" + }, + { + "name": "code-sentinel", + "version": "1.0.1", + "description": "Security scanning and code refactoring tools", + "source": "./plugins/code-sentinel", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/code-sentinel/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "security", + "tags": ["security-scan", "refactoring", "vulnerabilities"], + "license": "MIT" + }, + { + "name": "doc-guardian", + "version": "1.1.0", + "description": "Automatic documentation drift detection and synchronization", + "source": "./plugins/doc-guardian", + "author": { + "name": "Leo Miranda", + "email": "leobmiranda@gmail.com" + }, + "homepage": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/src/branch/main/plugins/doc-guardian/README.md", + "repository": "https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace.git", + "hooks": ["./hooks/hooks.json"], + "category": "productivity", + "tags": ["documentation", "drift-detection", "sync"], "license": "MIT" } ] diff --git a/.mcp-full.json b/.mcp-full.json new file mode 100644 index 0000000..ffd82ea --- /dev/null +++ b/.mcp-full.json @@ -0,0 +1,24 @@ +{ + "mcpServers": { + "gitea": { + "command": "./mcp-servers/gitea/run.sh", + "args": [] + }, + "netbox": { + "command": "./mcp-servers/netbox/run.sh", + "args": [] + }, + "viz-platform": { + "command": "./mcp-servers/viz-platform/run.sh", + "args": [] + }, + "data-platform": { + "command": "./mcp-servers/data-platform/run.sh", + "args": [] + }, + "contract-validator": { + "command": "./mcp-servers/contract-validator/run.sh", + "args": [] + } + } +} diff --git a/.mcp-lean.json b/.mcp-lean.json new file mode 100644 index 0000000..5ea16bd --- /dev/null +++ b/.mcp-lean.json @@ -0,0 +1,8 @@ +{ + "mcpServers": { + "gitea": { + "command": "./mcp-servers/gitea/run.sh", + "args": [] + } + } +} diff --git a/.mcp.json b/.mcp.json index ffd82ea..5ea16bd 100644 --- a/.mcp.json +++ b/.mcp.json @@ -3,22 +3,6 @@ "gitea": { "command": "./mcp-servers/gitea/run.sh", "args": [] - }, - "netbox": { - "command": "./mcp-servers/netbox/run.sh", - "args": [] - }, - "viz-platform": { - "command": "./mcp-servers/viz-platform/run.sh", - "args": [] - }, - "data-platform": { - "command": "./mcp-servers/data-platform/run.sh", - "args": [] - }, - "contract-validator": { - "command": "./mcp-servers/contract-validator/run.sh", - "args": [] } } } diff --git a/CHANGELOG.md b/CHANGELOG.md index 9cf1d50..80c80cd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,20 +6,35 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). ## [Unreleased] -### Fixed - -- **docs:** Stale command references in data-platform visual-header.md and viz-platform claude-md-integration.md updated to v7.0.0 namespaced names -- **docs:** git-flow visual-header.md and git-status.md quick actions updated to namespaced commands -- **docs:** projman/CONFIGURATION.md and docs/DEBUGGING-CHECKLIST.md updated with correct command names - ### Added +- **marketplace:** Lean/full profile switching to reduce token overhead + - New script: `scripts/switch-profile.sh` to toggle between profiles + - Lean profile: 6 plugins (projman, git-flow, pr-review, clarity-assist, code-sentinel, doc-guardian) + - Lean MCP: gitea only (reduces ~12k tokens of MCP server overhead) + - Full profile: all 12 plugins and 5 MCP servers + - New files: `.mcp-lean.json`, `.mcp-full.json`, `marketplace-lean.json`, `marketplace-full.json` + - Default is now lean profile for reduced daily overhead - **projman:** Token usage estimation reporting at sprint workflow boundaries - New skill: `token-budget-report.md` with MCP overhead and skill loading estimation model - Token report displayed at end of `/sprint-plan` and `/sprint-close` - On-demand via `/sprint-status --tokens` - Helps identify which phases and components consume the most context budget +### Changed + +- **projman:** `/sprint-status` now uses conditional skill loading for reduced token overhead + - Only loads `mcp-tools-reference.md` by default (~1.5k tokens vs ~5k) + - `--diagram` flag loads `dependency-management.md` and `progress-tracking.md` + - `--tokens` flag loads `token-budget-report.md` + - Estimated savings: ~3.5k tokens per status check + +### Fixed + +- **docs:** Stale command references in data-platform visual-header.md and viz-platform claude-md-integration.md updated to v7.0.0 namespaced names +- **docs:** git-flow visual-header.md and git-status.md quick actions updated to namespaced commands +- **docs:** projman/CONFIGURATION.md and docs/DEBUGGING-CHECKLIST.md updated with correct command names + --- ## [7.0.0] - 2026-02-03 diff --git a/plugins/projman/commands/sprint-status.md b/plugins/projman/commands/sprint-status.md index 57d12d0..8b286d6 100644 --- a/plugins/projman/commands/sprint-status.md +++ b/plugins/projman/commands/sprint-status.md @@ -6,15 +6,18 @@ description: Check current sprint progress, identify blockers, optionally genera ## Skills Required +**Always loaded:** - skills/mcp-tools-reference.md -- skills/progress-tracking.md -- skills/dependency-management.md -- skills/sprint-lifecycle.md -- skills/token-budget-report.md + +**Conditional — only load if matching flag is present:** +- skills/sprint-lifecycle.md — load if displaying lifecycle state (always, but this is small) +- skills/dependency-management.md — load ONLY with `--diagram` flag +- skills/token-budget-report.md — load ONLY with `--tokens` flag +- skills/progress-tracking.md — load ONLY with `--diagram` flag ## Purpose -Check current sprint progress, identify blockers, and show execution status. Optionally generate a visual dependency diagram. +Check current sprint progress, identify blockers, and show execution status. Optionally generate a visual dependency diagram or token budget report. ## Invocation @@ -26,23 +29,24 @@ Check current sprint progress, identify blockers, and show execution status. Opt ## Workflow -0. **Display Lifecycle State** - Read current Sprint/* state from milestone description per `skills/sprint-lifecycle.md` and display in output header. -1. **Fetch Sprint Issues** - Get all issues for current milestone -2. **Calculate Progress** - Count completed vs total issues -3. **Identify Active Tasks** - Find issues with `Status/In-Progress` -4. **Identify Blockers** - Find issues with `Status/Blocked` -5. **Show Dependency Status** - Which tasks are now unblocked -6. **Parse Progress Comments** - Extract real-time status from structured comments +1. **Fetch Active Milestone** — `get_milestone` for the open milestone +2. **Read Lifecycle State** — Parse `**Sprint State:**` from milestone description +3. **Fetch Sprint Issues** — `list_issues` filtered by milestone +4. **Calculate Progress** — Count closed vs total issues +5. **Identify Blockers** — Find issues with `Status/Blocked` label +6. **Display Output** — Format header + progress bar + issue table + blockers -### If --diagram flag: +That's it. No dependency analysis, no token estimation, no progress comment parsing unless a flag asks for it. -7. **Fetch Dependencies** - Use `list_issue_dependencies` for each issue -8. **Get Execution Order** - Use `get_execution_order` for batch grouping -9. **Generate Mermaid Syntax** - Create flowchart with status colors +### If --diagram flag, THEN ALSO: +7. Fetch dependencies with `list_issue_dependencies` +8. Load `skills/dependency-management.md` +9. Load `skills/progress-tracking.md` +10. Generate Mermaid diagram -### If --tokens flag: - -10. **Generate Token Budget Report** - Execute `skills/token-budget-report.md` estimation model +### If --tokens flag, THEN ALSO: +11. Load `skills/token-budget-report.md` +12. **Generate Token Budget Report** - Execute `skills/token-budget-report.md` estimation model - Phase: STATUS (read-only snapshot, not a workflow boundary) - List MCP servers from `.mcp.json` with static overhead estimates - Show current session cost estimate based on skills loaded so far @@ -50,7 +54,27 @@ Check current sprint progress, identify blockers, and show execution status. Opt ## Output Format -See `skills/progress-tracking.md` for the progress display format. +### Default Output (no flags) + +``` +╔══════════════════════════════════════════════════════════════════╗ +║ 📋 PROJMAN ║ +║ 📊 STATUS ║ +║ [Sprint Name] ║ +╚══════════════════════════════════════════════════════════════════╝ + +Sprint State: [Planning|Executing|Blocked|Review|Closing] + +Progress: [██████████░░░░░░░░░░] 50% (5/10 issues) + +| # | Title | Status | Labels | +|---|-------|--------|--------| +| 123 | Issue title | Open | Priority/High | +| 124 | Another issue | Closed | Type/Bug | + +Blockers: +- #125: Blocked issue title (Status/Blocked) +``` ### Diagram Format (--diagram) @@ -78,13 +102,3 @@ flowchart TD | In Progress | Yellow | #FFD700 | | Open | Blue | #ADD8E6 | | Blocked | Red | #FFB6C1 | - -## Visual Output - -``` -╔══════════════════════════════════════════════════════════════════╗ -║ 📋 PROJMAN ║ -║ 📊 STATUS ║ -║ [Sprint Name] ║ -╚══════════════════════════════════════════════════════════════════╝ -``` diff --git a/scripts/switch-profile.sh b/scripts/switch-profile.sh new file mode 100755 index 0000000..12c5f70 --- /dev/null +++ b/scripts/switch-profile.sh @@ -0,0 +1,55 @@ +#!/usr/bin/env bash +# Switch between marketplace profiles +# Usage: ./scripts/switch-profile.sh [lean|full] + +set -euo pipefail + +SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" +ROOT_DIR="$(dirname "$SCRIPT_DIR")" +MARKETPLACE_DIR="$ROOT_DIR/.claude-plugin" + +case "${1:-lean}" in + lean) + cp "$MARKETPLACE_DIR/marketplace-lean.json" "$MARKETPLACE_DIR/marketplace.json" + cp "$ROOT_DIR/.mcp-lean.json" "$ROOT_DIR/.mcp.json" + echo "Switched to LEAN profile (6 plugins, 1 MCP server)" + echo "" + echo "Plugins: projman, git-flow, pr-review, clarity-assist, code-sentinel, doc-guardian" + echo "MCP: gitea only" + echo "" + echo "Restart Claude Code session for changes to take effect." + ;; + full) + cp "$MARKETPLACE_DIR/marketplace-full.json" "$MARKETPLACE_DIR/marketplace.json" + cp "$ROOT_DIR/.mcp-full.json" "$ROOT_DIR/.mcp.json" + echo "Switched to FULL profile (12 plugins, 5 MCP servers)" + echo "" + echo "Plugins: all" + echo "MCP: gitea, netbox, data-platform, viz-platform, contract-validator" + echo "" + echo "Restart Claude Code session for changes to take effect." + ;; + status) + # Check current profile by comparing files + if diff -q "$MARKETPLACE_DIR/marketplace.json" "$MARKETPLACE_DIR/marketplace-lean.json" >/dev/null 2>&1; then + echo "Current profile: LEAN (6 plugins, 1 MCP server)" + elif diff -q "$MARKETPLACE_DIR/marketplace.json" "$MARKETPLACE_DIR/marketplace-full.json" >/dev/null 2>&1; then + echo "Current profile: FULL (12 plugins, 5 MCP servers)" + else + echo "Current profile: CUSTOM (marketplace.json differs from both profiles)" + fi + ;; + *) + echo "Usage: $0 [lean|full|status]" + echo "" + echo "Profiles:" + echo " lean — 6 core plugins (projman, git-flow, pr-review, clarity-assist, code-sentinel, doc-guardian)" + echo " 1 MCP server (gitea only)" + echo " full — All 12 plugins" + echo " 5 MCP servers (gitea, netbox, data-platform, viz-platform, contract-validator)" + echo " status — Show current profile" + echo "" + echo "Note: Restart Claude Code session after switching for changes to take effect." + exit 1 + ;; +esac