Skip to content
Claude Code/Knob: Brief
50/54
Sign in

Knob 4 of 5

Brief

How thoroughly you frame the ask.

One-liner

> fix the bug

Ambiguous · likely to misread intent

+ Examples

> fix the null-pointer in user.ts that crashes when session is missing — it should log and continue, like auth.ts does

Tells the agent the shape of the answer

Full spec

> [role] You are refactoring user auth. [context] We use JWTs, sessions can be null for guests. [constraints] Do not change the public API. [example] See auth.ts handleMissingSession. [tests] Add a unit test for the null case.

Verbose, but eliminates re-prompts

The intern test

Would an energetic, smart, green intern — reading your brief cold — produce what you want? If yes, you briefed enough. If no, you have words to add before you hit Enter.

A good brief is one an energetic intern could read cold and still get right.