Add Claude Code slash commands for GitHub issue workflow by sasamuku · Pull Request #3741 · liam-hq/liam

sasamuku · 2025-10-10T06:57:50Z

Issue

resolve: N/A (developer productivity improvement)

Why is this change needed?

This PR adds two new Claude Code slash commands to streamline GitHub issue handling workflow:

Commands Added

/read-issue - Fetches and analyzes a GitHub issue
- Uses gh issue view to fetch issue details
- Searches codebase for relevant context
- Presents issue information in a readable format
/fix-issue - Complete issue resolution workflow
- Fetches issue details
- Implements necessary changes
- Runs tests and verification
- Ensures code passes linting

Benefits

Faster issue triage and investigation
Consistent workflow for issue resolution
Automated context gathering from codebase
Reduces manual steps in the development process

🤖 Generated with Claude Code

Summary by CodeRabbit

Documentation
- Added guides for reading and fixing GitHub issues via the CLI. Includes instructions for parsing issue numbers (e.g., Fix error in the license_finder job in the merge queue #123 or 123), using gh issue view to fetch details, understanding issues, locating relevant code, and presenting context.
- Provides a step-by-step workflow for implementing fixes: searching code, applying changes, adding tests, running linting and type checks, and crafting descriptive commit messages.

Add two new slash commands to streamline GitHub issue handling: - /read-issue: Fetches and analyzes a GitHub issue - /fix-issue: Fetches issue, implements fix, and verifies completion These commands use gh CLI to fetch issue details and guide the implementation process. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>

giselles-ai · 2025-10-10T06:57:54Z

Unexpected error on running flow

Step	Status	Updated(UTC)
1	✅	Oct 10, 2025 6:57am
2	✅	Oct 10, 2025 6:59am
3	❌	Oct 10, 2025 6:59am

vercel · 2025-10-10T06:57:56Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
liam-app	Ready	Preview	Comment	Oct 10, 2025 7:00am
liam-assets	Ready	Preview	Comment	Oct 10, 2025 7:00am
liam-erd-sample	Ready	Preview	Comment	Oct 10, 2025 7:00am
liam-storybook	Ready	Preview	Comment	Oct 10, 2025 7:00am

1 Skipped Deployment

Project	Deployment	Preview	Comments	Updated (UTC)
liam-docs	Ignored			Oct 10, 2025 7:00am

supabase · 2025-10-10T06:58:04Z

Updates to Preview Branch (add_claude_command) ↗︎

Deployments	Status	Updated
Database	✅	Fri, 10 Oct 2025 07:00:52 UTC
Services	✅	Fri, 10 Oct 2025 07:00:52 UTC
APIs	✅	Fri, 10 Oct 2025 07:00:52 UTC

Tasks are run on every commit but only new migration files are pushed.
Close and reopen this PR if you want to apply changes from existing seed or migration files.

Tasks	Status	Updated
Configurations	✅	Fri, 10 Oct 2025 07:00:57 UTC
Migrations	✅	Fri, 10 Oct 2025 07:01:04 UTC
Seeding	✅	Fri, 10 Oct 2025 07:01:04 UTC
Edge Functions	✅	Fri, 10 Oct 2025 07:01:04 UTC

View logs for this Workflow Run ↗︎.
Learn more about Supabase for Git ↗︎.

coderabbitai · 2025-10-10T06:58:30Z

Walkthrough

Adds two new Markdown command guides under .claude/commands: read-issue.md and fix-issue.md. They define CLI workflows using gh to parse an issue number, view details, identify related code, implement fixes, write/run tests, and run lint/type checks with pnpm.

Changes

Cohort / File(s)	Summary
Claude CLI workflows docs `\.claude/commands/read-issue.md`, `\.claude/commands/fix-issue.md`	New task-oriented docs detailing gh-based issue retrieval, issue-number parsing (supports `#123` or `123`), steps to analyze code, apply fixes, add tests, and validate via `pnpm lint` and type checks; includes guidance for commit messages.

Sequence Diagram(s)

sequenceDiagram
  autonumber
  actor Dev as Developer
  participant CLI as Terminal
  participant GH as gh CLI
  participant Repo as Codebase

  Note over Dev,CLI: Read Issue Workflow
  Dev->>CLI: read-issue <issue-id>
  CLI->>CLI: Parse issue number (#123 or 123)
  CLI->>GH: gh issue view <issue-number>
  GH-->>CLI: Issue details (title, body, labels)
  CLI->>Repo: Search related files/contexts
  Repo-->>CLI: Matches/snippets
  CLI-->>Dev: Present issue + code context

sequenceDiagram
  autonumber
  actor Dev as Developer
  participant CLI as Terminal
  participant GH as gh CLI
  participant Repo as Codebase
  participant Tests as Test Runner

  Note over Dev,CLI: Fix Issue Workflow
  Dev->>CLI: fix-issue <issue-id>
  CLI->>CLI: Extract issue number
  CLI->>GH: gh issue view <issue-number>
  GH-->>CLI: Issue details
  CLI->>Repo: Locate related code
  Dev->>Repo: Implement changes
  Dev->>Tests: Run tests
  Tests-->>Dev: Results (pass/fail)
  Dev->>CLI: Run lint/type checks (pnpm lint, etc.)
  CLI-->>Dev: Validation results
  Dev->>Repo: Commit with descriptive message

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested labels

Review effort 2/5

Suggested reviewers

FunamaYukina
junkisai
NoritakaIkeda
MH4GF

Poem

A nibble of issues, a hop through the CLI,
I parse little numbers as they scurry by.
I fetch, I fix, with linting delight—
Tests all passing, oh what a sight!
Thump-thump commits, carrots held high 🥕
Bugs be gone—swift rabbit, bye!

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title Check	✅ Passed	The title succinctly and accurately describes the primary change by stating that Claude Code slash commands for GitHub issue workflows are being added, making it clear and specific to the main purpose of the pull request.
Description Check	✅ Passed	The pull request description includes the required “## Issue” section with a resolve entry and the “## Why is this change needed?” section with a clear rationale, aligning with the repository’s template while providing additional useful details.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

✨ Finishing touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment
Commit unit tests in branch add_claude_command

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d8b51da and 5cb46f5.

📒 Files selected for processing (2)

.claude/commands/fix-issue.md (1 hunks)
.claude/commands/read-issue.md (1 hunks)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)

GitHub Check: security-review
GitHub Check: Supabase Preview

🔇 Additional comments (2)

.claude/commands/read-issue.md (1)

5-17: Clear and actionable workflow.

The step-by-step guidance for fetching and summarizing issues is concise and accurate—this will be easy to follow.

.claude/commands/fix-issue.md (1)

5-20: Comprehensive fix flow.

Great coverage of analysis, implementation, validation, and commit messaging—this sets clear expectations for resolving issues.

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.}

giselles-ai · 2025-10-10T06:59:05Z

Check changeset necessity

Status: NOT REQUIRED

Reason:

Changes only add developer tooling files under .claude/commands (read-issue.md, fix-issue.md) and do not modify any published packages
No changes to target packages: @liam-hq/cli, @liam-hq/erd-core, @liam-hq/schema, or @liam-hq/ui
Non–user-facing change: documentation/workflow automation for contributors; no API, feature, or behavior changes in distributed packages
Fits “Development tooling changes” category in the guide, which does not require a changeset

Changeset (copy & paste):

# No changeset required for this PR (development tooling only)

MH4GF

GOGO 🚀

github-actions Bot assigned sasamuku Oct 10, 2025

vercel Bot deployed to Preview – liam-app October 10, 2025 07:00 View deployment

sasamuku marked this pull request as ready for review October 10, 2025 07:01

sasamuku requested a review from a team as a code owner October 10, 2025 07:01

sasamuku requested review from MH4GF, NoritakaIkeda and junkisai and removed request for a team October 10, 2025 07:01

MH4GF approved these changes Oct 10, 2025

View reviewed changes

MH4GF added this pull request to the merge queue Oct 10, 2025

Merged via the queue into main with commit 161d8c8 Oct 10, 2025
31 checks passed

MH4GF deleted the add_claude_command branch October 10, 2025 07:44

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add Claude Code slash commands for GitHub issue workflow#3741

Add Claude Code slash commands for GitHub issue workflow#3741
MH4GF merged 1 commit into
mainfrom
add_claude_command

sasamuku commented Oct 10, 2025 •

edited by coderabbitai Bot

Loading

Uh oh!

giselles-ai Bot commented Oct 10, 2025 •

edited

Loading

Uh oh!

vercel Bot commented Oct 10, 2025 •

edited

Loading

Uh oh!

supabase Bot commented Oct 10, 2025 •

edited

Loading

Uh oh!

coderabbitai Bot commented Oct 10, 2025 •

edited

Loading

Uh oh!

giselles-ai Bot commented Oct 10, 2025

Uh oh!

MH4GF left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

sasamuku commented Oct 10, 2025 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Issue

Why is this change needed?

Commands Added

Benefits

Summary by CodeRabbit

Uh oh!

giselles-ai Bot commented Oct 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel Bot commented Oct 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

supabase Bot commented Oct 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented Oct 10, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Sequence Diagram(s)

Estimated code review effort

Suggested labels

Suggested reviewers

Poem

Pre-merge checks and finishing touches

Uh oh!

giselles-ai Bot commented Oct 10, 2025

Check changeset necessity

Reason:

Changeset (copy & paste):

Uh oh!

MH4GF left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

sasamuku commented Oct 10, 2025 •

edited by coderabbitai Bot

Loading

giselles-ai Bot commented Oct 10, 2025 •

edited

Loading

vercel Bot commented Oct 10, 2025 •

edited

Loading

supabase Bot commented Oct 10, 2025 •

edited

Loading

coderabbitai Bot commented Oct 10, 2025 •

edited

Loading