Skip to content
clarity logo

Clarity System

clarity

Establish clarity before starting work. Use when beginning any significant task, when input is vague or stream-of-consciousness, or when requirements seem unclear. Handles messy voice input efficiently. This is the first system in the 5-system framework.

SKILL.md

Full skill instructions

Clarity System

Purpose: Never start significant work without shared understanding. When to trigger: Beginning any task, feature, fix, or when confusion arises.


Messy Input Protocol (Token-Efficient)

When to use: Only when input is vague, stream-of-consciousness, or unclear. When to skip: If the request is already clear, go straight to execution.

The Process

  1. Listen fully - Let the user finish their thought
  2. Extract core intent in 2-3 lines max:
    WHAT: [one line]
    WHY: [one line, if apparent]
    SCOPE: [brief bounds, if mentioned]
    
  3. Confirm briefly: "Is that right?"
  4. If gaps exist: Ask 1-2 specific questions (not a list of 10)
  5. Once confirmed: Execute immediately - don't over-document

Example

User: "I want to like... maybe add something where users can
      see their stuff performing, you know what I mean?"

Claude: "Got it:
        WHAT: Add performance metrics for articles
        WHY: Users want to see if content is working

        Should this use GSC data or something else?"

User: "Yeah GSC"

Claude: [Executes - no further ceremony needed]

Efficiency Rules

  • Clear request → Skip this, just do it
  • Slightly unclear → One-line confirm, then do it
  • Very unclear → Extract + confirm + 1-2 questions max
  • Never over-document simple tasks

The Full Clarity Protocol

For significant/​complex work, complete these steps:

Step 1: WHAT (Problem Definition)

Ask and document:

  • What exactly are we trying to accomplish?
  • What does "done" look like? (Specific acceptance criteria)
  • What is the expected outcome?

Step 2: WHY (Context & Impact)

Ask and document:

  • Why does this matter?
  • What's the user/​business impact?
  • What happens if we don't do this?
  • How does this connect to the larger goal?

Step 3: HOW (Constraints & Boundaries)

Ask and document:

  • What technical constraints exist?
  • What's the scope boundary? (What are we NOT doing?)
  • What dependencies exist?
  • What existing code/​patterns must we work with?

Step 4: KNOWN UNKNOWNS

Ask and document:

  • What questions remain unanswered?
  • What assumptions are we making?
  • What could invalidate our approach?
  • What do we need to investigate first?

Output Requirements

After completing the clarity protocol, update .claude/​active-context.md with:

# Active Context

## Current Task
[One sentence description]

## Success Criteria
- [ ] Criterion 1
- [ ] Criterion 2
- [ ] Criterion 3

## Scope Boundaries
**In Scope:**
- Item 1
- Item 2

**Out of Scope:**
- Item 1
- Item 2

## Constraints
- Constraint 1
- Constraint 2

## Open Questions
- Question 1
- Question 2

## Assumptions
- Assumption 1
- Assumption 2

---
*Last updated: [timestamp]*

Rules

  1. Never skip clarity for significant work - Even if it seems obvious, document it
  2. Ask before assuming - If requirements are ambiguous, ask the user
  3. Update when scope changes - If understanding evolves, update active-context.md
  4. Reference SOURCE_OF_TRUTH.md - Check existing project context before starting

Transition

Once clarity is established:

  • If there might be blockers → Proceed to Identity System
  • If priorities are unclear → Proceed to Priority System
  • If everything is clear → Proceed to Execution System

This is System 1 of 5: Clarity → Identity → Priority → Execution → Reset

More Productivity & Planning skills

brainstorming logo
Productivity & Planning

brainstorming

Structured design dialogue that validates ideas before implementation begins.

295.4K 385.7K
View
ui-ux-pro-max logo
Productivity & Planning

ui-ux-pro-max

Comprehensive design intelligence for web and mobile UI/UX across 10 technology stacks.

133.1K 383.9K
View
writing-plans logo
Productivity & Planning

writing-plans

Comprehensive implementation plans for multi-step tasks, breaking down specs into bite-sized, testable steps.

295.4K 268K
View
using-superpowers logo
Productivity & Planning

using-superpowers

Introduction to the obra skills system with mandatory skill invocation rules and best practices.

295.4K 259.8K
View
executing-plans logo
Productivity & Planning

executing-plans

Execute a written implementation plan with critical review and task checkpoints.

295.4K 229.1K
View
dispatching-parallel-agents logo
Productivity & Planning

dispatching-parallel-agents

Delegate independent tasks to specialized agents working concurrently with isolated context.

295.4K 206.3K
View
using-git-worktrees logo
Productivity & Planning

using-git-worktrees

Isolated git worktrees with smart directory selection and safety verification.

295.4K 205.2K
View
webapp-testing logo
Productivity & Planning

webapp-testing

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.

179.7K 170.6K
View
content-strategy logo
Productivity & Planning

content-strategy

Plan searchable and shareable content that drives traffic, builds authority, and generates leads.

53.3K 150.9K
View
repo-intake-and-plan logo
Productivity & Planning

repo-intake-and-plan

README-first repository scanner that extracts commands and classifies reproduction candidates without executing them.

497 139.6K
View
marketing-ideas logo
Productivity & Planning

marketing-ideas

Brainstorm and prioritize marketing strategies tailored to your SaaS stage, budget, and goals.

53.3K 137.2K
View
site-architecture logo
Productivity & Planning

site-architecture

Plan and optimize your website's page hierarchy, navigation, URL structure, and internal linking.

53.3K 112.8K
View

Productivity AI tools

Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View
SaveDay logo
Productivity

SaveDay

Capture, organize, and utilize your knowledge effortlessly.

Free
View
Any Summary logo
Productivity

Any Summary

Instant Summaries of Audio & Video Interviews with AnySummary

Freemium
View
M
Productivity

Map This

Transform PDFs into engaging mind maps.

Freemium
View
ChatPDF logo
Productivity

ChatPDF

Chat with any PDF instantly

Free
View
I
Productivity

intellisay

Create an optimal daily plan using your voice

Paid
View
A
Productivity

Aurora AI

A productivity platform to centralize organizational knowledge and workflows with contextual AI assistance.

Paid
View
AskYourPDF logo
Productivity

AskYourPDF

AskYourPDF Pricing Plans: Tailored to Your Needs

Free
View