Skip to content

INSTALL.md

Latest commit

 

History

History
71 lines (46 loc) · 2.42 KB

INSTALL.md

File metadata and controls

71 lines (46 loc) · 2.42 KB
Raw

SystemsThinking — Installation Guide

For AI agents installing this pack into a user's PAI infrastructure.

AI Agent Instructions

Use Claude Code's native tools (AskUserQuestion, TodoWrite, Bash, Read, Write) to walk the user through this wizard.

Welcome Message

"I'm installing the SystemsThinking skill from the PAI v5.0.0 release.

Structural analysis of complex systems grounded in Donella Meadows, Peter Senge, Jay Forrester, Russell Ackoff, and the Santa Fe Institute tradition. Five workflows: Iceberg (walk Events → Patterns → Structures → Mental Models to find why the same thing keeps happening), CausalLoop (build causal loop diagrams with reinforcing R and balancing B loops), FindArchetype (match behavior to ~10 canonical patterns — Limits to Growth, Shifting the Burden, Tragedy of the Commons, Fixes That Fail, etc. — then apply the documented canonical intervention), FindLeverage (Meadows' 12 leverage points ordered by impact — parameters are weakest, paradigm transcendence is strongest), ConceptMap (Novak-style entity-relationship mapping). Core axiom: behavior is generated by structure; events are visible, structure is not. At Extended+ effort on anything with recurring behavior or cross-component coupling, systems thinking is the structural lens, not optional enrichment.

Let me check your system and install."

Phase 1: System Analysis

CLAUDE_DIR="$HOME/.claude"
SKILL_DIR="$CLAUDE_DIR/skills/SystemsThinking"

if [ -d "$SKILL_DIR" ]; then
  echo "EXISTING SystemsThinking skill found at $SKILL_DIR — will back up before install"
else
  echo "Clean install — no existing SystemsThinking skill"
fi

Phase 2: Confirm with User

Ask the user (use AskUserQuestion):

  1. "Install SystemsThinking into ~/.claude/skills/SystemsThinking/? (yes/no)"
  2. If existing skill found: "Back up the existing SystemsThinking to ~/.claude/skills/SystemsThinking.backup-{timestamp}/ first? (yes/no — recommend yes)"

Phase 3: Backup (only if existing)

if [ -d "$SKILL_DIR" ]; then
  BACKUP="$SKILL_DIR.backup-$(date +%Y%m%d-%H%M%S)"
  mv "$SKILL_DIR" "$BACKUP"
  echo "Backed up to $BACKUP"
fi

Phase 4: Install

mkdir -p "$CLAUDE_DIR/skills"
cp -R src/ "$SKILL_DIR/"
echo "Installed to $SKILL_DIR"

Phase 5: Verify

Run the file and functional checks in VERIFY.md. Confirm to the user when all checks pass.