runs-index

What problem does it solve?

This Skill automates the structured tracking of development run statuses, eliminating the manual effort and inconsistencies associated with keeping project progress visible and auditable. It ensures your .runs/index.json is always current.

Core Features & Use Cases

• Deterministic Index Updates: Safely updates status, last_flow, and updated_at fields within .runs/index.json for a given run_id.
• Stable Diffs: Ensures consistent ordering and minimal changes to the index file, making version control clear and manageable.
• Controlled Writes: Only modifies specific, designated fields, preserving other run metadata owned by other agents.
• Use Case: At the conclusion of each SDLC flow (e.g., after "Signal cleanup"), automatically update the index.json to reflect the latest status (e.g., "VERIFIED") and the last completed flow for a specific run, providing real-time project visibility and audit trails.

Quick Start

Update the index.json for run 'feat-auth' to status 'VERIFIED' after the 'signal' flow, using the current timestamp generated by the 'time now' command.