Skip to content

Method Map

This table maps the most common long-running coding-agent failure modes to the artifact or operating rule that usually fixes them first.

Failure modeWhat it looks like in practicePrimary fixSupporting artifact
Cold-start confusionA new session spends most of its time rediscovering setup and statusMake the repository the system of recordclaude-progress.md
Scope sprawlThe agent starts several features and finishes none of them cleanlyRestrict active scopefeature_list.json
Premature completionThe agent claims done after code edits but before runnable proofBind completion to evidenceclean-state-checklist.md
Fragile startupEvery session re-learns how to boot the projectStandardize setup and verificationinit.sh
Weak handoffThe next session cannot tell what is verified, broken, or nextEnd with an explicit handoffsession-handoff.md
Subjective reviewReview quality depends on taste or memoryScore output with fixed categoriesevaluator-rubric.md

Operating Principle

Add the smallest artifact that directly addresses the observed failure mode. Avoid solving every reliability problem by dumping more text into one global instruction file.