Claude Code Plugins

Community-maintained marketplace

Feedback

Algorithm

@edheltzel/atlas
1
0

Universal execution engine using scientific method to achieve ideal state. USE WHEN complex tasks, multi-step work, "run the algorithm", "use the algorithm", OR any non-trivial request that benefits from structured execution with ISC (Ideal State Criteria) tracking.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name Algorithm
description Universal execution engine using scientific method to achieve ideal state. USE WHEN complex tasks, multi-step work, "run the algorithm", "use the algorithm", OR any non-trivial request that benefits from structured execution with ISC (Ideal State Criteria) tracking.

THE ALGORITHM - Universal Execution Engine

PURPOSE: Produce euphoric, highly surprising, exceptional results that solve the problem better than expected.

PHILOSOPHY: Move from current state to ideal state using the scientific method. The ISC (Ideal State Criteria) captures what "ideal" looks like, which we execute against, verify against, and iterate against until achieved.

CORE PRINCIPLE: Effort classification determines which capabilities are available. Higher effort unlocks more powerful tools.

Visual Display & Voice Notifications

Use the LCARS-style AlgorithmDisplay for visual feedback and voice announcements:

# Start algorithm with effort level (shows banner + announces via voice)
bun run ~/.claude/skills/Algorithm/Tools/AlgorithmDisplay.ts start THOROUGH -r "your request"

# Transition phases (updates display + voice announcement)
bun run ~/.claude/skills/Algorithm/Tools/AlgorithmDisplay.ts phase THINK
bun run ~/.claude/skills/Algorithm/Tools/AlgorithmDisplay.ts phase EXECUTE

# Show current status anytime
bun run ~/.claude/skills/Algorithm/Tools/AlgorithmDisplay.ts show

# Show just the effort banner
bun run ~/.claude/skills/Algorithm/Tools/AlgorithmDisplay.ts effort DETERMINED

Phase Icons: OBSERVE -> THINK -> PLAN -> BUILD -> EXECUTE -> VERIFY -> LEARN

Quick Start

# 1. START WITH VISUAL DISPLAY (shows banner + voice announcement)
bun run ~/.claude/skills/Algorithm/Tools/AlgorithmDisplay.ts start STANDARD -r "your request"

# 2. CLASSIFY EFFORT (if not using display start)
bun run ~/.claude/skills/Algorithm/Tools/EffortClassifier.ts --request "your request"
# Or with override: --override DETERMINED
# Or inline: "algorithm effort THOROUGH: your request"

# 3. CREATE ISC
bun run ~/.claude/skills/Algorithm/Tools/ISCManager.ts create --request "your request"

# 4. TRANSITION PHASES (voice + visual update)
bun run ~/.claude/skills/Algorithm/Tools/AlgorithmDisplay.ts phase THINK
bun run ~/.claude/skills/Algorithm/Tools/AlgorithmDisplay.ts phase PLAN
# ... continues through EXECUTE, VERIFY, LEARN

# 5. MANAGE ISC during EXECUTE
bun run ~/.claude/skills/Algorithm/Tools/ISCManager.ts capability --row 1 -c research.perplexity
bun run ~/.claude/skills/Algorithm/Tools/ISCManager.ts update --row 1 --status DONE
bun run ~/.claude/skills/Algorithm/Tools/ISCManager.ts show

Effort to Capability Matrix

Effort Models Thinking Debate Research Agents Parallel
TRIVIAL - - - - - 0
QUICK haiku - - - Intern 1
STANDARD haiku, sonnet UltraThink, FirstPrinciples - 1 agent Engineer, QA, Designer 1-3
THOROUGH haiku, sonnet All Council parallel All + Architect, Pentester 3-5
DETERMINED all + opus All Council + RedTeam all unlimited 10

ISC Scale

Scale When Examples
5-10 rows Quick fixes, simple features "Fix typo", "Add button"
20-50 rows Standard development work "Add dark mode", "Create API endpoint"
50-200 rows Complex features, refactors "Redesign auth system", "Add new major feature"
200-1000+ rows Major projects, DETERMINED effort "Build entire system", "Security audit"

The 7 Phases

Execute IN ORDER. Each phase mutates the ISC:

Phase Action ISC Mutation Gate Question
OBSERVE Understand request + user context CREATE rows Do I have 2+ rows? Used context to infer?
THINK Ensure nothing missing COMPLETE rows All rows clear, testable?
PLAN Sequence + assign capabilities ORDER rows + ASSIGN capabilities Dependencies mapped? Capabilities assigned?
BUILD Make rows testable REFINE rows Each row specific enough to verify?
EXECUTE Do the work (spawn agents per capability) ADVANCE status Every row has final status?
VERIFY Test each DONE row (skeptical agent) CONFIRM status Tested/confirmed each completion?
LEARN Output for user to rate OUTPUT results User rates for memory system

The ISC Table

## ISC: Request Summary

**Request:** Add dark mode to the settings page
**Effort:** STANDARD | **Phase:** EXECUTE | **Iteration:** 1

| # | What Ideal Looks Like | Source | Capability | Status |
|---|----------------------|--------|------------|--------|
| 1 | Research good patterns | INFERRED | research.perplexity | PENDING |
| 2 | Toggle component works | EXPLICIT | execution.engineer | ACTIVE |
| 3 | Theme state persists | EXPLICIT | execution.engineer | PENDING |
| 4 | Uses TypeScript | INFERRED | - | DONE |
| 5 | Tests pass | IMPLICIT | verification.qa | PENDING |

Source types:

  • EXPLICIT - User literally said this
  • INFERRED - Derived from user context (tech stack preferences, etc.)
  • IMPLICIT - Universal standards (security, quality)

Status progression:

  • PENDING -> ACTIVE -> DONE
  • ADJUSTED - Modified with reason
  • BLOCKED - Cannot achieve, triggers loop-back

Iteration Loop

When VERIFY finds issues:

BLOCKED row
    |
    +- Unclear what ideal looks like? -> Loop to THINK
    +- Wrong approach? -> Loop to PLAN
    +- Execution error? -> Loop to EXECUTE

Iteration count bounded by effort level:
- QUICK: 1 iteration max
- STANDARD: 2 iterations
- THOROUGH: 3-5 iterations
- DETERMINED: Unlimited until success

Integration

Uses

  • Agents Skill - AgentFactory for dynamic agent composition
  • CORE Skill - User context for ISC inference
  • Browser Skill - Web verification in VERIFY phase
  • DeepPlan Skill - Persistent planning integration

Memory

  • ISC artifacts: ~/.claude/MEMORY/Work/{session}/ISC.md
  • Learnings: ~/.claude/MEMORY/Learning/ALGORITHM/
  • State: ~/.claude/MEMORY/State/algorithm-state.json

Workflow Routing

Trigger Action
"run the algorithm" Full execution
"use the algorithm" Full execution
"algorithm effort LEVEL" Force effort level + full execution
Complex multi-step request Auto-invoke if appropriate

Files

File Purpose
Tools/AlgorithmDisplay.ts LCARS visual display + voice announcements
Tools/EffortClassifier.ts Classify TRIVIAL->DETERMINED
Tools/ISCManager.ts Create/update/query ISC with capabilities

The Purpose

Produce euphoric, highly surprising, exceptional results that solve the user's problem better than expected.

The ISC captures what "ideal" looks like. Effort determines available capabilities. Execute against it. Verify against it. Iterate until achieved.