Skip to content

feat: add issue creation, status update commands, and shared references#19

Merged
schultzp2020 merged 9 commits into
mainfrom
feat/jira-creation-status-commands
May 7, 2026
Merged

feat: add issue creation, status update commands, and shared references#19
schultzp2020 merged 9 commits into
mainfrom
feat/jira-creation-status-commands

Conversation

@schultzp2020

Copy link
Copy Markdown
Collaborator

Summary

Adds 4 new sub-commands for issue creation and status tracking, plus 3 shared references and 9 asset files. The rhdh-jira skill now has 9 sub-commands covering the full Jira lifecycle.

New sub-commands

Command Description
to-feature Create RHDHPLAN Features with grill, duplicate check, Feature Request linking, and chained Epic decomposition
to-epic Create RHIDP Epics (chained from Feature or standalone), with chained Story/Task decomposition
to-issue Create Story/Task/Bug/Vulnerability/Spike with automatic type inference and support case routing
update-jira-status Detect related issue from session context, add status comment, propose transitions, upward cascade to parent Epic/Feature

New shared references

Reference Used by
duplicates.md All creation commands + refine Check 2
grill.md All creation commands — shared challenging behavior (sizing, completeness, scope, risks)
sizing.md grill.md — T-shirt sizing (Feature/Epic) and Fibonacci story points (Story/Task/RHDHSUPP)

New asset files

  • assets/templates/: feature.txt, epic.txt, story.txt, task.txt, bug.txt
  • assets/examples/: feature-example.txt, epic-example.txt, story-example.txt, bug-example.txt

Key design decisions

  • Chained decomposition: Feature → Epic → Issue with context carrying down. Grill narrows at each level.
  • Comments over description bloat: Template sections go in description. Decision trail, elaboration, abandoned approaches go in comments — agent proactively suggests.
  • Automatic duplicate check: Runs before every creation, no user prompt for the search itself.
  • Type inference: Story (user-facing), Task (internal), Bug (RHDHBUGS), Support Bug (RHDHSUPP), Vulnerability (RHIDP+Security), Spike (Task with SPIKE: prefix).
  • Upward cascade: update-jira-status checks sibling completion, suggests parent transitions, defers to Feature Owner. Checks if Jira automation already fired before suggesting.
  • Feature Request linking: to-feature searches for accepted Feature Requests that may have originated the work.

Updated files

  • SKILL.md — 9-command router, new conventions (closure rationale, comments over bloat)
  • templates.md — thin index pointing to assets/ files
  • refine.md — Check 2 now points to duplicates.md
  • command-metadata.json — 9 commands
  • README.md — all 9 sub-commands
  • skills/skill-maker/references/spec-guide.md — template + example pairs pattern

Reviewed by

  • Skills expert — spec compliance, architecture, reference independence, deduplication
  • Agile/Scrum expert — hierarchy alignment, grill thoroughness, type inference, cascade correctness

New sub-commands (4):
- to-feature: Create RHDHPLAN Features with grill, duplicate check,
  Feature Request linking, and chained Epic decomposition
- to-epic: Create RHIDP Epics with grill (chained or standalone),
  and chained Story/Task decomposition
- to-issue: Create Story/Task/Bug/Vulnerability/Spike with automatic
  type inference, support case routing, and time-boxed spikes
- update-jira-status: Detect related issue from session context,
  add status comment, propose transitions, check upward cascade
  to parent Epic/Feature with automation-awareness

New shared references (3):
- duplicates.md: Pre-creation and audit duplicate detection
- grill.md: Shared challenging behavior with applicability table
- sizing.md: T-shirt sizing and Fibonacci story points from RHDH guide

New asset files (9):
- assets/templates/: feature, epic, story, task, bug
- assets/examples/: feature, epic, story, bug

Updated: SKILL.md (9 commands), templates.md (thin index), refine.md,
command-metadata.json, README.md, skill-maker spec-guide.md
All 5 issue types now have template + example pairs:
feature, epic, story, task, bug.
The grill now infers Priority, Team, Size, Component, Assignee, and
Labels from the conversation context and presents all recommendations
at once for confirmation. No more form-filling — the agent proposes
values with rationale and the user adjusts.

Added Field Inference section to grill.md with inference signals table
and weak-inference handling. Updated to-feature, to-epic, and to-issue
to reference the inference pattern instead of listing fields to ask.
…rence

Creation commands now synthesize a draft from conversation context
first, present it for review, then grill only on gaps. The agent does
the work, the user corrects — not a form-filling exercise.

Added codebase-aware component inference to grill.md: checks git diff
for recently modified files and maps paths to RHIDP components
(plugins/catalog/ -> Catalog, charts/ -> Helm, etc.).
Replaced 1a/1b/1c/1d sub-step numbering with sequential Step 1
through Step N in all three creation commands.
1. Spike creation example: added --priority and --component flags
2. Feature cascade: require Release Pending/Closed (not Dev Complete)
3. Epic cascade: type-aware terminal status (Closed for Story/Task,
   Closed or Release Pending for Bug)
4. Comment suggestions: deduplicated in to-feature and to-epic,
   now pointer to grill.md like to-issue
5. Vulnerability: uses Story template+grill, added to applicability table
6. Cascade guard: skip if no parentIssue in Step 2 response
7. to-issue Step 3: simplified example file text
All three creation commands (to-feature, to-epic, to-issue) now render
the filled template + inferred fields as a temp markdown file for user
review before creating the Jira issue. User can approve, edit, or
cancel.
New section in architecture-patterns.md covering 4 patterns learned
from building the rhdh-jira creation commands:

- Draft-then-grill: synthesize from context first, ask about gaps only
- Field inference: propose metadata values with rationale, confirm at once
- Review gate with preview: temp file before mutation
- Chained decomposition: hierarchical creation with narrowing scope
Removed Jira-specific language from field inference and chained
decomposition patterns. Added cross-domain examples (design docs,
config files) so the patterns are useful for any skill that creates
structured artifacts.
@schultzp2020 schultzp2020 merged commit 7dbc808 into main May 7, 2026
4 checks passed
@schultzp2020 schultzp2020 deleted the feat/jira-creation-status-commands branch May 7, 2026 14:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant