ship

Claude AI Configuration

A comprehensive configuration system for Claude AI with custom commands, development principles, and workflow optimizations.

📌 日本語版

🎯 Overview

This repository contains personal configurations for Claude AI, including:

• Custom slash commands for systematic development workflows (47 skills)
• Specialized AI agents for code review, generation, and analysis (38 agents)
• Core AI operation principles and development best practices
• Quality pipeline hooks (guardrails, formatter, reviews, gates)
• Japanese language support

📁 Structure

.claude/
├── CLAUDE.md              # Main configuration (AI reads this)
├── README.md              # This file - Quick start guide
├── adr/                   # Architecture Decision Records
├── rules/                 # Rule definitions
│   ├── core/             # Core AI operation principles
│   ├── conventions/      # Documentation conventions
│   ├── development/      # Development patterns & methodologies
│   ├── frameworks/       # Framework-specific rules
│   └── workflows/        # Workflow guides
├── skills/               # Skill-based knowledge modules (47 skills)
├── agents/               # Specialized AI agents (33 agents)
│   ├── architects/       # Feature architecture designers
│   ├── critics/          # Finding challengers (devils-advocate)
│   ├── enhancers/        # Code enhancers & simplifiers
│   ├── evaluators/       # Quality evaluators
│   ├── explorers/        # Codebase exploration agents
│   ├── generators/       # Code/test/git generators
│   ├── resolvers/        # Build error resolvers
│   ├── reviewers/        # Code review agents (20 reviewers)
│   └── teams/            # Integrators & implementers
├── docs/                  # Design docs & guides
├── hooks/                 # Pre/Post tool-use hooks
├── scripts/               # Utility scripts
├── output-styles/         # Output style definitions
├── .claude-plugin/        # Plugin marketplace config
└── .ja/                   # Japanese translations

🚀 Quick Start

Option 1: Install as Claude Code Plugin (Recommended)

This repository is available as a Claude Code plugin, allowing you to easily install specific workflow sets:

1. Add this repository as a marketplace:

   /plugin marketplace add thkt/dotclaude
   

2. Browse available plugins:

   /plugin
   

3. Install specific plugin (choose one or more):

   /plugin install plan     # /outcome, /think, /research, /probe, /slice
   /plugin install build    # /build, /code, /fix, /swarm, /shake, /prototype
   /plugin install review   # /audit, /polish, /preview, /challenge, /assert
   /plugin install ship     # /commit, /checkout, /pr, /issue
   /plugin install toolkit  # /adr, /adrift, /census, /reflect
   

Available Plugins:

• plan: Planning and design (/outcome for outcome definition, /think for design exploration and SOW/Spec generation, /research for technical investigation, /probe for repository spec extraction, /slice for breaking plans into vertical-slice issues) plus architecture agents
• build: Implementation and testing (/build for end-to-end orchestration, /code, /fix, /swarm with TDD/RGRC cycle and quality gates, /shake for flaky-test detection, /prototype for throwaway prototypes)
• review: Quality and review (/audit, /polish, /preview, /challenge, /assert) with 21 specialized reviewer agents
• ship: Git and release (/commit, /checkout, /pr, /issue)
• toolkit: Utilities and patterns (/adr for decision records, /adrift for ADR-vs-code drift, /census for undocumented-decision discovery, /reflect for session reflection) plus frontend pattern references

Option 2: Manual Installation (Full Configuration)

For using this as your personal .claude configuration:

1. Clone this repository to your home directory:

   git clone https://github.com/thkt/.claude ~/.claude
   

2. Or if you already have a .claude directory, back it up first:

   mv ~/.claude ~/.claude.backup
   git clone https://github.com/thkt/.claude ~/.claude
   

Note: Manual installation includes all commands, agents, rules, and personal configurations. Plugin installation only includes shared commands and agents (excludes personal CLAUDE.md, rules/, and settings.json).

📦 Dependencies & Setup

Sandbox Feature (Optional but Recommended)

Claude Code's sandbox feature provides secure command execution with automatic permission handling, reducing approval fatigue while maintaining safety.

System Requirements:

• macOS or Linux (Windows not yet supported)
• Node.js with npm/npx
• ripgrep (typically pre-installed)
• jaq (for IDR hooks): brew install jaq

Setup:

# 1. Install sandbox runtime
npm install -g @anthropic-ai/sandbox-runtime

# 2. Verify installation
srt --version