DOCS-review.md is the /leetcode review flow Claude follows; SKILL.md routes a first token review to it and points at the skeleton rules, staying at 250 lines. The md-naming gate takes DOCS-* names only, so the text is not REVIEW.md. test_review_docs.py holds the quoted commands to the CLI. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WzxdWXLvi9aq4MxL4XHKJ4
5.2 KiB
/leetcode review [slug]: name the one cause of a slow solve
Claude Code only; leetcode --local does not run this.
A review looks at a solve the guard flagged: LeetCode accepted it, but kuhy spent more than 20 active minutes on it although the unit's theory was already taught. You find the one cause, log it, and that starts the cold re-test clock (+3 and +10 days). You do not coach the problem again.
Never print a solution, a corrected line or a rewrite of kuhy's code.
reveal does not apply in a review.
The flow
-
Pick the solve. Run:
python3 -m leetcode_coach.review_cli review-list- No slug in the arguments: show kuhy the lines as printed and ask which solve he wants to review.
- A slug in the arguments: go on only if one line starts with that slug.
nothing to review, or his slug is not on the list: say so in one line and stop. Only flagged solves can be reviewed.could not check: ...(exit 2): the guard gave no report. Show the line and stop. Never report it as "nothing to review".
-
Show the evidence. Quote the solve's line and say what it means:
activeis the time the problem page was on screen,spanruns from the day's first heartbeat to Accepted,failedcounts the failed submissions by verdict,first submitis the active time before the first submission,tabssplits the active time by page tab,theoryis the unit's tutor state at the solve. -
Ask for his accepted code. kuhy pastes it. Do not fetch it and do not rewrite it.
-
Ask at most 3 questions, one per message, each about something the evidence or the code shows ("12 minutes passed before your first submit: what did you do in them?"). Stop asking once the cause is clear.
-
Name exactly ONE cause in one or two sentences that cite the evidence. If two fit, pick the one that cost more minutes. kuhy may correct you: his word decides.
cause id what happened statementHe misread the statement or missed a part of it. missing-ideaHe did not have the idea the solution needs. Name the unit that teaches it ( --module).idea-to-codeHe had the idea early and could not turn it into code. debuggingThe code was nearly right; the time went into finding a bug (debugging process). interruptionHe was away or distracted; the minutes are not work on the problem. Then close the review:
python3 -m leetcode_coach.review_cli review-finish <slug> --cause <cause> [--module <unit>]--module <unit>goes withmissing-ideaand with no other cause. The unit is a curriculum unit id:scans,hashing,math,bits,sorting-greedy,pointers-window,prefix-sums,stack-queue,binary-search,lists-recursion,trees,heap-dp,sql,js-pandas.Read its output; it says exactly what it wrote:
- exit 0,
review logged: ...andledger row: written: the solve is no longer flagged, and the re-test falls due 3 and 10 days from today (leetcode --retest <slug>). refused: ...(exit 1): the slug is not flagged or an argument is wrong. Nothing was written.could not check: ...(exit 2): nothing was written. Tell kuhy; do not retry in a loop.nothing written: no signed ledger row ...(exit 3): the signing key is unreadable. Nothing was written and the solve stays flagged. Tell kuhy.ledger row written, review event NOT logged ...(exit 3): run the same command again.
- exit 0,
-
Card, for two causes only.
missing-ideaandidea-to-codeget ONE property -> operation card for the toolbox entry his accepted code relies on, built the post-mortem way (SKILL.md section 5b, steps 2 to 4):python3 -m leetcode_coach.toolbox_cards cards "<entry>" \ | ~/.claude/skills/leetcode/make_cards.py -statement,debuggingandinterruptionget no card: thereviewevent is their whole record. No cause writes to the tutor or changes a price. -
End. Tell kuhy the cause and the two re-test dates, then stop.
An abandoned review writes nothing. If kuhy stops before a cause is named, run no command: the solve stays flagged and he can review it later.
Skeleton sheets
A skeleton sheet is one unit's code template with holes. DOCS-skeletons.md
has the rules; the command is:
python3 -m leetcode_coach.review_cli skeleton-open <slug> <unit>
- Open a sheet only when kuhy asks for one, and only after his first code
attempt. Never offer it. In a
leetcode <url>session the client has logged his first code; in a review his accepted code is the attempt, so the slug must still be flagged: open the sheet beforereview-finish. - Opening a sheet counts above H1: that solve gets no sign-off. The command
logs a
skeletonevent. - stdout is the sheet file, byte for byte. Quote it to kuhy exactly as
printed: add no fence, no header and no note inside it (the stop gate lets
a sheet through only verbatim). The line
skeleton logged: ...goes to stderr. refused: ...(exit 1) orcould not check: ...(exit 2): the sheet stays shut and nothing was logged. Say why in one line.