| name | commit-message |
| description | Create properly formatted conventional commit messages for manual-approval-gate. Use when asked to "create a commit", "generate commit message", "commit changes", or "make a commit". Applies component scopes, line length validation, DCO Signed-off-by, and Assisted-by trailers. |
| license | Apache-2.0 |
| metadata | {"project":"manual-approval-gate","allowed-tools":"Read Grep Glob Bash(git diff:*) Bash(git log:*) Bash(git status)"} |
Conventional Commit Message Creation
Create properly formatted conventional commit messages following Tekton
community standards with line length validation and required trailers.
Format
<type>(<scope>): <description>
[optional body]
Signed-off-by: <name> <email>
Assisted-by: <model> (via <tool>)
Workflow
- Analyze changes: Run
git status and git diff --staged to understand modifications
- Determine type and scope: See tables below
- Generate message: Subject line ≤72 chars, body wrapped at 72 chars
- Add trailers: Signed-off-by (from git config) and Assisted-by
- Confirm with user: Display message and wait for approval before committing
CRITICAL: Never commit without explicit user confirmation.
Type Selection
| Type | When to use |
|---|
feat | New features or capabilities |
fix | Bug fixes |
docs | Documentation only |
refactor | Code restructuring without behavior change |
test | Adding or updating tests |
chore | Maintenance (deps, CI, build) |
build | Build system or tooling changes (go version, Makefile) |
ci | Changes to .github/workflows/ or .tekton/ directory |
Scope Selection
Use the affected component as scope:
| Scope | When |
|---|
controller | Changes to pkg/reconciler/approvaltask/ or cmd/controller/ |
webhook | Changes to pkg/reconciler/webhook/ or cmd/webhook/ |
cli | Changes to pkg/cli/ or cmd/tkn-approvaltask/ |
api | Changes to pkg/apis/ |
config | Changes to config/kubernetes/ or config/openshift/ |
e2e | Changes to test/ |
deps | Dependency updates |
Line Length Rules
- Subject: ≤72 characters (includes
type(scope): )
- Body: wrap at 72 characters per line
- Blank line required between subject and body
Required Trailers
Signed-off-by
Detect from git config:
git config user.name
git config user.email
Format: Signed-off-by: Name <email>
Assisted-by
Always include when AI assisted: Assisted-by: <model> (via <tool>)
Commit Execution
Use heredoc for proper multi-line handling:
git commit -m "$(cat <<'EOF'
type(scope): subject line
Body text wrapped at 72 characters.
Signed-off-by: Name <email>
Assisted-by: Model (via Tool)
EOF
)"
