Build pack · hand-off to a coding agent

Everything an agent needs to build v0 → v1, with no decisions left to re-derive.

The brief, one spec per subsystem, real-data fixtures, and the registry seed. Point a coding agent at the README and it can execute the gated build order end to end.

Start here: the README carries the constraints, the 9-step build order with gates, and the definition of done.
Open README →

The brief

00

Agent briefREADME.md

Non-negotiable constraints, 9-step build order with per-step gates, v0/v1 scope, what NOT to build, definition of done.

Subsystem specs

01

Repo scaffold01-repo-scaffold.md

Workspace layout, Cloudflare resources (R2 / Queues / D1 / crons), D1 schema, conventions.

02

Data contracts02-data-contracts.md

Registry, NormalizedPost, Classification, and all five public artifacts as exact types. The no-raw-text leak rule, as a test.

03

Collector03-collector.md

The privacy boundary: interface, X API endpoints + limits, pull recipe, hard budget guards, shadow-swap harness.

04

Enrichment04-enrichment.md

Theme vocabulary, the actual classification / author / summary prompts, the summary validator, spam + amplification detection.

05

Rollups & scores05-rollups-scores.md

Window rollups, vibe-score.v1 + launch-score.v1 as exact math, change-event triggers, the state machine, atomic publish.

06

Site06-site.md

Astro pages + components mapped to the mockups, hydration + polling, embed strategy with fallback, OG cards, quality bar.

07

Acceptance07-acceptance.md

CI gates, fixture reconciliation tolerances, mockup-parity check, the 7-day live soak.

Runtime & operations

08

Workers & runtime wiring08-workers.md

Bindings per worker, runId + idempotency scheme, scheduler tick algorithm, queue contracts, exact budget-guard SQL, manifest-pointer atomic publish, LLM client, local dev + deploy.

09

Ops runbook09-ops-runbook.md

Provisioning commands, alerts table, routine procedures (add entity, flip launch, bump versions, replay from raw, collector swap), incident playbook, degradation philosophy.

10

Gotchas10-gotchas.md

The sharp edges: X API quirks (7-day windows, relevancy pagination, RT truncation, partial buckets), Cloudflare limits, embed flakiness, LLM JSON drift, data rules. Read before coding, not after.

Data

Real-data fixturefixtures/fable-summary-v1.json

The real June 9 Fable 5 capture (trimmed, private-shape). Drives every golden test and the reconciliation gate.

Registry seedregistry-seed.jsonverify names

21 entities across all four vectors. Fable 5 is verified; other model names/handles are placeholders flagged for verification before bootstrap pulls.