primitives

Primitives Plugin for Claude Code

Essential building blocks for Claude Code workflows. This plugin provides fundamental slash commands and skills that streamline common development tasks like commits, debugging, PRs, and environment setup.

Installation

# Install from GitHub
/plugin install iamladi/cautious-computing-machine--primitives-plugin

# Or from your local marketplace
/plugins marketplace add iamladi/cautious-computing-machine
/plugin install primitives

Why This Plugin?

Primitives bundles time-saving workflows for repetitive dev tasks:

• Smart commits following conventional commit standards with automatic batching
• Instant debugging context without burning your main window
• Git workflow automation for branches and PRs
• Environment setup with health checks and missing config detection
• Context priming to quickly understand codebases
• Hard problem solving with GPT-5 Pro/5.1 for architectural and complex debugging tasks

Slash Commands

/commit - Smart Commit Specialist

Creates well-organized, atomic commits following conventional commit standards. Automatically batches changes by type and scope.

Features:

• Prevents commits to main/master (creates branch if needed)
• Batches related changes intelligently
• Follows conventional commit format (type(scope): description)
• Never uses git add . - adds files explicitly
• Handles pre-commit hooks gracefully

Usage:

/commit                    # Analyze and commit all changes
/commit "add yaml support" # Use description to inform messages

Output example:

feat(yaml): add MD_YAML mode for YAML extraction
test(yaml): add tests for MD_YAML mode
docs(yaml): document MD_YAML usage

✨ Summary: 3 commits, 8 files changed

/debug - Debugging Assistant

Investigates issues by examining logs, database state, and git history without editing files. Perfect for debugging during manual testing without using your primary window's context.

Parallel Investigation:

• Task 1: Check logs for errors/warnings
• Task 2: Analyze database/backend state
• Task 3: Review git and file state

Usage:

/debug                     # Start debugging session

Requires: DEBUG.md in repo root for project-specific debug info (log locations, database tools, etc.)

/install - Dependency Installation

Verifies tooling (git, gh CLI) and guides through dependency installation with health checks.

Usage:

/install

Checks:

• Git CLI availability
• GitHub CLI (gh) availability and configuration
• Reads INSTALL.md for project-specific setup
• Reports missing/incomplete configurations

/prime - Context Window Primer

Quickly understands and summarizes codebase structure for efficient context loading.

Usage:

/prime

Workflow:

1. Runs git ls-files to see structure
2. Reads README.md
3. Summarizes codebase understanding

/start - Dev Environment Starter

Starts development environment based on project documentation.

Usage:

/start

Features:

• Reads /RUN.md for project-specific start instructions
• If no RUN.md exists, analyzes repo and suggests creating one

/tools - Built-in Tools List

Lists all core, built-in non-MCP development tools available in Claude Code.

Usage:

/tools

Output: Bullet list with TypeScript function syntax showing parameters.

/worktree - Isolated Worktree Creator

Creates an isolated git worktree with automatic setup for feature development. Prevents polluting your main checkout while working on new features.

Features:

• Creates worktrees in hidden .worktrees/ directory
• Automatically updates .gitignore
• Installs dependencies (reads INSTALL.md)
• Notes startup instructions (reads RUN.md)
• Identifies feedback tools (reads FEEDBACK_LOOPS.md)
• Verifies clean test baseline

Usage:

/worktree feat/new-feature    # Create worktree for feature branch
/worktree fix/bug-123         # Create worktree for bug fix

Output:

Creating worktree for feat/new-feature...

[1/6] Checking .gitignore... already configured
[2/6] Creating worktree... done
[3/6] Installing dependencies... bun install complete
[4/6] Checking RUN.md... found
[5/6] Checking FEEDBACK_LOOPS.md... found
[6/6] Running test baseline... 42 tests passed

Worktree ready at .worktrees/feat/new-feature

Skills

karpathy-principles - Coding-with-AI Rails

Loads the four Karpathy coding-with-AI principles in one place — Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution — with pointers to the local skills that enforce each. Use when starting work in this workspace or when the user asks for "the rails" / "the principles". Paraphrased from multica-ai/andrej-karpathy-skills (MIT) — see skills/karpathy-principles/ATTRIBUTION.md.