improvement: refine github-issue-planning sample workflow by breaking-brake · Pull Request #733 · breaking-brake/cc-wf-studio

breaking-brake · Apr 12, 2026

Summary

Refine the bundled github-issue-planning-en sample workflow to improve subAgent output quality, verification clarity, and the reproduction branch UX. Also adds a repo-wide Language rule and removes an unused skill.

Closes #732

What Changed

Before

SubAgent prompts described what to do but not how to format the result, producing inconsistent outputs downstream.
prompt-1 (Verify Results) was abstract ("verify in your local environment") with no concrete steps.
ask-reproduce-result had only 2 options and looped back to ask-reproduce when the user selected "Not reproduced", creating a repetitive UX with no forward path.
No documented rule on which language to use for GitHub Issues and PRs.
update-sample-workflow skill was no longer in use.

After

5 subAgent prompts (agent-file-investigation, agent-solution-design, agent-2, agent-3, agent-retrospective) now include a Required Output Format section with explicit structure.
prompt-1 is restructured into 4 concrete steps: review with git diff → run project verification commands → verification checklist → proceed.
ask-reproduce-result now has 3 options: Reproduced, Unable to reproduce, proceed, Need more info. The "Need more info" path ends the workflow via a new prompt-need-more-info node that guides the user to request additional info on the GitHub issue.
CLAUDE.md now requires English for all GitHub Issues and PRs regardless of conversation language.
update-sample-workflow skill removed.

Changes

CLAUDE.md — Add ## Language section requiring English for Issues/PRs
resources/samples/github-issue-planning-sample.json — Refine 5 subAgent prompts, restructure prompt-1, expand ask-reproduce-result to 3 options, add prompt-need-more-info node, rewire group-3 connections, expand group-3 height
.claude/skills/update-sample-workflow/SKILL.md — Remove (unused)
.claude/skills/update-sample-workflow/scripts/update_sample.py — Remove (unused)

Testing

Manual E2E testing completed (dogfooded on improvement: refine github-issue-planning-en sample workflow #732 in a separate session before applying to the bundled sample)
Sample workflow loads correctly in CC Workflow Studio
All connections validated (no disconnected branches, no loops)

🤖 Generated with Claude Code

Summary by CodeRabbit

Chores
- Removed internal skill documentation and scripts.
Documentation
- Added language requirement: all GitHub Issues and Pull Requests must be written in English.
New Features
- Enhanced GitHub issue planning workflow with improved decision branching and refined analysis prompts for better issue handling.

- Require English for all GitHub Issue and PR titles, bodies, and comments - Applies regardless of conversation language used with Claude Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

- Add required output format sections to 5 subAgent prompts - Restructure prompt-1 (Verify Results) into 4 concrete steps - Expand ask-reproduce-result to 3 options with prompt-need-more-info node - Remove repetitive loopback from "Not reproduced" branch Refs #732 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

- Remove SKILL.md and scripts/update_sample.py - Skill is no longer needed in the current workflow Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

coderabbitai · Apr 12, 2026

Caution

Review failed

Pull request was closed or merged during review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 18a1f655-9410-41ec-8e66-051a5d662366

📥 Commits

Reviewing files that changed from the base of the PR and between 0b4138a and 30e73f2.

📒 Files selected for processing (4)

.claude/skills/update-sample-workflow/SKILL.md
.claude/skills/update-sample-workflow/scripts/update_sample.py
CLAUDE.md
resources/samples/github-issue-planning-sample.json

💤 Files with no reviewable changes (2)

.claude/skills/update-sample-workflow/SKILL.md
.claude/skills/update-sample-workflow/scripts/update_sample.py

📝 Walkthrough

Walkthrough

Deleted the "update-sample-workflow" skill documentation and script, updated the github-issue-planning sample workflow JSON to refine subagent output formats and improve the "cannot reproduce" branching path, and added a language requirement to CLAUDE.md for GitHub Issues and Pull Requests.

Changes

Cohort / File(s)	Summary
Update-sample-workflow Skill Removal `.claude/skills/update-sample-workflow/SKILL.md`, `.claude/skills/update-sample-workflow/scripts/update_sample.py`	Deleted documentation and Python script that previously automated sample workflow updates and validations.
GitHub Issue Planning Workflow Refinement `resources/samples/github-issue-planning-sample.json`	Updated workflow metadata (`nodeCount`, `id`, timestamps), refined subagent prompts to define explicit output formats (file investigation, solution design, code implementation), improved verification step structure, and expanded "cannot reproduce" branching from 2 to 3 options with new "need more info" path and dedicated prompt node.
Language Requirement Documentation `CLAUDE.md`	Added requirement that all GitHub Issues and Pull Requests (titles, bodies, comments) be written in English.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

Suggested labels

released

Poem

🐰 The workflow hops to a brighter refrain,
With prompts now crisp, output formats plain,
Three paths when stumped (instead of one loop),
And English words keep the discourse in group!
Old skills rest well, new clarity reigns. ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Out of Scope Changes check	❓ Inconclusive	The removal of the unused skill .claude/skills/update-sample-workflow and addition of the Language rule to CLAUDE.md are tangentially related but not explicitly required by `#732` objectives.	Clarify whether removing the unused skill and adding the Language section were necessary supporting changes or should be separated into a distinct PR.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'improvement: refine github-issue-planning sample workflow' is concise and clearly summarizes the main change (refining a bundled sample workflow to improve subAgent output and UX).
Linked Issues check	✅ Passed	The PR fully implements all three coding objectives from `#732`: added explicit output formats to five subAgent prompts, restructured prompt-1 verification into four concrete steps, expanded ask-reproduce-result to three options with a new prompt-need-more-info node, and updated all sample JSON to reflect these changes.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch improvement/refine-github-issue-planning-sample

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

## [3.33.0](v3.32.2...v3.33.0) (2026-04-12) ### Features * add sample workflow feature with tour integration ([#719](#719)) ([aaf2ab1](aaf2ab1)) * enhance StartMenu with version display and recent workflows ([#731](#731)) ([0b4138a](0b4138a)) * redesign onboarding tour and add empty state ([#723](#723)) ([8f72a24](8f72a24)) ### Bug Fixes * update broken Frontmatter Reference links in all languages ([#725](#725)) ([642b9ab](642b9ab)) ### Improvements * allow edge selection inside group nodes and animate on select ([#724](#724)) ([a813d49](a813d49)) * refine github-issue-planning sample workflow ([#733](#733)) ([7c1473b](7c1473b)), closes [#732](#732) * use fixed MCP server port with user-configurable setting ([#722](#722)) ([d436d2e](d436d2e)) ### Documentation * update README hero section with catchphrase and deck link ([#721](#721)) ([ba6aa52](ba6aa52))

braking-brake-semantic-release · Apr 12, 2026

🎉 This PR is included in version 3.33.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

breaking-brake and others added 3 commits April 12, 2026 23:45

chore: add Language rule for GitHub Issues and PRs

32f752b

- Require English for all GitHub Issue and PR titles, bodies, and comments - Applies regardless of conversation language used with Claude Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

chore: remove update-sample-workflow skill

30e73f2

- Remove SKILL.md and scripts/update_sample.py - Skill is no longer needed in the current workflow Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

breaking-brake merged commit 7c1473b into main Apr 12, 2026
1 of 2 checks passed

breaking-brake deleted the improvement/refine-github-issue-planning-sample branch April 12, 2026 14:49

breaking-brake mentioned this pull request Apr 12, 2026

Release: v3.33.0 #734

Merged

braking-brake-semantic-release Bot added the released label Apr 12, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

improvement: refine github-issue-planning sample workflow#733

improvement: refine github-issue-planning sample workflow#733
breaking-brake merged 3 commits intomainbreaking-brake/cc-wf-studio:mainfrom
improvement/refine-github-issue-planning-samplebreaking-brake/cc-wf-studio:improvement/refine-github-issue-planning-sampleCopy head branch name to clipboard

breaking-brake commented Apr 12, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

coderabbitai Bot commented Apr 12, 2026 •

edited

Loading

Review failed

Walkthrough

Changes

Estimated code review effort

Suggested labels

Poem

❌ Failed checks (1 inconclusive)

Uh oh!

Uh oh!

braking-brake-semantic-release Bot commented Apr 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Search code, repositories, users, issues, pull requests...

Conversation

breaking-brake commented Apr 12, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

What Changed

Before

After

Changes

Testing

Summary by CodeRabbit

Uh oh!

coderabbitai Bot commented Apr 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review failed

Walkthrough

Changes

Estimated code review effort

Suggested labels

Poem

❌ Failed checks (1 inconclusive)

Uh oh!

Uh oh!

braking-brake-semantic-release Bot commented Apr 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

breaking-brake commented Apr 12, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Apr 12, 2026 •

edited

Loading