// AReaL commit message conventions. MUST load on every git commit -- provides Conventional Commits format with scope inference from file paths.
| name | commit-conventions |
| description | AReaL commit message conventions. MUST load on every git commit -- provides Conventional Commits format with scope inference from file paths. |
Commit message conventions and scope inference rules for the AReaL repository.
ALWAYS load this skill when making any git commit in AReaL. This includes:
git commit)/create-pr)skills: ["commit-conventions"]<type>(<scope>): <subject>
<body>
[Optional sections:]
Key changes:
- change 1
- change 2
Refs: #123, #456
| Type | When to Use |
|---|---|
feat | New feature or capability |
fix | Bug fix |
docs | Documentation only |
gov | Governance or maintainer changes |
style | Formatting/style-only changes |
refactor | Code change without feature/fix |
perf | Performance improvement |
test | Adding or fixing tests |
build | Build system or dependencies |
ci | CI pipeline or workflow changes |
chore | Build, deps, config changes |
revert | Revert a previous commit |
Infer scope from the primary changed file paths:
| File Path Pattern | Scope |
|---|---|
areal/workflow/ | workflow |
areal/engine/ | engine |
areal/reward/ | reward |
areal/dataset/ | dataset |
areal/api/ | api |
areal/utils/ | utils |
areal/infra/ | infra |
areal/trainer/ | trainer |
areal/models/ | models |
areal/experimental/ | archon |
docs/ | docs |
examples/ | examples |
AGENTS.md, .agents/, .claude/, .codex/, .opencode/ | agents |
| Multiple areas | Omit scope or use broader term |
Single file fix:
fix(reward): handle empty completion in gsm8k
Return 0 reward instead of raising exception when
completion string is empty after extraction.
Multi-file feature:
feat(engine): add CPU offload support to ArchonEngine
Enable torch_memory_saver for model offloading during
rollout phase to reduce GPU memory pressure.
Key changes:
- Add offload/onload methods to ArchonEngine
- Integrate with weight update flow
- Handle ROCm compatibility
Docs only:
docs: update algorithm comparison table
Add SAPO and GSPO to the algorithm family documentation
with configuration examples.
Agent/tooling changes:
chore(agents): port review-pr command to OpenCode
Add OpenCode-native commands with task() category
delegation instead of hardcoded model names.
Key changes:
- Create .opencode/command/ with review-pr, create-pr
- Replace hardcoded model routing with platform-native review routing
- Add expert subagent consultation patterns
Governance/maintainer changes:
gov(agents): add maintainer ownership for service modules
Update CODEOWNERS and maintainer references to reflect
current governance responsibilities.
Key changes:
- Add maintainers for agent_service and infra ownership
- Align governance docs with updated reviewer responsibilities
AReaL commit message conventions. MUST load on every git commit -- provides Conventional Commits format with scope inference from file paths.
Upgrade focused runtime dependencies in AReaL. First validates and updates per-package API checklists for structural completeness, then updates pyproject files, resolves conflicts, locks, updates the Dockerfile, and audits API compatibility against the checklists.
AReaL commit message conventions. MUST load on every git commit -- provides Conventional Commits format with scope inference from file paths.
Read-only pull request review workflow with risk analysis, targeted checklists, and Codex subagent consultation.
Guide for adding a new model to the Archon engine. Use when user wants to add support for a new HuggingFace model architecture in ArchonEngine.
Guide for adding a new dataset loader to AReaL. Use when user wants to add a new dataset.