reason

Evaluate development ideas by design latitude, reversibility, and blast radius.

Updated Jul 9, 2026
One-click install
npx skills add https://github.com/Covcloud-LLC/adhd-workflow --skill reason-covcloud-llc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reason
Source: https://github.com/Covcloud-LLC/adhd-workflow/tree/main/skills/reason
Command: npx skills add https://github.com/Covcloud-LLC/adhd-workflow --skill reason-covcloud-llc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents the common pitfall of rushing into AI-assisted development without a sound plan, ensuring that only well-reasoned ideas proceed to execution.

Core Features & Use Cases

  • Idea Triage: Categorizes tasks into clear, reasoned, or workshop-required based on design latitude and blast radius.
  • Decision Documentation: Automatically generates reasoning notes to prevent re-litigating decisions in future sessions.
  • Use Case: When you have a complex feature idea, use this skill to determine if it needs a design workshop or if it is ready for immediate planning, ensuring your AI agent stays focused and aligned with your architectural goals.

Quick Start

Ask the AI to reason about the current idea in the docs ideas directory to determine if it is ready for planning.

Frequently Asked Questions about reason

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is idea triage in AI development workflows?

Idea triage evaluates development concepts by design latitude, reversibility, and blast radius to determine if they are ready for planning or require a workshop. It gates progress between ideation and execution to prevent rushing into AI-assisted development without sound architectural reasoning.

How do I evaluate if a feature idea is ready for planning?

To evaluate feature readiness for planning, assess the idea's design latitude and blast radius to categorize it as clear, reasoned, or workshop-required. This structured decision-making protocol prevents re-litigating decisions and ensures AI agents stay aligned with architectural goals.

Why does my AI agent lose focus during complex feature development?

Your AI agent loses focus when progressing untriaged ideas into execution. Implementing a reasoning gate evaluates blast radius and reversibility first, automatically generating decision documentation to maintain project consistency across future sessions.

Do I need a repository docs root to use structured decision-making protocols?

Yes, a repository docs root is required for structured decision-making protocols. The system resolves documentation directories to automatically generate reasoning notes, ensuring project consistency and preventing the re-litigation of architectural decisions in future sessions.

When should I use an ideation gating mechanism versus direct execution?

Use an ideation gating mechanism when facing complex feature ideas with significant blast radius or low reversibility. It categorizes tasks requiring a design workshop versus those ready for immediate planning, preventing architectural drift in AI-assisted development.

Can I document architectural decisions automatically during the triage process?

Yes, you can document architectural decisions automatically during the triage process. The mechanism generates reasoning notes as it evaluates design latitude and blast radius, permanently recording the structured decision-making protocol outcomes to prevent future re-litigation.