gh-dhofheinz-open-plugins-plugins-git-commit-assistant/commands/atomic-commit/interactive-split.md

Operation: Interactive Split

Interactive guided workflow for splitting commits.

Parameters from $ARGUMENTS

• step:number - Start at specific step (default: 1)
• auto:true|false - Auto-advance through steps (default: false)

Workflow

This operation provides step-by-step guided experience through the entire atomic commit splitting process.

Step 1: Analyze Current Changes

Display:

🔍 STEP 1: ANALYZE CHANGES
─────────────────────────────────────

Analyzing your current changes...

Execute:

/atomic-commit analyze verbose:true

Parse results and show:

Current status:
  Files changed: 13
  Types detected: feat, fix, docs
  Scopes detected: auth, api
  Recommendation: Should split

Analysis:
  ⚠️  Multiple types detected (feat, fix, docs)
  ⚠️  Multiple scopes detected (auth, api)
  ✅ File count manageable (13 files)

Recommendation:
  Split into multiple atomic commits for:
  - Easier code review
  - Safer reverts
  - Clearer history

Prompt user:

Options:
  [1] Continue to grouping (recommended)
  [2] Review analysis details
  [3] Exit (keep as one commit)

Your choice:

Step 2: Group Files

Display:

📦 STEP 2: GROUP FILES
─────────────────────────────────────

How would you like to group files?

Show grouping strategies:

Strategies:
  [1] By type (feat, fix, docs)
      Best for: Mixed-type changes
      Groups: ~3 groups expected

  [2] By scope (auth, api, docs)
      Best for: Changes across modules
      Groups: ~3 groups expected

  [3] By feature (related functionality)
      Best for: Complex feature work
      Groups: ~2-4 groups expected

  [4] Auto-select (recommended)
      Let me choose the best strategy

Your choice:

Execute grouping:

/atomic-commit group strategy:<selected> show:all

Show results:

Groups created:

📦 Group 1: feat(auth) - 8 files
  Purpose: OAuth 2.0 implementation
  Files: src/auth/*, tests/auth/*
  Atomic: ✅ Yes

📦 Group 2: fix(api) - 3 files
  Purpose: Null pointer fix
  Files: src/api/*, tests/api/*
  Atomic: ✅ Yes

📦 Group 3: docs - 2 files
  Purpose: Authentication guide
  Files: README.md, docs/authentication.md
  Atomic: ✅ Yes

All groups are atomic: ✅ Yes

Prompt user:

Options:
  [1] Continue to commit suggestions
  [2] Adjust grouping
  [3] Try different strategy
  [4] Back to step 1

Your choice:

Step 3: Review Commit Suggestions

Display:

💬 STEP 3: COMMIT SUGGESTIONS
─────────────────────────────────────

Generating commit messages...

Execute:

/atomic-commit suggest format:conventional include_body:true

Show suggestions with review interface:

Commit 1 of 3:
┌─────────────────────────────────────────────┐
│ feat(auth): implement OAuth 2.0 auth        │
│                                             │
│ Add complete OAuth 2.0 authentication flow │
│ with support for multiple providers        │
│ (GitHub, Google). Includes token           │
│ management, refresh handling, and          │
│ comprehensive test coverage.               │
│                                             │
│ Files: 8                                    │
│ Atomic: ✅ Yes                              │
└─────────────────────────────────────────────┘

Options for this commit:
  [a] Accept as-is
  [e] Edit message
  [s] Skip this commit
  [v] View files in commit

Your choice:

If user edits, provide interface:

Edit commit message:

Subject (max 50 chars):
> feat(auth): implement OAuth 2.0 authentication

Body (optional):
> Add complete OAuth 2.0 authentication flow with
> support for multiple providers (GitHub, Google).
> Includes token management, refresh handling, and
> comprehensive test coverage.

Footer (optional):
>

[s] Save   [c] Cancel   [r] Reset

After reviewing all commits:

All commits reviewed:
  ✅ Commit 1: feat(auth) - Accepted
  ✅ Commit 2: fix(api) - Edited
  ✅ Commit 3: docs - Accepted

Options:
  [1] Continue to sequence planning
  [2] Review commits again
  [3] Back to grouping

Your choice:

Step 4: Create Commit Sequence

Display:

📋 STEP 4: COMMIT SEQUENCE
─────────────────────────────────────

Creating execution plan...

Execute:

/atomic-commit sequence output:plan

Show sequence:

Commit Order:

1️⃣ feat(auth) - 8 files
   Dependencies: None
   Can commit: ✅ Now

2️⃣ fix(api) - 3 files
   Dependencies: None
   Can commit: ✅ After commit 1

3️⃣ docs - 2 files
   Dependencies: Commit 1 (documents auth)
   Can commit: ✅ After commit 1

Execution time: ~3 minutes
All dependencies resolved: ✅ Yes

Prompt user:

Options:
  [1] Show execution commands
  [2] Generate script
  [3] Execute with guidance (recommended)
  [4] Let agent execute
  [5] Back to step 3

Your choice:

Step 5: Execute Commits

If user chooses guided execution:

🚀 STEP 5: EXECUTE COMMITS
─────────────────────────────────────

Executing commit 1 of 3...

┌─────────────────────────────────────────────┐
│ COMMIT 1: feat(auth)                        │
└─────────────────────────────────────────────┘

Staging files:
  ✅ src/auth/oauth.ts
  ✅ src/auth/tokens.ts
  ✅ src/auth/providers/github.ts
  ✅ src/auth/providers/google.ts
  ✅ src/config/oauth.config.ts
  ✅ src/types/auth.types.ts
  ✅ tests/auth/oauth.test.ts
  ✅ tests/auth/tokens.test.ts

Creating commit:
  Message: feat(auth): implement OAuth 2.0 authentication
  Files: 8
  Status: ✅ Success

Commit created: a1b2c3d

─────────────────────────────────────────────

Proceed to commit 2?
  [y] Yes, continue
  [r] Review what was just committed
  [p] Pause (save progress)
  [a] Abort remaining commits

Your choice:

Continue through all commits...

Final summary:

✨ COMPLETE: ALL COMMITS CREATED
─────────────────────────────────────

Summary:
  ✅ Commit 1: feat(auth) - a1b2c3d
  ✅ Commit 2: fix(api) - b2c3d4e
  ✅ Commit 3: docs - c3d4e5f

Total commits: 3
Total files: 13
Time elapsed: 2m 45s

Your git history is now atomic! 🎉

Next steps:
  • Review commits: git log -3
  • Push commits: git push
  • Create PR: gh pr create

Progress Tracking

The interactive workflow maintains state:

session:
  step: 1-5
  completed_steps: [list]
  current_groups: [...]
  current_suggestions: [...]
  current_sequence: [...]
  created_commits: [...]
  can_resume: true|false

Users can:

• Pause at any step
• Resume from where they left off
• Go back to previous steps
• Skip steps if desired

Navigation Commands

Throughout the interactive workflow:

• [n] Next
• [b] Back
• [h] Help
• [q] Quit
• [r] Restart
• [s] Status

Error Handling

During analysis:

• No changes detected → Guide to make changes first
• Git errors → Provide troubleshooting steps

During grouping:

• Cannot group files → Suggest manual review
• Grouping unclear → Offer alternative strategies

During suggestions:

• Cannot generate message → Provide template
• User unsure → Offer examples and guidance

During execution:

• Staging fails → Show file status and retry
• Commit fails → Preserve work, show error
• Partial completion → Save progress, allow resume

Auto Mode

When auto:true is specified:

• Automatically selects recommended options
• Shows results at each step
• Pauses for user confirmation at commit execution
• Useful for experienced users who trust recommendations

Example:

/atomic-commit interactive auto:true
→ Analyzes → Groups by best strategy → Suggests → Creates sequence → Waits for confirmation

Resume Capability

If interrupted, users can resume:

/atomic-commit interactive step:3
→ Resumes from step 3 (commit suggestions)

Session data is preserved across invocations.

Help System

At any point, user can type [h] for context-sensitive help:

📚 HELP - Step 2: Grouping
─────────────────────────────────────

Grouping strategies:
  • Type: Groups by commit type (feat, fix, docs)
  • Scope: Groups by module (auth, api, ui)
  • Feature: Groups by related functionality

Tips:
  • Choose "type" for mixed-type changes
  • Choose "scope" for module-based work
  • Choose "feature" for complex features
  • Choose "auto" if unsure

Examples:
  Type grouping: feat files | fix files | docs files
  Scope grouping: auth files | api files | ui files

Press any key to continue...

Output Format

The interactive workflow uses:

• Clear step indicators
• Progress tracking
• Visual separators
• Emoji for status
• Color coding (if supported)
• Consistent option menus
• Helpful prompts

Examples

Example 1: Full interactive workflow

/atomic-commit interactive
→ Guides through all steps with prompts

Example 2: Auto mode

/atomic-commit interactive auto:true
→ Auto-selects best options, confirms before execution

Example 3: Resume from step

/atomic-commit interactive step:3
→ Resumes from commit suggestions step

Integration with Agent

The commit-assistant agent can:

1. Recommend interactive mode for complex splits
2. Guide users through steps
3. Answer questions during workflow
4. Explain recommendations
5. Execute commits on behalf of user (with approval)

The interactive workflow provides the best user experience for learning atomic commit practices.