██████╗  ██████╗ ████████╗ █████╗ ██╗
██╔══██╗██╔═══██╗╚══██╔══╝██╔══██╗██║
██║  ██║██║   ██║   ██║   ███████║██║
██║  ██║██║   ██║   ██║   ██╔══██║██║
██████╔╝╚██████╔╝   ██║   ██║  ██║██║
╚═════╝  ╚═════╝    ╚═╝   ╚═╝  ╚═╝╚═╝

Agent Instructions

Uses ruler for centralized AI agent config. Instructions in .claude/rules/ (MDC files with frontmatter). ruler apply generates CLAUDE.md/AGENTS.md and Skills from rules.

Quick Start

Fastest Setup

npx shadcn@latest add https://raw.githubusercontent.com/udecode/dotai/main/registry/all.json

Then, restart claude.

This installs all project files and configures Claude Code to auto-install the marketplace and plugins.

Manual Setup

Add marketplace and plugins (interactive):

/plugin marketplace add udecode/dotai

Restart Claude Code, then install all plugin files:

/dotai:install-all

Available Plugins

🛠️ dotai

Complete development toolkit - documentation, PRDs, debugging, PR workflows, and planning.

Installation:

/plugin install dotai@dotai
# restart claude
/dotai:install

Features:

• Documentation - Generate and maintain app design and tech stack docs
• PR Management - Full PR creation with reviews and draft mode
• Planning - Implementation planning and log monitoring

Key Commands:

/dotai:create-app-design       # Generate design documentation
/dotai:opus <prompt>           # Run task with Opus model

Full Plugin Documentation →

🎓 skills

Meta-skills for finding, using, and writing Agent Skills - enforces skill usage protocols and provides skill authoring guidance.

Installation:

/plugin install skills@dotai
# restart claude

Features:

• Using Skills - Mandatory protocols for skill discovery and usage
• Writing Skills - TDD approach to skill authoring
• No Rationalization - Prevents common excuses for skipping skills

Key Command:

/skills:skills   # Enforce skill usage protocols

Skills (auto-invoked):

• using-skills - Mandatory workflows for finding and using skills
• writing-skills - TDD-based skill authoring process

Full Plugin Documentation →

📋 plan

Planning and brainstorming workflows for software development - helps refine ideas into designs and create detailed implementation plans.

Installation:

/plugin install plan@dotai
# restart claude

Features:

• Brainstorming - Transform rough ideas into fully-formed designs
• Writing Plans - Create comprehensive implementation plans with TDD approach
• Executing Plans - Batch execution with review checkpoints

Key Commands:

/plan:brainstorm      # Interactive design refinement (Opus)
/plan:write-plan     # Create implementation plan (Opus)
/plan:execute-plan   # Execute plan with checkpoints

Skills (auto-invoked):

• brainstorming - Refine ideas through collaborative questioning
• writing-plans - Create detailed task breakdowns
• executing-plans - Execute plans in controlled batches

Full Plugin Documentation →

✅ prompt

Dynamic prompt injection system with before-start and before-complete checklists.

Installation:

The prompt system is automatically installed with the dotai registry (included in Quick Start setup). If you need to install it separately:

npx shadcn@latest add https://raw.githubusercontent.com/udecode/dotai/main/registry/prompt.json

This installs:

• .claude/prompt.json - Configuration file
• .claude/scripts/user-prompt-submit.sh - Hook script for before-start/before-complete
• .claude/scripts/post-compact.sh - Hook script for post-compact recovery
• .claude/scripts/session-start.sh - Hook script for session start events

The hooks are automatically configured in .claude/settings.json when you install the dotai registry.

Features:

• Before-Start Checklists - Enforce reminders before Claude responds
• Before-Complete Checklists - Verification items before claiming completion
• Post-Compact Recovery - Restore context after compaction with afterCompact instructions
• Session Start - Load skills at session start (startup, resume, clear, compact)
• Project-Specific - Configure different prompts per project

Configuration:

Edit .claude/prompt.json:

{
  "beforeStart": [
    {
      "tag": "MANDATORY-FIRST-RESPONSE",
      "header": "🚨 STOP - YOUR FIRST TOOL CALL MUST BE TodoWrite",
      "instructions": [
        "DO NOT analyze the task yet. DO NOT read files. DO NOT edit anything.",
        "YOUR FIRST ACTION: Call TodoWrite with the todo below",
        "Check if the todo's condition applies - if NO, mark completed immediately"
      ],
      "todos": [
        "Skill analysis (SKIP if message contains 'quick'): (1) Check for rationalizations; (2) List ALL available skills; (3) Mark ✓/✗ for each; (4) Load matched skills; (5) Output result"
      ]
    }
  ],
  "beforeComplete": [
    {
      "tag": "VERIFICATION-CHECKLIST",
      "header": "Before claiming work is complete - verify with FRESH evidence:",
      "instructions": [
        "Create TodoWrite with ALL todos below",
        "For EACH todo: Check if condition applies",
        "Work through every todo even if some don't apply"
      ],
      "todos": [
        "TypeScript check (ONLY if updated ts files): Verify no `any` used",
        "Typecheck (ONLY if updated ts files): Run typecheck and verify passes"
      ]
    }
  ]
}

Structure:

• tag - Section identifier
• header - Bold header shown at top of section
• instructions - Operation guidelines (bulleted list)
• todos - TodoWrite checklist items with conditional execution

🚀 agents

Agent orchestration patterns for parallel debugging and investigation - dispatch multiple Claude agents to solve independent problems concurrently.

Installation:

/plugin install agents@dotai
# restart claude

Features:

• Parallel Dispatch - Multiple agents work concurrently on independent problems
• Focused Scope - Each agent has narrow domain to investigate
• Speed - Solve multiple problems in time of one

Key Command:

/agents:parallel   # Dispatch agents for parallel investigation

Skills (auto-invoked):

• dispatching-parallel-agents - Orchestrate multiple agents for concurrent problem-solving

Full Plugin Documentation →

🔍 debug

Systematic debugging and root cause analysis framework - four-phase investigation process ensuring understanding before fixes.

Installation:

/plugin install debug@dotai
# restart claude

Features:

• Systematic Debugging - Four-phase framework (investigate, analyze, test, implement)
• Root Cause Tracing - Trace bugs backward through call stack
• Defense-in-Depth - Add validation at multiple layers

Key Command:

/debug:debug   # Invoke systematic debugging framework

Skills (auto-invoked):

• systematic-debugging - Four-phase debugging process
• root-cause-tracing - Trace backward to find original trigger

Full Plugin Documentation →

🧪 test

Test-driven development workflow for writing tests before implementation - red-green-refactor cycle with deterministic unit tests.

Installation:

/plugin install test@dotai
# restart claude

Features:

• Red-Green-Refactor - Classic TDD workflow
• Smart Test Strategy - Auto-decide when to test based on complexity
• Deterministic Tests - Only unit tests, no complex mocking

Key Command:

/test:tdd   # Test-driven development workflow

Skills (auto-invoked):

• test-driven-development - Write test first, watch it fail, make it pass

Full Plugin Documentation →

🔀 git

Git and GitHub workflow automation - streamlined PR creation, draft management, and code review workflows.

Installation:

/plugin install git@dotai
# restart claude

Features:

• Pull Request Creation - Full PR workflow with automatic incremental reviews
• Draft PR Management - Efficient draft workflow without reviews
• Smart Commits - Conventional commit messages and branch naming

Key Commands:

/git:create-pr   # Create PR with automatic code review
/git:draft-pr    # Create draft PR for work-in-progress

Skills (auto-invoked):

• creating-pr - PR creation with automatic incremental reviews
• drafting-pr - Draft PR management without reviews

Full Plugin Documentation →

🧠 fb

Session memory and continuity for Claude Code.

Installation:

/plugin install fb@dotai
# restart claude
/fb:install

Features:

• Session Continuity - Restore context from previous sessions
• Working Plan - Track development priorities across sessions
• Project Memory - Store important learnings
• Auto-Archiving - Organized session history

Key Commands:

/fb:session-start   # Restore previous context
/fb:save-session    # Save session summary
/fb:remember        # Store important info

Full Plugin Documentation →

🔔 notification

macOS notifications for Claude Code events.

Installation:

/plugin install notification@dotai
# restart claude

Features:

• Get notified when Claude finishes responding
• Ping on compact events

Full Plugin Documentation →

🎵 media

Auto-play/pause media on prompt submit/stop.

Installation:

brew install media-control  # Required
/plugin install media@dotai
# restart claude

Features:

• Auto-play media when submitting prompts
• Auto-pause media when stopping responses
• Works with Spotify, Apple Music, YouTube, etc.

Full Plugin Documentation →

Workflows

1. Initial Setup

After Quick Start, create foundational docs:

# Create foundational docs
/dotai:create-app-design
/dotai:create-tech-stack

2. Daily Workflow

# Plan feature implementation with Opus
/plan:brainstorm      # Refine ideas into designs
/plan:write-plan      # Create implementation plan

/clear

# Start monitoring logs/errors
/watch

# Execute plan with checkpoints with Sonnet
/plan:execute-plan

# Work on features...
# Skills auto-load based on task context

# Create PR
/git:create-pr

# Save session (optional)
/fb:save-session

Development

See CONTRIBUTING.md.

License

MIT