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
What's included:
- sc-core: Intent-based commands and specialized agents for planning, implementation, exploration, and review
- sc-hooks (optional): Session management, tool monitoring, plan review gating, and notification hooks
- 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
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
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
/sc-hooks:sc-sounds # Configure notification sounds
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
Agent System
Each command automatically spawns appropriate agents:
sc-code-explorer - Traces execution paths and maps architecturesc-code-architect - Designs feature architectures from existing patternssc-code-reviewer - Reviews code for bugs, security, and convention adherencesc-research-github - Searches across GitHub to compare libraries, evaluate projects, and find issues/PRssc-research-repo - Clones and searches a specific library's repo for docs, APIs, and source codesc-research-web - Searches the web for news, blogs, tutorials, and community discussions
Project Structure
kylesnowschwartz