ai-context: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code when working with code in this repository.

Repository Purpose

AI Context is a collection of Claude Code plugins designed to enhance developer productivity when working with LLMs. The plugins can be installed into other projects to provide standardized AI interaction patterns.

Repository Structure

ai-context/
├── plugins/
│   ├── ruby-rails/      # Ruby/Rails development (13 skills, 3 commands, 1 agent)
│   ├── ghpm/            # GitHub Project Management (10 commands, 1 agent)
│   ├── js-ts/           # JavaScript/TypeScript (3 skills, 1 command)
│   ├── devops/          # DevOps & infrastructure (3 skills, 1 command)
│   ├── general/         # General utilities (1 skill)
│   ├── sandi/           # Sandi Metz OO design advisor (1 skill, 2 commands, 1 workflow template)
│   └── fowler/          # Martin Fowler refactoring advisor (1 skill, 2 commands, 1 workflow template)
└── tools/               # Helper scripts

Plugin Structure

Each plugin follows this structure:

plugins/<name>/
├── README.md
├── .claude-plugin/
│   └── plugin.json      # Plugin manifest
├── skills/              # SKILL.md files with references/
├── commands/            # Slash command definitions
├── agents/              # Agent configurations
└── templates/           # Installable file templates (e.g. GitHub workflows)

Key Plugins

ruby-rails

Ruby on Rails development toolkit with skills for Rails, Ruby, RSpec, code quality tools, and Sandi Metz principles.

ghpm

GitHub Project Management workflow:

1. /ghpm:create-prd - Create product requirements document
2. /ghpm:create-epics - Break PRD into epics
3. /ghpm:create-tasks - Break epics into tasks
4. /ghpm:tdd-task - Execute task using TDD

js-ts

JavaScript/TypeScript toolkit with ESLint, Vitest, and unit testing skills.

devops

DevOps toolkit with GitHub Actions, Kamal deployment, and Tailscale skills.

sandi

Object-oriented design advisor channeling Sandi Metz's philosophy (POODR, 99 Bottles of OOP). The /sandi command auto-detects whether you want planning, code review, refactoring, or design advice. Language-agnostic. /sandi:install-review installs a GitHub Actions workflow (from templates/sandi-review.yml) that runs a Sandi review on every PR via claude-code-action.