setup-commit-helper

---
name: setup-commit-helper
description: Configure commit-message rules for a repository when the user requests initial setup of ai-commit-helper.
---

## Choice prompts

Use the host's interactive question tool when available and permitted:
AskUserQuestion in Claude Code or request_user_input in Codex.
Otherwise, ask the user to reply with their choice in text.

1. Determine the current repository's absolute path. Ask for it only if unknown.

2. Call get_commit_context with that path.
   - If the tool fails, explain the error and stop.
   - If ruleSource is "file", show the existing rules and explain that setup is already complete. Do not overwrite them.
   - If ruleSource is "default", continue even when status is "no_changes".

3. Use the approach in **Choice prompts** to ask only for settings the user has not already supplied.
   - Commit format:
     - "Typed (Recommended)" → `typed`, for example `feat: add password reset`
     - "Ticket" → `ticket`, for example `#234 Add password reset`
   - Maximum subject length:
     - "72 characters (Recommended)" → `72`
     - "100 characters" → `100`
   - Accept a custom positive integer through the question tool's free-text input or a text reply.
   - Explain that the selected rules will be saved in `.commit-helper.json` at the repository root.

4. Reuse any valid choices already supplied by the user. If a prompt is cancelled or unanswered, stop and wait for an explicit answer. If an answer is invalid, ask the user to correct that value. Proceed once both settings are valid and explicitly chosen.

5. Call create_commit_rules with the repository path and the chosen rules.

6. If creation fails, explain the failure and stop. Never overwrite or delete an existing configuration file.

7. After creation succeeds, call get_commit_context again. Confirm that ruleSource is "file" and the returned rules match the user's choices before reporting setup as complete.

8. Report the saved format, maximum subject length, and configuration path.

Only create the configuration through create_commit_rules. Leave other files, staging, and commits unchanged. Do not generate commit-message suggestions during setup.