event-description-generator

Event Description Generator

Run this skill as an orchestrator only. Do not perform per-event filtering, repo search, or description-writing logic in this skill body. Delegate chunk processing to the event-descriptions-worker subagent.

Workflow

1. Resolve project input (projectId or project name)
2. Create a run ID with short git SHA (<projectId>-<sha>)
3. Create run directories under runs/
4. Determine cursor plan (cursorStart, maxEvents, chunk size)
5. Spawn event-descriptions-worker subagents for cursor chunks
6. Collect worker summaries + output paths
7. Compress the run into a single CSV
8. Report concise progress and next cursor

Execution Rules

• Keep this skill as a dispatcher; the worker does the heavy lifting.
• Do not call set_event_metadata from this skill.
• Do not manually re-implement worker filtering/search logic here.
• Preserve user control over scope (project, cursor range, chunk size, parallelism).

Prerequisites

The user must provide either:

• projectId, or
• project name to resolve.

If neither is provided, stop and ask.

Phase 1: Resolve Project

1.1 If projectId is provided

Use it directly.

1.2 If project name is provided

Call get_context and resolve the name to a single projectId.

• If exactly one clear match exists, continue with that ID.
• If multiple matches exist, ask the user to choose.
• Do not choose an ambiguous match on behalf of the user.

1.3 If project name is not provided

Prompt the user to input the project name or ID and halt.

Phase 2: Build Cursor Plan

Default values unless the user specifies otherwise:

• cursorStart: 0
• maxEvents: 400
• eventsPerWorker: 50
• maxParallelWorkers: 4

For maxEvents:

• Compute total chunks as ceil(maxEvents / eventsPerWorker).
• Process at most maxEvents events starting at cursorStart.
• For the final chunk, pass a reduced eventsPerWorker if needed to avoid exceeding maxEvents.

For each chunk: