cache knip, add to agents.md

Author: carderne

AGENTS.md

@@ -81,6 +81,16 @@ pnpm run lint:fix    # oxlint — auto-fixes lint violations
 pnpm run lint        # oxlint — check only (no fixes)
 ```
 
+### Dead code
+
+We use knip to control unused dependencies and code. It is enforced by CI `code-quality`.
+
+Scan your code before pushing with:
+
+```bash
+pnpm run knip
+```
+
 ### Imports
 
 **Prefer static imports over dynamic imports.** Only use dynamic `import()` when:

CONTRIBUTING.md

@@ -59,7 +59,7 @@ branch are tagged into a release periodically.
    ```
 6. Create your `.env` file
    ```
-   cp .env.example .env
+  --cache  cp .env.example .env
    ```
 7. Open it and generate a new value for `ENCRYPTION_KEY`:
 
@@ -238,10 +238,11 @@ This never affects correctness — CI enforces the same checks on every PR; the
 1. **Always open your PR in draft status first.** Do not mark it as "Ready for Review" until the steps below are complete.
 2. **Run format and lint locally before pushing:**
    ```bash
-   pnpm run format      # auto-fixes formatting (oxfmt)
-   pnpm run lint:fix    # auto-fixes lint violations (oxlint)
+   pnpm run format
+   pnpm run lint
+   pnpm run knip
    ```
-   Both are enforced by CI — the `code-quality` check will fail if either produces a diff or errors.
+   These are enforced by CI — the `code-quality` check will fail if either produces a diff or errors.
 3. **Address all CodeRabbit code review comments.** Our CI runs an automated code review via CodeRabbit. Go through each comment and either fix the issue or resolve it with a comment explaining why no change is needed.
 4. **Wait for all CI checks to pass.** Do not mark the PR as "Ready for Review" until every check is green.
 5. **Then mark the PR as "Ready for Review"** so a maintainer can take a look.

package.json

@@ -22,7 +22,7 @@
     "format:prisma": "pnpm --filter @trigger.dev/database run format:prisma && pnpm --filter @internal/run-ops-database run format:prisma",
     "lint": "oxlint",
     "lint:fix": "oxlint --fix",
-    "knip": "knip --include files,exports,types,dependencies,unlisted,binaries,unresolved,catalog",
+    "knip": "knip --cache --include files,exports,types,dependencies,unlisted,binaries,unresolved,catalog",
     "docker": "node scripts/docker.mjs -f docker/docker-compose.yml up -d --build --remove-orphans",
     "docker:stop": "node scripts/docker.mjs -f docker/docker-compose.yml stop",
     "docker:full": "node scripts/docker.mjs -f docker/docker-compose.yml -f docker/docker-compose.extras.yml up -d --build --remove-orphans",