encero-systems/incan / .agents/skills/review-and-fix
review-and-fix
VerifiedReview And Fix — Incan Compiler
Purpose
/review-and-fix is the user-facing entry point for autonomous review plus repair.
The user should not need to choose between the simple reviewer and the orchestrated reviewer. This skill decides that itself from the current worktree.
Under the hood it chooses one of two paths:
- small/local scope:
/loop /review /fix - broad/multi-surface scope:
review-orchestrate->/fix-> final review pass
/loop still owns repetition and stopping conditions for the small/local path. For broad scopes, this skill owns the
high-level routing and uses the persistent report at .agents/state/review-report.md.
Workflow
- Inspect the current dirty worktree before choosing a path.
- Choose the small/local path when the change is narrow enough for one honest reviewer, for example:
- a small number of touched files,
- one main subsystem,
- code-only or docs-only,
- no evidence of cross-cutting code/docs/tests/RFC churn.
- Choose the broad/multi-surface path when any of the following are true:
- multiple subsystems are touched,
- both code and user-facing docs moved,
- tests, docs, and implementation all changed,
- the worktree is large enough that one reviewer is likely to skip surfaces,
- the user explicitly wants subagents or delegated review.
- For the small/local path:
- invoke
/loopwith/reviewas detector and/fixas repair skill, - let
/looprepeat until clean or legitimately blocked.
- invoke
- For the broad/multi-surface path:
- run
review-orchestrate, - consume the merged findings with
/fix, - then run a final review pass appropriate to the remaining scope.
- run
- Treat
.agents/state/review-report.mdas a live structured artifact, not a final prose summary. - For orchestrated runs, treat slice reports as the primary evidence and the canonical report as a thin merged findings index. Preserve findings by default; do not over-prune them during merge.
- Each new
/review-and-fixinvocation starts with a fresh report scaffold. Do not reuse an older run's findings or activity log.
Routing rule
The default user expectation should be simple:
- users ask for
/review-and-fix - this skill decides whether the work is small or broad
- the user does not need to manually choose
/reviewvsreview-orchestrate
If the scope is borderline, prefer the broader review path. The cost of one wider first pass is lower than repeated serial misses and reruns.
Verification expectations
The repair pass should aim to leave the worktree in a strong verified state:
make fmt- narrow relevant checks
cargo run -p incan_lang --bin generate_lang_referencewhen language registries, the reference generator, orworkspaces/docs-site/docs/language/reference/language.mdchanged; inspect and commit any resulting generated diffmake pre-commit
If the broad gate fails for unrelated environmental reasons, report that explicitly as residual risk instead of pretending the loop is clean.
Output format
Produce a short summary:
## Review And Fix — <subject / branch>
### Chosen path
<small/local review loop or broad orchestrated review>
### Review findings
<high-signal findings from the chosen review path>
### Fixes applied
<what changed>
### Final review state
<clean / blocked / residual risk>
### Verification
<commands and outcomes>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |