القائمة
Enforces conventional commit format with atomic changes and co-author attribution. Used when committing code changes to maintain consistent git history.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Evidence-based verification with 2 quality gates (pre-check and post-check), anti-rationalization enforcement, and 3-step retry escalation. Used when completing tasks, verifying implementations, or before claiming work is done.
Routes work through MaxsimCLI commands based on project state and user intent. Provides command reference and decision routing table. Used when determining which MaxsimCLI command to use or when starting a new session.
Coordinates Tier 2 Agent Teams with TeamCreate, SendMessage, competitive implementation, multi-reviewer code review, and collaborative debugging patterns. Used when workflows require inter-agent communication, adversarial debate, or shared task lists.
Autonomous optimization loop with reference workflows. Powers /maxsim:improve, /maxsim:fix-loop, /maxsim:debug-loop, /maxsim:security. Used when running autonomous optimization, error repair, bug hunting, or security audit loops.
GitHub-native persistence for project learnings, decisions, and patterns using issue labels and structured comments. Used when recording what worked, what failed, or architectural decisions that should persist across sessions.
Orchestrates parallel agent execution using worktree isolation following Anthropic's batch pattern. Used when multiple independent tasks can be executed simultaneously.
| name | commit-conventions |
| description | Enforces conventional commit format with atomic changes and co-author attribution. Used when committing code changes to maintain consistent git history. |
| user-invocable | false |
Consistent commit messages enable automated versioning, changelogs, and clear project history. Every commit follows this format.
type(scope): description
- key change 1
- key change 2
Co-Authored-By: Claude <noreply@anthropic.com>
Subject line under 72 characters. Body bullet points are optional for trivial commits. Co-author line always present for AI-assisted work.
| Type | When to Use | Version Impact |
|---|---|---|
feat | New feature or capability | Minor bump |
fix | Bug fix | Patch bump |
refactor | Code restructure with no behavior change | No bump |
test | Adding or correcting tests | No bump |
docs | Documentation only | No bump |
chore | Build, deps, config, tooling, maintenance | No bump |
style | Formatting, whitespace, no logic change | No bump |
perf | Performance improvement | No bump |
ci | CI/CD pipeline changes | No bump |
Append ! after the type for breaking changes:
feat!(api): require authentication on all endpoints
fix!(config): rename model_profile to profile
Breaking changes trigger a major version bump. Always explain what breaks and the migration path in the commit body.
Scope identifies the affected area:
fix(install):, refactor(core):feat(dashboard):, test(cli):feat(04-01):, fix(phase-04):Scope is required when the change is not project-wide.
One logical change per commit. The diff and message should describe a single coherent unit of work.
Do:
Do not:
All AI-assisted commits include the co-author line:
Co-Authored-By: Claude <noreply@anthropic.com>
Note: The co-author name is configured via the automation.co_author config key (query with maxsim-tools config-get automation.co_author). It can also be overridden in the project's CLAUDE.md.
| Mistake | Correct Approach |
|---|---|
fix: fixed stuff | fix(auth): handle expired token on refresh |
update things | Missing type prefix entirely -- add chore: or appropriate type |
feat: add feature and also fix bug | Two commits: one feat, one fix |
WIP | Never commit WIP to main; finish the unit of work |
| Past tense: "added validation" | Imperative mood: "add validation" |
feat(api): add rate limiting to public endpoints
- Default: 100 requests per minute per IP
- Configurable via RATE_LIMIT_RPM env var
- Returns 429 with Retry-After header
Co-Authored-By: Claude <noreply@anthropic.com>
fix(install): resolve path resolution failure on Windows
Co-Authored-By: Claude <noreply@anthropic.com>