Skip to content

Commit 2d13c58

Browse files
Clarify branch naming and worktree setup in AGENTS.md (#1384)
1 parent a2c68ad commit 2d13c58

1 file changed

Lines changed: 3 additions & 2 deletions

File tree

AGENTS.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,12 +54,13 @@ It captures practical rules that prevent avoidable CI and PR churn.
5454
## PR Process
5555

5656
1. Start from `main`.
57-
2. Create a branch prefixed with `codex/`.
57+
2. Create a branch prefixed with `<agent-name>/` (for example `claude/fix-exec-output-truncation`). The PR title must not carry such prefixes (see step 9).
5858
3. Implement scoped changes only.
5959
4. Run required checks: `npm run format`, `npm run lint`, `npm run check-compiles` when touching `packages/testcontainers` APIs consumed by modules, and targeted tests.
60+
- When working in a fresh git worktree, dependencies are not installed (`node_modules` is absent), so verification commands (tests, `lint`, `format`, `check-compiles`) will fail with "Cannot find module" errors. Run `npm ci` once before verifying. `npm ci` only populates `node_modules` and must not modify `package-lock.json`; if it does, treat that as drift to investigate.
6061
5. Verify git diff only contains intended files.
6162
6. Never commit, push, or post on GitHub (issues, PRs, or comments) without first sharing the proposed diff/message and getting explicit user approval.
62-
7. Commit with focused message(s), using `git commit --no-verify`.
63+
7. Commit with focused message(s), using `git commit`.
6364
- Never bypass signing (for example, do not use `--no-gpg-sign`).
6465
- If signing fails (for example, passphrase/key issues), stop and ask the user to resolve signing, then retry.
6566
8. Push branch. Ask for explicit user permission before any force push.

0 commit comments

Comments
 (0)