Start Feature Command

Command

/start

Description

Automates the boilerplate of starting a new feature: creates a GitHub issue for tracking, checks out a properly named feature branch, and opens a draft PR linked to the issue. Gets you from idea to coding in under 30 seconds.

Behavior

Arguments

• $ARGUMENTS -- Feature description (e.g., "add dark mode toggle to settings page")

Steps

1. Parse the feature description and generate:

   • Issue title (concise, descriptive)
   • Branch name (kebab-case with prefix)
   • PR title (conventional commit style)

2. Create GitHub issue:

   Copy
   gh issue create \
     --title "feat: Add dark mode toggle to settings page" \
     --body "## Description
   Add a dark mode toggle to the user settings page.
   
   ## Acceptance Criteria
   - [ ] Toggle switch in settings
   - [ ] Persists preference to localStorage
   - [ ] Applies dark theme across all pages
   - [ ] Respects system preference as default
   
   ## Technical Notes
   - Use CSS custom properties for theme colors
   - Add prefers-color-scheme media query support"

3. Create feature branch:

   Copy
   git fetch origin
   git checkout -b feat/add-dark-mode-toggle origin/main

4. Create initial commit (empty, to establish the branch):

   Copy
   git commit --allow-empty -m "feat: start dark mode toggle implementation
   
   Closes #<issue-number>"
   git push -u origin feat/add-dark-mode-toggle

5. Create draft PR:

   Copy
   gh pr create \
     --title "feat: add dark mode toggle to settings page" \
     --body "Closes #<issue-number>
   
   ## Summary
   Add dark mode support with a toggle in user settings.
   
   ## Changes
   - [ ] Settings page toggle component
   - [ ] Theme provider with CSS custom properties
   - [ ] localStorage persistence
   - [ ] System preference detection
   
   ## Testing
   - [ ] Toggle switches themes correctly
   - [ ] Preference persists across page reloads
   - [ ] Respects system dark mode preference" \
     --draft

6. Output summary:

   Copy
   ## Feature Started
   
   - Issue: #142 (https://github.com/you/repo/issues/142)
   - Branch: feat/add-dark-mode-toggle
   - Draft PR: #143 (https://github.com/you/repo/pull/143)
   
   You're on branch `feat/add-dark-mode-toggle`. Start coding!

Output Format

A summary with links to the created issue, branch name, and draft PR URL.

Examples

Copy
# Start a new feature
/start add dark mode toggle to settings page

# Start a bugfix
/start fix login redirect loop for OAuth users

# Start a refactoring task
/start refactor payment service to use strategy pattern