Hforge Review

--- name: hforge-review description: runtime health review for harness forge workspaces. use when the user wants drift checks, decision coverage, stale task review, managed-surface integrity, or a clear pass-fail summary of the current runtime state.

HForge Review

Trigger Signals

• the user asks whether the current Harness Forge setup is healthy
• runtime drift, stale task artifacts, or missing managed surfaces are suspected
• a handoff, release, or package refresh needs a concise review first
• decision coverage and runtime governance need to be checked before moving on

Inspect First

• .hforge/runtime/index.json
• .hforge/runtime/decisions/index.json
• .hforge/runtime/tasks/
• .hforge/generated/agent-command-catalog.json
• .hforge/agent-manifest.json

Workflow

1. run hforge review --root . --json
2. if installation drift is suspected, run hforge doctor --root . --json
3. if package-surface integrity is suspected, run hforge audit --root . --json
4. summarize blockers, warnings, stale runtime artifacts, decision gaps, and the best cleanup order

Output Contract

• runtime health summary with blocker, warning, and cleanup sections
• decision-coverage and stale-task callouts when relevant
• the next remediation command to run

Validation Path

• hforge review --root . --json
• hforge doctor --root . --json
• hforge audit --root . --json

Failure Modes

• the workspace is not initialized
• review signals are incomplete because runtime summaries are stale
• doctor or audit cannot read the current install state

Escalation

• escalate when install drift risks losing managed state
• escalate when audit shows package-surface mismatches that need a maintainer fix
• escalate when runtime findings and source-of-truth manifests disagree

References

• skills/hforge-review/references/review-order.md
• skills/hforge-review/references/output-contract.md