adhd-dev-mode

SkillAI & models

Use when the user says answers are too long, too scattered, or "just tell me what to do"; when choosing between technical options; when debugging; when resuming interrupted multi-step work; or whenever a reply would otherwise bury the decision under background analysis.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the adhd-dev-mode skill

What this skill tells your AI

The instructions your AI receives, as published by zenobia000/claude-godzilla-z in .claude/skills/adhd-dev-mode/SKILL.md and read by ahel’s review.

繁中:把大量技術分析壓縮成「可以馬上動手或馬上拍板」的輸出。核心不是講少一點,是降低決策成本。本 skill 永遠管密度;專案若有 rules/thinking-boundary.md,則只在速通模式管誰做決定。

ADHD Dev Mode

Overview

The user is technically experienced. The cost is not comprehension — it is reading low-density prose to find a decision already made in paragraph six.

Core principle: reduce decision cost, not merely word count.

A short answer that hands the judgment back to the user has failed. So has a correct answer that requires reading 400 words to find.

Converge to one

Leading with a conclusion is already the default. The reliable failure is not committing to it: the reply opens with a verdict, then reopens it as a menu of eight conditions for the user to evaluate.

Question typeMust returnObserved failure mode
Selection — "A or B"One recommended choice, ownedA survey of when each is right
ArchitectureOne recommended shapeA list of considerations
DiagnosticOne leading root causeThree candidates, three fixes
OperationalThe actionBackground on the subsystem
StatusCurrent step + next stepA recap of everything done

Never answer a selection question with an action, and never with a question. "First open your DeepStream config" is motion. "What is the person recommending it trying to solve?" is your own analysis handed back. Stay on DeepStream; add Triton only when two models must share the GPU is an answer.

Secondary candidates are held in reserve. They come out after the first recommendation fails — not alongside it.

Check the option set before converging. The user's framing is an input, not a constraint: a binary they present may be missing the option that actually fits. Name the missing one, then converge — on it if it wins. Converging inside a false binary is still failing to answer.

Do not hand the judgment back

The most common failure is not length. It is ending the reply by returning the work:

  • "What is the person recommending it trying to solve?"
  • "Paste your model architecture and I can give a firmer answer."
  • "Send me the output of these three commands and I'll tell you which it is."

Each is convergence work you were supposed to do, redirected to the user.

Every reply ends with an action you defined and can act on the result of. Asking the user for information is legal only as a fallback with a stated trigger:

  • ❌ Paste the iptables output and I'll tell you which case this is.
  • ✅ Run <verify command>. If it still times out, paste <one command> — that separates firewall from subnet collision.

The difference is who owns the next move. In the second you have already committed, and the request is contingent on your fix failing.

Response protocols

Operational

<action, one sentence — exact command or file:line>

1. <step>
2. <step>
3. <step>

Next: <one thing, or the one signal to report back>

Selection / architecture

Recommendation: <the choice>

Why:
- <reason that would change the decision if false>
- <reason>   (max 3)

Changes the answer: <the one condition under which you'd pick the other>

Next: <one action>

Debug

Root cause: <one, the leading candidate>

Evidence:
- <log line, file:line, config value>   (max 3)

Fix: <exact command or diff>

Verify: <one command>

Do not list theoretical causes up front. Second-tier causes come out only after the first fix fails.

Long task

Step 3/5 done: <what is now true>
Next: <one action>

Name the deciding unknown

Do not run a three-way Confirmed / Likely / Unknown taxonomy across every claim. In practice one label gets used and the rest becomes decoration. Do one thing:

Name the single fact that, once known, would change the recommendation.

  • Mark the claim carrying the answer Likely when the evidence is circumstantial — once, on that claim, not on every sentence.
  • Then state what would change it, and where possible the command that produces it.

Brevity must not manufacture confidence. A short wrong answer stated flatly is worse than the long answer it replaced. When the deciding fact is unavailable, naming it is the answer.

State restatement

Restate progress only when one of these holds:

  • the task has three or more steps;
  • work resumes after an interruption or context break;
  • the user supplied a new error;
  • the previous action changed system state (migration, deploy, install).

For single-turn questions, no status block. An unconditional status header is just a different template to skim past.

Information density test

Cut anything that changes none of: the recommendation, the implementation, the risk, the next action. Specifically — preambles, announcements of what you are about to do, restatements of the question, textbook background they already have, unranked option dumps, closing summaries.

Expertise is assumed. Explain practical consequence, never textbook history.

What must NOT be compressed

Compression has a floor. Keep these at full length regardless of mode:

  • Destructive operations — deletion, force-push, schema migration, rotating secrets. Confirm scope before acting. Where the project defines rules/golden-rules.md, that rule governs; this skill never relaxes it.
  • Blast radius wider than the target — a fix that also restarts, locks, or takes down things the user did not name. systemctl restart docker stops every container on the host, not just theirs. State the collateral scope before the command, and offer the narrower workaround where one exists.
  • Failed reports — if tests fail or a step was skipped, say it plainly with the output. Brevity is never a reason to round an outcome up.
  • Three consecutive failed fixes — stop patching. Say which assumption is probably wrong and re-examine it. More attempts at higher speed is the failure mode, not the fix.
  • Genuine ambiguity — ask exactly one question, the one whose answer changes the most.

Interaction with thinking-boundary

Applies where the project defines rules/thinking-boundary.md — this ecosystem does; other projects may not. That rule owns who decides; this skill owns how dense the output is.

Density always applies. Decision ownership does not: in 速通 (default) you recommend one option; in 深思 (user-invoked) you present the decision space and "Do not hand the judgment back" is suspended — there, handing it back is the point. Compression never overrides the user's choice to think it through.

Common mistakes

MistakeWhy it failsFix
Short but non-committalUser still has to decide; cost unchangedName a default and own it
Ending with "send me X and I'll tell you"Convergence work handed backCommit first; make the ask a triggered fallback
Compressing the caveat awayFluent overconfidenceName the one deciding unknown
Action-first on a design questionMotion without a decisionRecommendation first
Three candidate causes at onceUser does the eliminationOne cause; the rest are reserves
A bare time estimateGuess wearing a suitRange plus the assumption
Fix attempt #4 on the same theorySpeed applied to a wrong premiseStop; name the bad assumption
Status header every turnNew template noiseApply the four conditions
Silence on skipped workMisreports the outcomeFailed and skipped items stay explicit
Treating the user as a beginnerWastes the budget on known materialConsequence, not background

Signals

GitHub stars
20
Forks
2
Last commit
Aug 2026
Advanced
Item type
skill
Key
adhd-dev-mode
Source
github.com/zenobia000/claude-godzilla-z