SystemA

SystemA is an agentic workflow system for Claude Code — a set of composable "skills" that guide your coding agent through structured development workflows.

Forked from obra/superpowers.

How It Works

When you fire up Claude Code with SystemA installed, it doesn't just jump into writing code. Instead, it follows a structured workflow:

1. Design first — Asks what you're really trying to build, teases out a spec, shows it in digestible chunks for validation
2. Plan second — Creates an implementation plan clear enough for execution, emphasizing TDD, YAGNI, and simplicity
3. Execute systematically — Dispatches fresh subagents per task with two-stage review (spec compliance + code quality)

The agent checks for relevant skills before any action. These are mandatory workflows, not suggestions.

Tagline: "You have a system."

Installation

Prerequisites

• Claude Code CLI installed
• Git

Setup

1. Clone this repository:

   git clone https://github.com/hluisi/SystemA.git ~/Projects/SystemA
   

2. Install the plugin:

   # In Claude Code, run:
   /plugin ~/Projects/SystemA
   

   Then restart Claude Code to load the plugin.

3. Set up the session hook:

   mkdir -p ~/.claude/hooks
   cat > ~/.claude/hooks/systema-session-start.sh << 'EOF'
   #!/usr/bin/env bash
   SYSTEMA_ROOT="${HOME}/Projects/SystemA"
   SKILL_FILE="${SYSTEMA_ROOT}/skills/using-systema/SKILL.md"
   
   if [[ -f "$SKILL_FILE" ]]; then
     CONTENT=$(cat "$SKILL_FILE")
     ESCAPED=$(echo "$CONTENT" | jq -Rs .)
     echo "{\"additionalContext\": \"<EXTREMELY_IMPORTANT>\\nYou have a system.\\n\\n**Below is the full content of your 'systema:using-systema' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\\n\\n---\\n${ESCAPED:1:-1}\\n</EXTREMELY_IMPORTANT>\"}"
   fi
   EOF
   chmod +x ~/.claude/hooks/systema-session-start.sh
   

4. Register the hook in Claude Code settings (~/.claude/settings.json):

   {
     "hooks": {
       "SessionStart": [
         {
           "matcher": "",
           "hooks": [
             {
               "type": "command",
               "command": "~/.claude/hooks/systema-session-start.sh"
             }
           ]
         }
       ]
     }
   }
   

5. Restart Claude Code.

Verify Installation

Start a new Claude Code session. You should see "You have a system." in the context.

The Workflow

designing → planning → building → finishing
    ↓           ↓          ↓           ↓
  WHAT        HOW     subagents    merge/PR

Core Skills

Skill	Purpose
using-systema	Introduction to the skills system
designing	Refines rough ideas into validated design documents
planning	Creates detailed implementation plans with bite-sized tasks
building	Dispatches fresh subagent per task with two-stage review
test-driven-development	Enforces RED-GREEN-REFACTOR cycle
verification-before-completion	Ensures fixes actually work
debugging	4-phase root cause investigation

Git/Workspace Skills

Skill	Purpose
using-git-branch	Simple branch creation with baseline verification
using-git-worktrees	Isolated workspace creation for parallel work
finishing	Merge/PR decision workflow

Collaboration Skills

Skill	Purpose
dispatching-parallel-agents	Concurrent subagent workflows
requesting-code-review	Pre-review checklist
receiving-code-review	Technical rigor when receiving feedback

Meta Skills

Skill	Purpose
creating-skills	Create new skills following best practices

Commands

Command	Invokes
/brainstorm	systema:designing
/write-plan	systema:planning
/execute-plan	systema:building

Philosophy

• Design before code — Validate what you're building before how
• Test-driven development — Write tests first, always
• Systematic over ad-hoc — Process over guessing
• Evidence over claims — Verify before declaring success
• Fresh context per task — Subagents prevent context pollution

Contributing

Skills live in skills/. To contribute:

1. Fork the repository
2. Create a branch for your skill
3. Follow skills/creating-skills/SKILL.md for creating and testing
4. Submit a PR

Updating

cd ~/Projects/SystemA && git pull

License

MIT License — see LICENSE file.

Upstream

This project is a fork of obra/superpowers. See the upstream repository for the original project and community.