diff --git a/CHANGELOG.md b/CHANGELOG.md index fcb1b2e..184464b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -15,18 +15,26 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). - `metadata` wrapper for description/version in marketplace.json - Keywords to all plugin manifests for better discoverability - `commands` and `agents` directory references to plugin manifests +- Versioning rule: version displayed only in main README.md title ### Changed - Updated marketplace.json with required fields per Claude Code spec - Fixed installation documentation to use official Claude Code methods - Prioritized public HTTPS URL over Tailscale SSH URL in documentation - Updated all plugin manifests with author, homepage, repository, license fields +- Consolidated version display to main README.md title only +- Removed version numbers from plugin documentation titles ### Fixed - Plugin manifests now include all required fields per Claude Code spec - Installation section uses `extraKnownMarketplaces` instead of undocumented `pluginMarketplace` -## [2.1.0] - Previous Release +### Removed +- `docs/references/` directory (obsolete planning documents) +- Version numbers from individual plugin README titles +- Version section from plugins/projman/README.md + +## [2.1.0] - 2026-01-15 ### Added - `docs/CANONICAL-PATHS.md` - Single source of truth for all file paths @@ -37,16 +45,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). - Update documentation (`docs/UPDATING.md`) - `/initial-setup` slash command - File creation governance rules in CLAUDE.md -- Architecture diagram specifications in `docs/architecture/` - `.scratch/` directory for transient work - `scripts/` directory for setup automation -- `docs/architecture/` for Draw.io diagrams -- `docs/workflows/` for workflow documentation ### Changed - Replaced `docs/CORRECT-ARCHITECTURE.md` reference with `docs/CANONICAL-PATHS.md` - Added mandatory path verification section to CLAUDE.md -- Reorganized documentation into `docs/references/`, `docs/architecture/`, `docs/workflows/` - Updated CLAUDE.md with file creation governance ### Fixed @@ -54,21 +58,44 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). ### Removed - Organization/workspace GID variable (no longer needed) -- Deprecated `cmdb-assistant/` plugin - Development output files (test scripts, status reports) - IDE-specific workspace files - Stray files from project root -## [0.1.0] - Initial Release +## [2.0.0] - 2026-01-06 ### Added -- projman plugin for sprint management +- Full Gitea integration with wiki, milestones, dependencies +- Parallel execution batching via dependency graph +- Wiki tools for lessons learned (`create_lesson`, `search_lessons`) +- Milestone tools (`list_milestones`, `create_milestone`, `update_milestone`) +- Dependency tools (`list_issue_dependencies`, `create_issue_dependency`, `get_execution_order`) +- Validation tools (`validate_repo_org`, `get_branch_protection`) +- MCP servers bundled inside plugins (not shared at root) + +### Changed +- MCP server architecture: bundled in plugins instead of shared at root +- Configuration uses `${CLAUDE_PLUGIN_ROOT}/mcp-servers/` paths + +## [1.0.0] - 2025-12-15 + +### Added +- projman plugin with basic sprint commands +- `/sprint-plan`, `/sprint-start`, `/sprint-status`, `/sprint-close` commands +- `/labels-sync` command for label taxonomy synchronization +- Three-agent model (planner, orchestrator, executor) +- Gitea MCP server with issue and label tools +- 43-label taxonomy system +- Hybrid configuration system (system + project level) +- Branch-aware security model + +## [0.1.0] - 2025-12-01 + +### Added +- Initial repository structure +- projman plugin structure (planned) - projman-pmo plugin structure (planned) - project-hygiene plugin for cleanup automation -- Gitea MCP server -- Wiki.js MCP server -- 43-label taxonomy system -- Lessons learned capture system -- Hybrid configuration system (system + project level) -- Three-agent model (planner, orchestrator, executor) -- Branch-aware security model +- claude-config-maintainer plugin structure +- cmdb-assistant plugin structure +- Basic marketplace manifest diff --git a/CLAUDE.md b/CLAUDE.md index c61f15f..eaef7a1 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -38,24 +38,24 @@ support-claude-mktplace/ ├── .claude-plugin/ │ └── marketplace.json # Marketplace manifest ├── plugins/ -│ ├── projman/ # Sprint management (v2.2.0) +│ ├── projman/ # Sprint management │ │ ├── .claude-plugin/plugin.json │ │ ├── .mcp.json │ │ ├── mcp-servers/gitea/ # Bundled MCP server │ │ ├── commands/ # 8 commands │ │ │ ├── sprint-plan.md, sprint-start.md, sprint-status.md │ │ │ ├── sprint-close.md, labels-sync.md, initial-setup.md -│ │ │ ├── review.md, test-check.md # NEW in v2.2.0 +│ │ │ └── review.md, test-check.md │ │ ├── agents/ # 4 agents │ │ │ ├── planner.md, orchestrator.md, executor.md -│ │ │ └── code-reviewer.md # NEW in v2.2.0 +│ │ │ └── code-reviewer.md │ │ └── skills/label-taxonomy/ │ ├── claude-config-maintainer/ │ ├── cmdb-assistant/ │ └── project-hygiene/ ├── scripts/ │ ├── setup.sh, post-update.sh -│ └── validate-marketplace.sh # NEW in v2.2.0 +│ └── validate-marketplace.sh # Marketplace compliance validation └── docs/ ├── CANONICAL-PATHS.md # Single source of truth for paths └── references/ @@ -88,7 +88,7 @@ support-claude-mktplace/ ## Architecture -### Four-Agent Model (projman v2.2.0) +### Four-Agent Model | Agent | Personality | Responsibilities | |-------|-------------|------------------| @@ -181,15 +181,36 @@ Stored in Gitea Wiki under `lessons-learned/sprints/`. | `plugins/projman/CONFIGURATION.md` | Projman setup guide | | `plugins/projman/README.md` | Projman full documentation | -## Version History +## Versioning and Changelog Rules -| Version | Date | Highlights | -|---------|------|------------| -| 2.2.0 | 2026-01-20 | `/review`, `/test-check` commands, code-reviewer agent, validation script, marketplace compliance | -| 2.1.0 | Previous | Canonical paths, initial-setup command, documentation improvements | -| 2.0.0 | Previous | Full Gitea integration, wiki, milestones, dependencies, parallel execution | -| 0.1.0 | Initial | Basic plugin structure | +### Version Display +**The marketplace version is displayed ONLY in the main `README.md` title.** + +- Format: `# Claude Code Marketplace - vX.Y.Z` +- Do NOT add version numbers to individual plugin documentation titles +- Do NOT add version numbers to configuration guides +- Do NOT add version numbers to CLAUDE.md or other docs + +### Changelog Maintenance (MANDATORY) +**`CHANGELOG.md` is the authoritative source for version history.** + +When releasing a new version: +1. Update main `README.md` title with new version +2. Update `CHANGELOG.md` with: + - Version number and date: `## [X.Y.Z] - YYYY-MM-DD` + - **Added**: New features, commands, files + - **Changed**: Modifications to existing functionality + - **Fixed**: Bug fixes + - **Removed**: Deleted features, files, deprecated items +3. Update `marketplace.json` metadata version +4. Update plugin `plugin.json` versions if plugin-specific changes + +### Version Format +- Follow [Semantic Versioning](https://semver.org/): MAJOR.MINOR.PATCH +- MAJOR: Breaking changes +- MINOR: New features, backward compatible +- PATCH: Bug fixes, minor improvements --- -**Last Updated:** 2026-01-20 | **Current Version:** 2.2.0 +**Last Updated:** 2026-01-20 diff --git a/README.md b/README.md index 2c7125e..bde7dfb 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ -# Claude Code Marketplace +# Claude Code Marketplace - v2.2.0 A collection of Claude Code plugins for project management, infrastructure automation, and development workflows. ## Plugins -### [projman](./plugins/projman/README.md) v2.2.0 +### [projman](./plugins/projman/README.md) **Sprint Planning and Project Management** AI-guided sprint planning with full Gitea integration. Transforms a proven 15-sprint workflow into a distributable plugin. @@ -212,7 +212,7 @@ support-claude-mktplace/ └── validate-marketplace.sh # Marketplace compliance validation ``` -## Key Features (v2.2.0) +## Key Features ### Parallel Execution Tasks are batched by dependency graph for optimal parallel execution: diff --git a/plugins/projman/CONFIGURATION.md b/plugins/projman/CONFIGURATION.md index 691ecaf..b31667f 100644 --- a/plugins/projman/CONFIGURATION.md +++ b/plugins/projman/CONFIGURATION.md @@ -1,4 +1,4 @@ -# Configuration Guide - Projman Plugin v2.0.0 +# Configuration Guide - Projman Plugin Complete setup and configuration instructions for the Projman project management plugin. diff --git a/plugins/projman/README.md b/plugins/projman/README.md index 61bb49f..72a9b6e 100644 --- a/plugins/projman/README.md +++ b/plugins/projman/README.md @@ -1,4 +1,4 @@ -# Projman v2.2.0 - Project Management for Claude Code +# Projman - Project Management for Claude Code Sprint planning and project management plugin with full Gitea integration. @@ -479,16 +479,6 @@ See [CONFIGURATION.md](./CONFIGURATION.md) for detailed configuration instructio MIT License - See repository root for details -## Version - -**Current:** 2.2.0 - -**Changelog:** -- v2.2.0: Added `/review` and `/test-check` commands, code-reviewer agent, marketplace compliance updates -- v2.1.0: Documentation improvements, canonical paths, initial-setup command -- v2.0.0: Full Gitea integration with wiki, milestones, dependencies, parallel execution -- v1.0.0: Initial release with basic commands - --- **Status:** Production Ready