microsoft / microsoft/hve-core
docs: regenerate rpi-agent and rpi-quick reference pages for interrupted-critique recovery
- 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
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