Page:
Change-V5.2.0:-Plugin-Enhancements-(Sprint-5-Documentation)
Pages
Change V5.4.0: Multi-Model Agent Support Proposal
Change V5.4.0: Multi-Model Support (Sprint 7 Implementation)
Change V04.1.0: Proposal (Implementation 1)
Change V04.1.0: Proposal
Change-V5.2.0:-Plugin-Enhancements-(Sprint-4-Commands)
Change-V5.2.0:-Plugin-Enhancements-(Sprint-5-Documentation)
Change-V5.2.0:-Plugin-Enhancements-Proposal.-
Change-V5.5.0:-Hook-Efficiency-Quick-Wins-(Sprint-8-Implementation)
Change-V5.6.0:-Domain-Advisory-Pattern-(Sprint-9-Implementation).-
Change V5.6.0: Domain Advisory Pattern Proposal
Change-V5.7.0:-Data-Platform-Domain-Advisory-(Sprint-10-Implementation)
RFC-Hook-Efficiency-Improvements
RFC-Perf-Sentinel-Plugin
Sprint-1-viz-platform-Implementation-Plan
branding/header-templates
branding/plugin-registry
branding/progress-templates
branding/visual-spec
lessons/patterns/agent-model-field-not-supported-by-claude-code
lessons/patterns/command-frontmatter-missing-name-field-causes-silent-load-failure
lessons/patterns/hook-message-wording-affects-claude-continuation-behavior
lessons/patterns/mcp-venv-symlinks-lost-on-marketplace-update---5-hour-debug-loop
lessons/patterns/mcp_servers-field-in-pluginjson---another-failed-debug-theory
lessons/patterns/plugin-hooks-must-be-in-separate-file-not-inline
lessons/patterns/plugin-load-errors---missing-name-field-in-command-frontmatter
lessons/patterns/plugin-load-failure---check-command-frontmatter-first
lessons/patterns/plugin-manifest-validation---hooks-and-agents-format-requirements
lessons/patterns/plugin-version-mismatch-causes-silent-load-failure
lessons/patterns/reset-pandas-index-after-filtering-to-prevent-column-pollution
lessons/patterns/session-2026-02-02---mcp-server-venv-package-installation-failures
lessons/patterns/setup-wizard-url-format-mismatch
lessons/patterns/sprint-4---new-commands-not-discoverable-until-session-restart
lessons/patterns/startup-hooks-must-check-venv-cache-path-first
lessons/patterns/sync-entire-plugin-directory-not-individual-files
lessons/patterns/use-fixes-n-keyword-for-automatic-issue-closing-in-prs
lessons/sprints/cache-clearing-breaks-mcp-tools-mid-session
lessons/sprints/sprint-1---viz-platform-plugin-implementation
lessons/sprints/sprint-10---domain-advisory-pattern-replication-success
lessons/sprints/sprint-2---contract-validator-plugin-implementation
lessons/sprints/sprint-3---agent-runaway-detection-and-timeout-handling
lessons/sprints/sprint-3---background-agent-permissions-must-be-pre-granted
lessons/sprints/sprint-3---mcp-server-branch-detection-bug-runs-from-installed-dir
lessons/sprints/sprint-4---plugin-commands-implementation
lessons/sprints/sprint-6---visual-branding-and-documentation-maintenance
lessons/sprints/sprint-8---parallel-hook-optimization-success
lessons/sprints/v400-release---wiki-workflow-and-versioning-patterns
lessons/sprints/versioning-workflow---use-unreleased-and-release-script
lessons-learned/sprints/hook-efficiency-rfc
unnamed
Clone
2
Change-V5.2.0:-Plugin-Enhancements-(Sprint-5-Documentation)
Leo Miranda edited this page 2026-01-28 19:19:55 +00:00
Type: Implementation Parent: V5.2.0 Plugin Enhancements Proposal Status: In Progress Date: 2026-01-28 Sprint: 5
Sprint 5: Documentation
Documentation and guides for the V5.2.0 plugin enhancements, plus a bug fix discovered during planning.
Scope
| # | Plugin | Item | Description | Issue |
|---|---|---|---|---|
| 25 | git-flow | Branching strategy documentation | Document development -> staging -> main promotion flow |
#267 |
| 26 | clarity-assist | ND support documentation | Document how the plugin supports neurodivergent users | #268 |
| - | Various | Sprint 3/4 lessons | Document lessons learned from previous sprints | #266 |
| - | projman (gitea MCP) | Fix update_issue | Add milestone parameter to update_issue tool | #269 |
Issues
- #266 - Sprint 3/4 lessons learned and plugin behavior clarifications
- #267 - git-flow branching strategy documentation
- #268 - clarity-assist neurodivergent support documentation
- #269 - Add milestone parameter to update_issue MCP tool (bug fix)
Milestone: Sprint 5 - Documentation
Implementation Notes
git-flow Branching Strategy (#267)
Document the following workflow:
development- Active development, feature branches merge herestaging- Pre-production testing (optional)main- Production-ready releases
Include:
- When to create feature branches
- PR requirements for each branch
- Release workflow
- Hotfix handling
clarity-assist ND Support (#268)
Document accommodations for neurodivergent users:
- Reduced cognitive load features
- Clear, structured output
- Customizable verbosity
- Focus aids
- How the plugin detects vague prompts and suggests improvements
Sprint 3/4 Lessons (#266)
Capture lessons learned:
- MCP branch detection pattern
- Gitea auto-close behavior
- Session restart requirements
- doc-guardian hook improvements needed
update_issue milestone fix (#269)
Add missing milestone parameter to the update_issue MCP tool:
- File:
mcp-servers/gitea/mcp_server/tools/issues.py - Accept milestone ID (integer)
- Include in API payload