microsoft / microsoft/hve-core

docs: regenerate rpi-agent and rpi-quick reference pages for interrupted-critique recovery

Open Beginner friendly
#2,923 0 comments 0 reactions 0 assignees View on GitHub
agent-ready documentation needs-triage
Dominant language
Python
Stars
1.5k
Forks
301
Avg merge
3d 3h
Merged PRs (30d)
92

Description

### Component

Documentation

### Bug Description

Commit 22816ec8 ("fix(skills): recover interrupted RPI critiques without bypassing readiness gates (#2894)") changed `.github/agents/hve-core/rpi-agent.agent.md` and `.github/skills/rpi/rpi-quick/SKILL.md` to describe the new interrupted-critique recovery model: a task uses **one initial** final-candidate critique, plus only a single user-confirmed interruption recovery owned by `rpi-plan`; terminal critique results are never retried.

The generated reference pages for these two artifacts were not regenerated and still describe the old "at most one critique, no retry" model without mentioning the new recovery path:

* `docs/reference/agents/hve-core/rpi-agent.md` — the bullet at line 137 still says "...do not rerun the planning critique" instead of describing the interrupted-recovery exception now present in the source agent file.
* `docs/reference/skills/rpi/rpi-quick.md` — line 33 still says "runs the single plan critique through rpi-plan" without noting the recovery exception described in the updated `SKILL.md`.

The same commit did correctly regenerate `docs/reference/skills/rpi/rpi-plan.md` and `docs/reference/skills/rpi/rpi-plan-critique.md`, so this appears to be an incomplete `npm run docs:generate` pass that missed the agent and rpi-quick pages.

### Expected Behavior

`docs/reference/agents/hve-core/rpi-agent.md` and `docs/reference/skills/rpi/rpi-quick.md` should be regenerated (via `npm run docs:generate`) so their content accurately reflects the current `rpi-agent.agent.md` and `rpi-quick/SKILL.md` source, including the one-initial-critique-plus-single-confirmed-recovery model.

### Steps to Reproduce

1. Compare `.github/agents/hve-core/rpi-agent.agent.md` (current) against `docs/reference/agents/hve-core/rpi-agent.md`.
2. Compare `.github/skills/rpi/rpi-quick/SKILL.md` (current) against `docs/reference/skills/rpi/rpi-quick.md`.
3. Note the source files describe interrupted-critique recovery; the docs pages do not.

### Additional Context

Source files: `.github/agents/hve-core/rpi-agent.agent.md`, `.github/skills/rpi/rpi-quick/SKILL.md`
Documentation files: `docs/reference/agents/hve-core/rpi-agent.md`, `docs/reference/skills/rpi/rpi-quick.md`
Related regenerated pages from the same commit (for reference on expected wording style): `docs/reference/skills/rpi/rpi-plan.md`, `docs/reference/skills/rpi/rpi-plan-critique.md`

> Generated by [Documentation Update Check](https://github.com/microsoft/hve-core/actions/runs/35097792798) · auto · 57.3 AIC · ⌖ 3.92 AIC · ⊞ 10K · [◷](https://github.com/search?q=repo%3Amicrosoft%2Fhve-core+is%3Aissue+%22gh-aw-workflow-call-id%3A+microsoft%2Fhve-core%2Fdoc-update-check%22&type=issues)

Contributor guide

Open the contributing guide

Research direction

Compare .github/agents/hve-core/rpi-agent.agent.md and .github/skills/rpi/rpi-quick/SKILL.md with their corresponding reference pages. Run npm run docs:generate, then verify docs/reference/agents/hve-core/rpi-agent.md and docs/reference/skills/rpi/rpi-quick.md include the interrupted-critique recovery wording and match the current source files.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
90/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.