code reviewer

Engineering Community

Skill notes

Step 0: Check for --interactive flag

Check the skill args for --interactive. If present, ask these four questions via AskUserQuestion before doing anything else: prompt: Review depth? | header: Depth | options: ["Quick (Haiku) — critical and major issues only, faster and cheaper (recommended)", "Deep (Sonnet) — thorough analysis, all categories including recommendations"] → store as REVIEW_DEPTH (quick or deep) prompt: Base branch for comparison? (default: main) | header: Base branch → store as BASE_BRANCH (default main if blank)

Step 1: Gather Context

🛑 An MR must exist before review can proceed.

Path A — MR found

Extract MR_IID, repo slug, MR_TITLE, MR_TARGET_BRANCH. Run in parallel: If TICKET_OVERRIDE set → use it. If no ticket found in branch → try MR_TITLE. If GOAL_OVERRIDE is not set → fetch Jira details in parallel (same as MR view): If brianna fails → use MR_TITLE + MR_DESCRIPTION. Do NOT ask developer. If GOAL_OVERRIDE is set → skip Jira fetch entirely, use GOAL_OVERRIDE as goal.

Path B — No MR found

Ask: prompt: No MR found for this branch. Review locally first and create the MR after fixing issues? | header: Create MR | options: ["Yes — review first, create MR after", "No — exit review"] If "No" → inform "Review cancelled. Create an MR and run the review again." — stop. If "Yes": git status --short — if tracked files exist, commit them explicitly (never git add .)

Step 2: Check Existing Spec

Read .codemie/reviews/<TICKET>/review.md. Also read .codemie/reviews/<TICKET>/progress.md if it exists — if conversation was interrupted, resume from last completed step.

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Engineering
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@tomevault-io · no license declared
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
Network behavior
External requests
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

01
Step 0: Check for --interactive flag

Check the skill args for `--interactive`. If present, ask these four questions via `AskUserQuestion` before doing anything else: prompt: `Review depth?` | header: `Depth` | options: `["Quick (Haiku) — critical and major issues only, faster and cheaper (recommended)", "Deep (Sonnet) — thorough analysis, all categories including recommendations"]` → store as `REVIEW_DEPTH` (`quick` or `deep`) prompt: `Base branch for comparison? (default: main)` | header: `Base branch` → store as `BASE_BRANCH` (default `main` if blank)

02
Step 1: Gather Context

🛑 An MR must exist before review can proceed.

03
Step 2: Check Existing Spec

Read `.codemie/reviews/<TICKET>/review.md`. Also read `.codemie/reviews/<TICKET>/progress.md` if it exists — if conversation was interrupted, resume from last completed step.

04
Step 3: Find Changed Files

Merge and deduplicate into `ALL_FILES`. Note if commands 2–4 returned files (uncommitted user code). If Case B (re-evaluation + new scan): also collect `NEW_FILES` — files changed by the developer since the spec date (excluding files only touched by the reviewer's own fix commits): Simpler equivalent logic (readable): Get commits since spec with `AI-Code-Review: completed` in body → these are reviewer commits

05
Step 4: Review

Step 4: Review

06
Step 5: Save Spec

Spec path: `.codemie/reviews/<TICKET>/review.md` ⚠️ Spec is NEVER committed.

07
Step 6: Present Findings

Step 6: Present Findings

08
Step 7: Apply Fixes

Step 7: Apply Fixes

09
Step 8: Commit

Verify spec is NOT tracked: If found → `git rm --cached .codemie/reviews/<TICKET>/review.md`

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.