whatisgithub

What is adhd?

uditakhourii/adhd — explained in plain English

Analysis updated 2026-05-18

619TypeScriptAudience · developerComplexity · 3/5LicenseSetup · easy

In one sentence

A skill for AI coding agents that runs several independent reasoning attempts in parallel from different angles, then scores and merges the best ideas.

Mindmap

mindmap
  root((ADHD Skill))
    What it does
      Parallel reasoning frames
      Critic scoring pass
    Tech stack
      TypeScript
      Claude Agent SDK
    Use cases
      Brainstorming
      Debugging
      Architecture choices
    Audience
      Developers
      Agent builders
    Setup
      Install as a skill
      Works with Codex

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate multiple independent design or naming options for a decision instead of one AI's first idea.

USE CASE 2

Debug a problem with no obvious cause by exploring several hypotheses in parallel.

USE CASE 3

Choose between architecture options by having separate reasoning frames argue each one out.

What is it built with?

TypeScriptClaude Agent SDK

How does it compare?

uditakhourii/adhdlevy-street/world-of-claudecraftxw7872081123/wallpaper-engine-steam
Stars619614608
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasy
Complexity3/51/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Built on the Claude and Codex Agent SDK, needs one of those agent runtimes already set up.

Free to use, modify, and redistribute for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

ADHD is a skill for AI coding agents that addresses a specific problem with how AI models reason through open-ended questions. When an AI works through a problem step by step in a single chain of thought, it tends to anchor on whatever direction it explores first, and subsequent ideas stay close to that initial framing. The ADHD skill tries to break that pattern by running multiple separate, isolated reasoning processes in parallel, each starting from a deliberately different perspective or cognitive frame, before a second pass evaluates and compares the results. The two-phase process works like this. In the first phase, the skill picks several cognitive frames, such as approaching a problem from a cost perspective, a security perspective, or an unconventional angle. It spawns separate AI agent calls for each frame, and each call is prevented from seeing what the others produced, so the ideas stay independent. In the second phase, a separate critic call scores every idea across novelty, viability, and fit, identifies ideas that seem appealing but are likely to fail, clusters the remaining ideas by underlying approach, and expands the top results into more detailed sketches with risks and first steps. The skill is designed for problems where the goal is to generate options rather than execute a known plan: design decisions, naming things, choosing an architecture, debugging problems that do not have an obvious cause, or any question of the form "give me a few ways to approach this." It is not meant for tasks with a clear correct answer. Installing it takes one command that auto-detects which AI coding tool you are using. It works with Claude Code, Codex, Cursor, Windsurf, and around fifty other tools. After installation you can invoke it explicitly by name with your problem as input, or it can trigger automatically when you ask an open-ended ideation question. The README includes benchmark results from testing across six open-ended engineering problems, showing large improvements in idea breadth, novelty, and trap detection compared to a single-shot baseline. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Use the ADHD skill to brainstorm three different architectures for this feature.
Prompt 2
Run ADHD on this bug so I get several independent theories about the root cause.
Prompt 3
Apply the ADHD skill to name this new package from a few different angles.
Prompt 4
Have ADHD score and cluster the ideas it generates for this design decision.

Frequently asked questions

What is adhd?

A skill for AI coding agents that runs several independent reasoning attempts in parallel from different angles, then scores and merges the best ideas.

What language is adhd written in?

Mainly TypeScript. The stack also includes TypeScript, Claude Agent SDK.

What license does adhd use?

Free to use, modify, and redistribute for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is adhd to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is adhd for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.