Merge pull request 'development: small fixes in the changelog' (#34) from development into main

Reviewed-on: personal-projects/support-claude-mktplace#34

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
+- claude-config-maintainer plugin structure
-- Wiki.js MCP server
+- cmdb-assistant plugin structure
-- 43-label taxonomy system
+- Basic marketplace manifest
-- Lessons learned capture system
-- Hybrid configuration system (system + project level)
-- Three-agent model (planner, orchestrator, executor)
-- Branch-aware security model

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 |
+### Version Display
-|---------|------|------------|
+**The marketplace version is displayed ONLY in the main `README.md` title.**
-| 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 |
+- Format: `# Claude Code Marketplace - vX.Y.Z`
-| 2.0.0 | Previous | Full Gitea integration, wiki, milestones, dependencies, parallel execution |
+- Do NOT add version numbers to individual plugin documentation titles
-| 0.1.0 | Initial | Basic plugin structure |
+- 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

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:

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.
 

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