regenerating-overviews

Regenerating Overviews

Org overviews are short knowledge pages summarizing what an org has shipped recently. Regeneration is agent-driven: this skill carries the prompt and structure rules; the API exposes a pure-data input builder and a dumb upsert.

No managed-agent task exists for this today. You — the Claude Code instance reading this skill — are the agent. The CLI is a thin client.

When to Use

• Single org refresh: "regenerate the vercel overview"
• Inside maintaining-orgs batch runs: each per-org sub-agent runs this skill
• After significant source mutations: a new active source landed, an old one was hidden
• After backfilling a window of releases: stale overview no longer reflects current focus

Skip on-demand orgs. If org.discovery === 'on_demand', do not regenerate — the API-side overview workflow already gates on this column, and generating an overview for an org that hasn't been curated wastes tokens. The releases admin overview plan / overview list endpoints already filter to curated orgs server-side via the organizations_active view, so manifest-driven sweeps don't need a separate filter pass.

Workflow

Three steps. Each step is a single CLI invocation; no other tools needed.

Sandbox without a working CLI? In an environment where the compiled releases binary can't reach the API through a TLS-intercepting egress proxy (e.g. the weekly SANA sandbox), skip the CLI and hit the REST routes directly — see Running without the CLI (curl fallback). Same three steps, same contracts.

1. Fetch inputs

releases admin overview inputs <slug> --json [--window 30]

Returns:

{
  "org":             { "id", "slug", "name", "description" },
  "sources":         [{ "id", "slug", "name", "type" }, ...],   // active only
  "existingContent": "...prior overview body..." | null,
  "selected":        [{ ...Release }, ...],                     // post-selection
  "totalAvailable":  47,                                        // pre-cap count
  "windowDays":      30                                         // 30d default; widens to 90d
                                                                  // when the org shipped fewer
                                                                  // than 5 releases in 30d
}