← ClaudeAtlas

coding-agent-task-scopinglisted

Scope an autonomous AI coding agent task so it is well-bounded, recoverable, and matched to the right model tier before it runs. Reach for this skill before any long, unsupervised, or multi-step agentic run — a poorly scoped task on a frontier model is both expensive and hard to debug.
mcorbett51090/RavenClaude · ★ 7 · AI & Automation · score 65
Install: claude install-skill mcorbett51090/RavenClaude
# Skill: Coding Agent Task Scoping An autonomous coding agent run is not a chat turn. The task description, model tier, and recovery plan must be decided before the run starts — not after it has touched 40 files. This skill structures that pre-run decision. ## Step 0 — Is this task actually agent-appropriate? Not every "I want to automate this" request benefits from an autonomous run. Run this quick check: | Question | If YES | If NO | |---|---|---| | Can the task be done interactively in one supervised chat turn? | → Supervised chat, not an agent run | Continue | | Does the task require reading many files the developer can't enumerate? | → Agent run appropriate | Supervised chat | | Does the task require irreversible production actions (deploys, deletions, DB writes)? | → Mandatory human gate; see high-blast rule | Continue with caution | | Can the task be decomposed into ≤ 5 well-defined sub-steps? | → Prefer sequential supervised turns | Agent run if steps are still complex | ## Step 1 — Define the task boundary A well-scoped agent task has a clear **start state**, **end state**, and **scope envelope**: ``` Start state: [what exists before the run: branch, file list, test state] End state: [what "done" looks like: tests pass, file changed, PR opened] Scope envelope: - Repos in scope: [explicit list] - Files allowed to modify: [pattern or list] - Files NOT to touch: [explicit exclusions — migrations, infra, secrets] - External calls allowed: [none | read-