Skip to main content

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.

JobRunsOutput
Sprint reportCloud Run job, scheduledThe team's Google Doc
Insider tech updatesLocally, by handPrints bullets, or writes to a Google Doc with --write
perfInside the Web Vitals actionJSON 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.

ScheduleTeams
Wednesdays 1:00 ETSITE, 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