thkt-development-workflows

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 (33 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 (17 reviewers)
│   └── teams/            # Integrators & implementers
├── docs/                  # Design docs & guides
├── templates/             # Prompt templates (audit, sow, spec, etc.)
├── 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 complete-workflow-system  # Full TDD/RGRC workflow
   /plugin install quick-actions             # /fix, /polish
   /plugin install git-utilities             # /commit, /branch, /pr, /issue
   /plugin install documentation-tools       # /adr, /docs
   /plugin install browser-workflows         # agent-browser (E2E via /code)
   

Available Plugins:

• complete-workflow-system: Full development workflow with quality gates (/think, /code, /audit, /research, /feature, /swarm)
• quick-actions: Fast bug fixes (/fix), AI slop removal (/polish), config Japanese proofreading (/kousei)
• git-utilities: Git workflow helpers (/commit, /branch, /pr, /issue, /preview)
• documentation-tools: ADR creation (/adr) and domain glossary (/glossary)
• browser-workflows: E2E testing via /code E2E Phase (agent-browser)
• productivity-tools: Inbox aggregation from GitHub, Slack, Calendar (/inbox)
• development-skills: 21 reference skills for TDD, principles, patterns, security, doc lookup, and more

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

# 3. Enable in Claude Code
# Run this command in Claude Code session:
/sandbox
# Select option 1: "Sandbox BashTool, with auto-allow in accept edits mode"

What it does: