Files
leo-claude-mktplace/plugins/projman/skills/issue-conventions.md
lmiranda 2d51df7a42 feat(marketplace): command consolidation + 8 new plugins (v8.1.0 → v9.0.0) [BREAKING]
Phase 1b: Rename all ~94 commands across 12 plugins to /<noun> <action>
sub-command pattern. Git-flow consolidated from 8→5 commands (commit
variants absorbed into --push/--merge/--sync flags). Dispatch files,
name: frontmatter, and cross-reference updates for all plugins.

Phase 2: Design documents for 8 new plugins in docs/designs/.

Phase 3: Scaffold 8 new plugins — saas-api-platform, saas-db-migrate,
saas-react-platform, saas-test-pilot, data-seed, ops-release-manager,
ops-deploy-pipeline, debug-mcp. Each with plugin.json, commands, agents,
skills, README, and claude-md-integration. Marketplace grows from 12→20.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-06 14:52:11 -05:00

2.6 KiB

name, description
name description
issue-conventions Issue title format, wiki references, and creation standards

Issue Conventions

Purpose

Defines standard formats for issue titles, bodies, and wiki references.

When to Use

  • Planner agent: When creating issues during sprint planning
  • Commands: /sprint plan

Title Format (MANDATORY)

[Sprint XX] <type>: <description>

Types

Type Use For
feat New feature
fix Bug fix
refactor Code refactoring
docs Documentation
test Test additions/changes
chore Maintenance tasks

Examples

  • [Sprint 17] feat: Add user email validation
  • [Sprint 17] fix: Resolve login timeout issue
  • [Sprint 18] refactor: Extract authentication module
  • [Sprint 18] test: Add JWT token edge case tests
  • [Sprint 19] docs: Update API documentation

Issue Body Structure

Every issue body MUST include:

## Description
[Clear description of the task]

## Implementation
**Wiki:** [Change VXX.X.X (Impl N)](wiki-link)

## Acceptance Criteria
- [ ] Criteria 1
- [ ] Criteria 2
- [ ] Criteria 3

## Technical Notes
[Optional: Architecture decisions, constraints, considerations]

Wiki Reference (MANDATORY)

Every issue MUST reference its implementation wiki page:

## Implementation
**Wiki:** [Change V4.1.0 (Impl 1)](https://gitea.example.com/org/repo/wiki/Change-V4.1.0%3A-Proposal-(Implementation-1))

This enables:

  • Traceability between issues and proposals
  • Context for the broader feature being implemented
  • Connection to lessons learned

Issue Creation Example

create_issue(
    repo="org/repo",
    title="[Sprint 17] feat: Implement JWT generation",
    body="""## Description
Create a JWT token generation service for user authentication.

## Implementation
**Wiki:** [Change V1.2.0 (Impl 1)](wiki-link)

## Acceptance Criteria
- [ ] Generate tokens with user_id, email, expiration
- [ ] Use HS256 algorithm
- [ ] Include token refresh logic
- [ ] Unit tests cover all paths

## Technical Notes
- Token expiration: 24 hours
- Refresh window: last 4 hours of validity
- See Sprint 12 lesson on token refresh edge cases
""",
    labels=["Type/Feature", "Priority/High", "Component/Auth", "Tech/Python", "Efforts/M"],
    milestone=17
)

Auto-Close Keywords

Use in commit messages to auto-close issues:

  • Closes #XX
  • Fixes #XX
  • Resolves #XX

Example commit:

feat: implement JWT token generation

- Add generate_token(user_id, email) function
- Add verify_token(token) function
- Include refresh logic per Sprint 12 lesson

Closes #45