feat: add rhdh-release skill for release management (v0.4.0)#43
Draft
durandom wants to merge 5 commits into
Draft
feat: add rhdh-release skill for release management (v0.4.0)#43durandom wants to merge 5 commits into
durandom wants to merge 5 commits into
Conversation
Migrate the Release Manager from the Agno/LiteLLM agent into a Claude Code skill. Dissolves the Google Sheets workbook into version-controlled markdown files: 12 JQL templates, 4 Slack announcement templates, 13 workflows, and a release process reference. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…se-process.md Removed Jira Projects, Key Dashboards, and Key Documents sections (all duplicated in release-process.md). Added cross-reference pointer. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Three instruction-driven test files split by dependency tier: - check-structural.md: filesystem-only (no external deps) - check-jira.md: requires acli/Jira access - check-gsheets.md: requires gcloud/GSheets access Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…ed_to_release - Add <success_criteria> sections to all workflows (matches overlay skill convention) - Reference features_added_to_release JQL in release-status.md gotchas for scope tracking - Both issues found by check-structural.md smoke test Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add `release.py` CLI with 14 subcommands that extract deterministic work
(counting, URL-encoding, template filling) from agent workflows. The agent
calls the CLI first and adds judgment on top.
New scripts:
- release.py — argparse CLI: check, dates, future-dates, status, teams,
team-breakdown, blockers, epics, cves, notes, slack {feature-freeze-update,
feature-freeze, code-freeze-update, code-freeze}
- jql.py — parse 12 JQL templates from jql-release.md at runtime
- slack_templates.py — parse 4 Slack templates from slack-templates.md
- formatters.py — symlink to shared OutputFormatter
Updated:
- SKILL.md routing table: CLI command as primary, workflow as fallback
- All 13 workflows: Step 1 Run CLI added, manual steps kept as fallback
- check-structural.md: CLI existence check added (check 10)
Tests: 34 new unit tests for jql parsing, slack templates, CLI arg parsing,
acli count parsing. Showboat demo at tests/demo-release-cli.md.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
rhdh-releaseskill that migrates the Release Manager from the Agno/LiteLLM agent into a Claude Code skillrhdhorchestrator with routing for release-related queriesfetch_team_mapping.pyscript for Google Sheets team data (reusesgcloud_token.pyandcheck_gsheets.pyvia symlinks)releaseCLI (scripts/release.py) with 14 subcommands for deterministic data gathering — the agent calls the CLI first and adds judgment on topRelease CLI (
scripts/release.py)Extracts deterministic work (counting, URL-encoding, template filling) from agent workflows. 14 subcommands:
release checkrelease datesrelease future-dates VERSIONrelease status VERSIONrelease teams [--category CAT]release team-breakdown VERSIONrelease blockers VERSIONrelease epics VERSIONrelease cves VERSIONrelease notes VERSIONrelease slack feature-freeze-update VERSIONrelease slack feature-freeze VERSIONrelease slack code-freeze-update VERSIONrelease slack code-freeze VERSIONGlobal flags:
--json/--human/--verboseSupporting modules:
jql.py— parses 12 JQL templates fromjql-release.mdat runtime (single source of truth)slack_templates.py— parses 4 Slack templates fromslack-templates.mdformatters.py→ symlink to sharedOutputFormatter(auto-detects TTY vs piped)All 13 workflows updated with "Step 1: Run CLI" as primary path, manual steps kept as fallback.
Test plan
uv run pytest tests/unit/test_release_cli.pyuv run pytest)tests/demo-release-cli.md— reproducible viauvx showboat verifypython scripts/release.py checkthenpython scripts/release.py status 1.9.0python scripts/release.py teams --json/rhdhand verify "Release Management" appears in the menu🤖 Generated with Claude Code