SimpleClaude

A practical minimalist AI assistant framework that transforms complex AI interactions into natural conversations. Comes with a set of user-commands, sub-agents, hooks, and utilities designed for real-world software development tasks. Completely dogfooded by its creator for building production software in the workplace and for personal projects. Expect frequent updates, enhancements, and breaking changes.

Installation

Option 1: Direct from GitHub (Recommended)

Install SimpleClaude plugins directly from the commandline:

claude plugin marketplace add https://github.com/kylesnowschwartz/SimpleClaude
claude plugin install sc-core
claude plugin install sc-hooks
claude plugin install sc-output-styles
claude plugin install sc-extras
claude plugin install sc-skills
claude plugin install sc-refactor
claude plugin install sc-mods

What's included:

• sc-core: Intent-based commands and specialized agents for planning, implementation, exploration, and review
• sc-hooks (optional): Auto-formatting and lint checks on stop, plus tool monitoring (steers GitHub WebFetch to the gh CLI)
• sc-output-styles (optional): Curated output styles — personality-driven (Linus, Austen, Lovelace, Ousterhout, Starfleet, Mayo Clinic) and structured formats (HTML, JSON, Markdown, Semantic Markdown, YAML)
• sc-extras (optional): Utility commands for root cause analysis, claim verification, adversarial analysis, and context wizards
• sc-skills (optional): Mermaid diagrams, codebase pattern detection, hypothesis testing, Socratic thinking, file querying, frontend design, image generation, and command generation
• sc-refactor (optional): PR review with ticket integration, codebase health checks, and specialized analysis agents for refactoring workflows
• sc-mods (optional): Claude Code mods. Draws mermaid diagrams in replies as Unicode text in the terminal. See plugins/sc-mods/README.md

Updating

Via Claude Code CLI

claude plugin marketplace update simpleclaude
claude plugin install sc-core@simpleclaude
claude plugin install sc-hooks@simpleclaude
claude plugin install sc-output-styles@simpleclaude
claude plugin install sc-extras@simpleclaude
claude plugin install sc-skills@simpleclaude
claude plugin install sc-refactor@simpleclaude
claude plugin install sc-mods@simpleclaude

Quick Start

# Core development commands
/sc-core:sc-plan "How should I add authentication to this app?"
/sc-core:sc-work "Add JWT authentication with login/logout"
/sc-core:sc-explore "How does the current database layer work?"
/sc-core:sc-review "Check security vulnerabilities in auth module"
/sc-core:sc-workflow "Start structured development for OAuth support"

# PR review and refactoring
/sc-refactor:sc-review-pr 42              # Full PR review with ticket context
/sc-refactor:sc-pr-comments 42            # Fetch unresolved PR comments
/sc-refactor:sc-resolve-pr-parallel 42    # Batch resolve PR feedback
/sc-refactor:sc-cleanup src/              # Post-AI session cleanup
/sc-refactor:sc-codebase-health src/      # Full codebase health analysis

# Utilities
/sc-extras:sc-five-whys                   # Root cause analysis
/sc-skills:sc-mermaid flowchart auth      # Generate architecture diagrams
/sc-extras:sc-validate-task               # Validate completed work
/sc-skills:sc-worktrees                   # Manage git worktrees

Architecture

SimpleClaude uses a lightweight agent architecture with intent-based commands:

• Command Structure: Intent-based interfaces that understand user goals (plan, work, explore, review, workflow)
• Specialized Agents: Context-specific assistants spawned via Task() calls
• Token-Efficient Design: Agents work in isolation with focused context
• Clean Separation: Commands understand intent, agents execute specialized tasks

Runtime configuration (environment variables) for sc-hooks is documented at plugins/sc-hooks/README.md.

Agent System

Each command automatically spawns appropriate agents:

• sc-code-explorer - Traces execution paths and maps architecture
• sc-code-architect - Designs feature architectures from existing patterns
• sc-code-reviewer - Reviews code for bugs, security, and convention adherence
• sc-research-github - Searches across GitHub to compare libraries, evaluate projects, and find issues/PRs
• sc-research-repo - Clones and searches a specific library's repo for docs, APIs, and source code
• sc-research-web - Searches the web for news, blogs, tutorials, and community discussions

Project Structure

SimpleClaude/
├── plugins/
│   ├── sc-core/        # Core plugin: commands & agents
│   ├── sc-hooks/                 # Hooks plugin: auto-format, lint, tool monitoring
│   ├── sc-output-styles/         # Output styles plugin: personality & structured formats
│   ├── sc-extras/                # Extras plugin: utility commands
│   ├── sc-skills/                # Skills plugin: diagrams, patterns, design, querying
│   ├── sc-refactor/              # Refactor plugin: PR review & analysis agents
│   └── sc-mods/                  # Mods plugin: mermaid diagrams drawn in the terminal
├── scripts/
│   ├── install.rb                # Installation/update script
│   ├── fetch-merman.sh           # Downloads the merman binaries sc-mods runs
│   └── publish-mods-dist.sh      # Publishes sc-mods to the sc-mods-dist branch
├── docs/                         # Documentation
└── README.md                     # This file

Acknowledgments

SimpleClaude was inspired by SuperClaude which demonstrated effective patterns for natural language command interfaces. SimpleClaude builds on concepts pioneered by the SuperClaude project and I thank NomenAK for putting in the hard yards with SuperClaude - an awesome project with powerful features.

{
  "name": "simpleclaude",
  "metadata": {
    "version": "7.10.0",
    "description": "Practical minimalist AI assistant framework with specialized agents"
  },
  "owner": {
    "name": "Kyle Snow Schwartz",
    "url": "https://github.com/kylesnowschwartz"
  },
  "plugins": [
    {
      "name": "sc-core",
      "description": "Core SimpleClaude framework with intent-based commands and specialized agents for token-efficient execution",
      "version": "7.10.0",
      "author": {
        "name": "Kyle Snow Schwartz"
      },
      "source": "./plugins/sc-core",
      "homepage": "https://github.com/kylesnowschwartz/SimpleClaude",
      "repository": "https://github.com/kylesnowschwartz/SimpleClaude",
      "license": "MIT",
      "category": "productivity",
      "keywords": [
        "ai",
        "assistant",
        "agents",
        "workflow",
        "claude-code",
        "architecture",
        "productivity",
        "planning",
        "lightweight",
        "token-efficient"
      ]
    },
    {
      "name": "sc-hooks",
      "description": "SimpleClaude hooks for auto-formatting, lint checks, and tool monitoring",
      "version": "7.10.0",
      "author": {
        "name": "Kyle Snow Schwartz"
      },
      "source": "./plugins/sc-hooks",
      "homepage": "https://github.com/kylesnowschwartz/SimpleClaude",
      "repository": "https://github.com/kylesnowschwartz/SimpleClaude",
      "license": "MIT",
      "category": "automation",
      "keywords": [
        "hooks",
        "automation",
        "formatting",
        "linting",
        "claude-code"
      ]
    },
    {
      "name": "sc-extras",
      "description": "Optional SimpleClaude utilities for root cause analysis, claim verification, adversarial analysis, and context wizards",
      "version": "7.10.0",
      "author": {
        "name": "Kyle Snow Schwartz"
      },
      "source": "./plugins/sc-extras",
      "homepage": "https://github.com/kylesnowschwartz/SimpleClaude",
      "repository": "https://github.com/kylesnowschwartz/SimpleClaude",
      "license": "MIT",
      "category": "productivity",
      "keywords": [
        "utilities",
        "root-cause-analysis",
        "adversarial",
        "verification",
        "workflow",
        "claude-code"
      ]
    },
    {
      "name": "sc-output-styles",
      "description": "Curated output styles for Claude Code: personality-driven and structured formats",
      "version": "7.10.0",
      "author": {
        "name": "Kyle Snow Schwartz"
      },
      "source": "./plugins/sc-output-styles",
      "homepage": "https://github.com/kylesnowschwartz/SimpleClaude",
      "repository": "https://github.com/kylesnowschwartz/SimpleClaude",
      "license": "MIT",
      "category": "productivity",
      "keywords": [
        "output-styles",
        "personality",
        "formatting",
        "structured-output",
        "claude-code"
      ]
    },
    {
      "name": "sc-skills",
      "description": "Skills and agents for diagrams, codebase patterns, hypothesis testing, Socratic thinking, file querying, frontend design, image generation, and command creation",
      "version": "7.10.0",
      "author": {
        "name": "Kyle Snow Schwartz"
      },
      "source": "./plugins/sc-skills",
      "homepage": "https://github.com/kylesnowschwartz/SimpleClaude",
      "repository": "https://github.com/kylesnowschwartz/SimpleClaude",
      "license": "MIT",
      "category": "development",
      "keywords": [
        "skills",
        "mermaid",
        "patterns",
        "frontend",
        "design",
        "image-generation",
        "hypothesis-testing",
        "file-querying",
        "claude-code"
      ]
    },
    {
      "name": "sc-refactor",
      "description": "Unified review, refactoring, PR comment resolution, and cleanup workflows with specialized analysis agents",
      "version": "7.10.0",
      "author": {
        "name": "Kyle Snow Schwartz"
      },
      "source": "./plugins/sc-refactor",
      "homepage": "https://github.com/kylesnowschwartz/SimpleClaude",
      "repository": "https://github.com/kylesnowschwartz/SimpleClaude",
      "license": "MIT",
      "category": "code-quality",
      "keywords": [
        "code-review",
        "refactoring",
        "dead-code",
        "duplication",
        "cleanup",
        "agents",
        "claude-code"
      ]
    },
    {
      "name": "sc-mods",
      "description": "Claude Code mods: draws mermaid diagrams in replies as Unicode text in the terminal",
      "version": "7.10.0",
      "author": {
        "name": "Kyle Snow Schwartz"
      },
      "source": {
        "source": "github",
        "repo": "kylesnowschwartz/SimpleClaude",
        "ref": "sc-mods-dist"
      },
      "homepage": "https://github.com/kylesnowschwartz/SimpleClaude",
      "repository": "https://github.com/kylesnowschwartz/SimpleClaude",
      "license": "MIT",
      "category": "productivity",
      "keywords": [
        "mods",
        "mermaid",
        "diagrams",
        "terminal",
        "claude-code"
      ]
    },
    {
      "name": "sc-mods-dev",
      "description": "sc-mods read from a local SimpleClaude checkout, for development. Run scripts/fetch-merman.sh first.",
      "version": "7.10.0",
      "author": {
        "name": "Kyle Snow Schwartz"
      },
      "source": "./plugins/sc-mods",
      "homepage": "https://github.com/kylesnowschwartz/SimpleClaude",
      "repository": "https://github.com/kylesnowschwartz/SimpleClaude",
      "license": "MIT",
      "category": "productivity",
      "keywords": [
        "mods",
        "mermaid",
        "diagrams",
        "terminal",
        "claude-code"
      ]
    }
  ]
}