Jobs
TypeScript jobs in jobs/, with their own package.json. Each job gathers data, has Claude write it up, and either prints the result or writes it to a Google Doc.
| Job | Runs | Output |
|---|---|---|
| Sprint report | Cloud Run job, scheduled | The team's Google Doc |
| Insider tech updates | Locally, by hand | Prints bullets, or writes to a Google Doc with --write |
| perf | Inside the Web Vitals action | JSON results |
Sprint reportβ
Summarizes a team's last finished Linear cycle, with its pull requests and releases, and writes it to that team's Google Doc.
| Schedule | Teams |
|---|---|
| Wednesdays 1:00 ET | SITE, TOOL, INFRA, LEAD |
One Cloud Run job, sprint-report, serves all four. Each scheduler entry sets the team and the Google Doc it writes to. Every run reports the most recently finished cycle.
Insider tech updatesβ
Drafts the Tech Updates bullets for The Insider newsletter from the work shipped in a cycle.
Run locallyβ
cd jobs
npm install
npm run sprint-report # prints, doesn't write
npm run insider # prints; add -- --write to write the doc
Keys go in jobs/.env: LINEAR_API_KEY, ANTHROPIC_API_KEY, GITHUB_TOKEN, plus GOOGLE_DOCS_GCP_KEY and a doc ID to write to Google Docs.
Adding a reportβ
Add a folder with an index.ts that calls runReport() and a prompt.md with {{placeholders}}. The runner handles the prompt, the Claude call, the dry run and the Google Doc write. Returning nothing from fetch() skips the report.
Checksβ
cd jobs
npm run test:ci
npm run typecheck
npm run biome:check