Skip to content

Commit 73daccf

Browse files
t3dotggclaude
andauthored
docs(agents): name the fast commands and stop polling (pingdotgg#22711)
Co-authored-by: Claude Opus 5.5 <[email protected]>
1 parent a93b03c commit 73daccf

1 file changed

Lines changed: 5 additions & 2 deletions

File tree

‎AGENTS.md‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,7 @@ The most common defect in this repo is a change that works on the path you teste
8383
- Sharing over the tailnet is three steps: run `vp run dev --share` in the background, wait for the `pairingUrl:` line in its output, then give that full URL to an unpaired browser. Do not wire up `tailscale serve` by hand, open the URL yourself, or consume the user's pairing link. A browser with the reusable dev cookie can use the bare origin. If a normal one-time token was consumed, mint a fresh one with `node apps/server/src/bin.ts pair`. It carries standard scopes, while the startup URL carries admin scopes needed for Connections settings.
8484
- To reuse web dev auth across worktrees, configure one fixed `T3CODE_DEV_AUTH_TOKEN` in the main checkout's gitignored `.env`. The `t3.json` setup links that file into worktrees. Never commit or publish the token or a startup URL. See [Reusable dev credential](docs/operations/development.md#reusable-dev-credential).
8585
- Stop what you started, by the PID you tracked. See rule 1.
86+
- Need a second checkout? `git worktree add` it next to this worktree, not in `/tmp`. Remove it when done.
8687

8788
## Test data
8889

@@ -95,7 +96,9 @@ An empty database is a bad test. Seed your worktree's `.t3` with a copy of real
9596

9697
## Verifying
9798

98-
- Smallest proof that the change works. `vp test run <files>` for the tests you touched, targeted lint and typecheck for the scope you changed.
99+
- Smallest proof that the change works. `vp test run <files>` for the tests you touched (`-t "<name>"` in big files), `vp lint <files>`, and `vp run typecheck` in the package you changed. Not `npx tsc`; it is 3x slower than tsc-rs.
100+
- Run `vp run knip:check` (about 35 s) when you add, remove, or rename exports, files, or dependencies.
101+
- Run `node -e` snippets from `apps/server` or the owning package. `effect` does not resolve from the repo root.
99102
- Test meaningful logic or observable behavior. Do not render components to static markup to assert props or attributes, or add tests that merely assert callback wiring or mirror the implementation.
100103
- **Do not run repo-wide checks.** No `vp check`, no `vp run -r test`, no `vp run -r typecheck` unless I ask. CI owns the full suite.
101104
- Backend behavior changes ship with focused tests for that behavior.
@@ -137,7 +140,7 @@ For authorized mobile verification, a missing or outdated native client is a bui
137140
- UI changes need before/after images. Motion or timing needs a short video.
138141
- Upload PR evidence to GitHub. Never commit PR-only screenshots or assets such as `.github/pr-assets/`.
139142
- One request is one PR. Split it only when the maintainer asks. Outside contributions follow the stricter [one problem per PR](CONTRIBUTING.md#one-problem) rule.
140-
- When babysitting: poll checks and comments newer than the last push, verify each bot finding against the source, fix real ones, dismiss false positives with a written reason. Stay quiet when nothing is new. Stop when the bots are green on the latest commit.
143+
- When babysitting: call `watch_pull_request` and end your turn. T3 Code wakes you on checks, comments, or conflicts. Do not poll or sleep. Verify each bot finding against the source, fix real ones, dismiss false positives with a written reason. Stay quiet when nothing is new. Stop when the bots are green on the latest commit.
141144

142145
## Documentation
143146

0 commit comments

Comments
 (0)