Skip to content

jpoindexter/nd-skills / skills/nd-complexity-gate

nd-complexity-gate

Verified

Detect complex or multi-step requests and suggest structured planning before acting. Prevents diving into implementation before the problem is understood.

FileKindSize
SKILL.mdskill md3.2 KB
---
name: nd-complexity-gate
description: Detect complex or multi-step requests and suggest structured planning before acting. Prevents diving into implementation before the problem is understood.
---

# Complexity Gate — Plan Before You Act

## What this addresses

Planning and organization difficulty: for many neurodivergent developers, complex multi-part tasks can trigger one of two failure modes — *paralysis* (not knowing where to start) or *premature execution* (jumping to implementation before understanding the full scope, then having to restart).

Both are costly. The complexity gate catches requests that warrant a plan before any tool call.

## When to apply

Apply this skill when a user request contains two or more of the following signals:

**Scope signals:**
- Mentions multiple files, components, or services
- Uses words like "refactor", "redesign", "rewrite", "migrate", "overhaul"
- References schema changes, database migrations, or API changes
- Implies work across multiple abstraction layers (frontend + backend + database)

**Ambiguity signals:**
- Contains phrases like "somehow", "not sure how", "figure out", "any way to"
- The spec is described in outcomes ("make it work") rather than mechanics
- Multiple possible interpretations exist

**Compound-task signals:**
- Two or more "and then" / "and also" clauses
- Mentions phases, steps, or parts
- Requires coordinating work that could conflict

## Instructions

1. **Score the request.** Silently assess: how many complexity signals are present?

2. **At 2+ signals and plan mode not active:** Before any tool call, emit a one-line note:
   > "⚠ This looks complex ([N] signals). Consider planning the approach before executing — `/planmode` on, or I can outline steps first?"

   If the user already said "just do it," "use your judgment," "do not ask," or supplied a terminal condition, do not turn this note into a question. State that you are structuring the work internally and proceed.

3. **If the user says 'outline steps':** Produce a numbered execution plan with:
   - Each step as a single, concrete, verifiable action
   - Files or commands that will be touched
   - The acceptance criterion for each step
   - Ask "Does this plan look right, or should I adjust before starting?" only when approval of the plan is genuinely required. Otherwise begin the first safe unit.

   Use `$nd-task-decomposition` when dependencies are hidden or the user needs an executable Now/Next/Later surface rather than a high-level plan.

4. **Never block.** If the user says "just do it", proceed immediately. The suggestion is a cognitive scaffold, not a gate.

5. **When plan mode IS active:** Skip the suggestion — the user already chose structured execution.

## Science basis

Planning and organization are direct executive function components. For people with EF challenges, the blank-page problem is often most acute at the START of a complex task. A brief plan — even if modified — provides the scaffolding that makes initiation possible. The alternative (diving in without a plan) often leads to scope drift, rework, and the "I'll just start over" loop.

Environmental manipulation principle: structure the task environment so it's easier to start correctly than to restart.
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall