close-round

Closes a development round by updating docs and triggering strategy reviews.

Updated Dec 27, 2025
One-click install
npx skills add https://github.com/HendrikGC02/Astroray --skill close-round-hendrikgc02
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: close-round
Source: https://github.com/HendrikGC02/Astroray/tree/main/.claude/skills/close-round
Command: npx skills add https://github.com/HendrikGC02/Astroray --skill close-round-hendrikgc02

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Development rounds in the Astroray project end with scattered bookkeeping: specs drift out of sync with merged PRs, status docs go stale, and nobody checks whether an architect-level strategy review is due. This Skill automates that round-closeout ritual so nothing is forgotten. ## Core Features & Use Cases - Spec-status drift gate: Greps every spec for stale pending/in-review statuses, cross-checks each referenced PR with gh pr view, and blocks the closeout until specs are flipped to done. - Docs-updater orchestration: Spawns the docs-updater agent with the list of PRs merged since the last STATUS.md update and confirms the doc PR is open or merged. - Strategy review trigger: Evaluates conditions (deferred targets, rounds since last review) and spawns the architect agent in state+refine mode when warranted. - Use Case: After merging several renderer packages, run the closeout to flip spec statuses, regenerate status docs, and get a summary of what the next dispatch will pick up. ## Quick Start Run /close-round after the round's PRs are merged to update the docs and check whether a strategy review should fire.

Frequently Asked Questions about close-round

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I close out a development round in the Astroray project?▼

Invoke /close-round after the round's PRs are merged. It audits spec statuses, spawns the docs-updater agent to refresh STATUS.md, checks whether an architect strategy review is due, and reports what the next dispatch will pick up.

How does the spec-status drift gate work?▼

The gate greps all specs under .astroray_plan/packages/ for statuses still reading pending or in review. For each hit naming a PR, it runs gh pr view to check the PR state; if merged or closed, the closeout fails until the spec is flipped to done.

When does the close-round skill trigger an architect review?▼

An architect state+refine pass fires when three or more packages have deferred targets, when it is the third round since the last review, or as a light pass every round. The light pass reads current render output and status, then asks one short question.

Why does close-round fail even after my PR was merged?▼

The closeout fails if a spec still reads pending or in-review while its referenced PR is merged or closed. Flip the spec status to done with the PR number, date, and headline numbers, then rerun the closeout.

Does close-round merge pull requests itself?▼

No. It only verifies PR states through the GitHub CLI and coordinates the docs-updater and architect agents. Merging is handled separately by the pr-merger, which also flips specs at merge time.