Skip to content

Commit 062164f

Browse files
committed
docs(agents): clarify automation and title conventions
1 parent 9e0476b commit 062164f

1 file changed

Lines changed: 8 additions & 1 deletion

File tree

AGENTS.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -125,6 +125,7 @@ cd ../agentv.worktrees/<type>-<short-desc>
125125
- If something goes sideways, STOP and re-plan immediately — don't keep pushing a broken approach.
126126
- For non-trivial changes, pause and ask: "Is there a more elegant solution?" before diving in.
127127
- Check in with the user before starting implementation on ambiguous tasks.
128+
- Prefer automation: execute the requested work without extra confirmation unless blocked by missing information, safety concerns, or an irreversible/destructive action the user has not approved.
128129

129130
### Subagent Strategy
130131
- Use subagents aggressively to keep the main context window clean.
@@ -146,6 +147,13 @@ cd ../agentv.worktrees/<type>-<short-desc>
146147
### Progress Updates
147148
- Provide high-level status updates at natural milestones.
148149
- When scope changes mid-task, communicate the shift and adjust the plan.
150+
- Use parallel tool calls when applicable, especially for independent reads, checks, and validation steps.
151+
152+
### PR & Commit Titles
153+
- Prefer conventional commit style for branch-facing titles: `type(scope): summary`.
154+
- Use the repository's normal types where they fit, such as `feat`, `fix`, `chore`, `refactor`, `docs`, and `test`.
155+
- Use the most relevant module or product area as `scope`, such as `studio`, `cli`, `results`, or `evals`.
156+
- Do not prefix PR titles with `[codex]` unless the user explicitly requests it.
149157

150158
## TypeScript Guidelines
151159
- Target ES2022 with Node 20+
@@ -604,4 +612,3 @@ The release script (`bun scripts/release.ts`) is what the Release workflow calls
604612

605613
## Python Scripts
606614
When running Python scripts, always use: `uv run <script.py>`
607-

0 commit comments

Comments
 (0)