https://github.com/kai-tecweb/claude-code-standards

Claude Code 開発標準 | 40年以上の経験と5,000以上のプロジェクトから生まれた実戦的なベストプラクティス
https://github.com/kai-tecweb/claude-code-standards

ai-coding aws best-practices claude-code coding-standards developer-tools inertiajs japanese javascript laravel nodejs php react tailwindcss typescript

Last synced: about 2 months ago
JSON representation

Claude Code 開発標準 | 40年以上の経験と5,000以上のプロジェクトから生まれた実戦的なベストプラクティス

Host: GitHub
URL: https://github.com/kai-tecweb/claude-code-standards
Owner: kai-tecweb
Created: 2025-12-05T01:08:23.000Z (7 months ago)
Default Branch: main
Last Pushed: 2025-12-07T01:06:18.000Z (7 months ago)
Last Synced: 2025-12-08T09:48:24.156Z (7 months ago)
Topics: ai-coding, aws, best-practices, claude-code, coding-standards, developer-tools, inertiajs, japanese, javascript, laravel, nodejs, php, react, tailwindcss, typescript
Language: Shell
Homepage:
Size: 554 KB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# Claude Code Development Standards

Claude Code 開発標準

40年以上の経験と5,000以上のプロジェクトから生まれた実戦的なベストプラクティス

クイックスタート •
特徴 •
インストール •
使い方 •
ドキュメント

日本語 | English

---

## 🚀 クイックスタート

30秒でセットアップ完了：

```bash
curl -sSL https://raw.githubusercontent.com/iwasaki-dev/claude-code-standards/main/scripts/install.sh | bash
```

または手動で：

```bash
git clone https://github.com/iwasaki-dev/claude-code-standards.git /tmp/claude-standards
cp -r /tmp/claude-standards/.claude .
cp /tmp/claude-standards/templates/CLAUDE.laravel.md CLAUDE.md
```

---

## ✨ 特徴

### 🎯 実戦で検証済み
- **40年以上**の開発経験
- **5,000以上のプロジェクト**で実証
- 小規模アプリから大規模エンタープライズシステムまで対応

### 📚 包括的なガイド
- ✅ **Laravel 12** + **React 18** + **Inertia.js**
- ✅ **Node.js** + **Express.js**
- ✅ **AWS** (EC2, RDS, S3) 構成
- ✅ よくあるエラーと解決策
- ✅ Git運用のベストプラクティス

### 🔧 すぐに使える
- 3コマンドでセットアップ完了
- プロジェクトテンプレート付属
- 自動更新スクリプト提供

### 🌍 オープンソース
- **MIT License** - 商用利用可能
- コミュニティ貢献歓迎
- 継続的に更新

---

## 📚 含まれている内容

### 開発原則（`.claude/standards.md`）
```markdown
✓ 調査と実装の明確な分離
✓ Git運用ルール（1機能1コミット）
✓ 禁止ファイル名パターン
✓ バックアップファイル禁止ポリシー
✓ コーディング規約
```

### エラー解消パターン（`.claude/error-patterns.md`）
```markdown
✓ 環境混在エラー → php artisan config:clear
✓ ハードコーディング問題 → 環境変数化
✓ キャッシュ問題 → デプロイ後の必須コマンド
✓ bcryptエラー → バックエンド認証実装
✓ 開発サーバー遅延 → ログクリア
```

### Laravel + React ガイド（`.claude/laravel-react-guide.md`）
```markdown
✓ なぜ Laravel + React + Inertia なのか？
✓ コーディング規約（命名規則、構造）
✓ N+1問題の回避
✓ TypeScript strict mode
✓ Tailwind CSS ベストプラクティス
```

### AWS構成ガイド（`.claude/aws-guide.md`）
```markdown
✓ 標準構成（コスト重視）
✓ EC2設定（Ubuntu 24.04）
✓ RDS設定（MySQL 8.0）
✓ S3活用パターン
✓ デプロイフロー
```

---

## 📦 インストール方法

### 方法1: ワンライナー（推奨）

```bash
curl -sSL https://raw.githubusercontent.com/iwasaki-dev/claude-code-standards/main/scripts/install.sh | bash
```

**対話形式でセットアップ：**
```
? 技術スタックを選択してください:
❯ Laravel + React + Inertia
Node.js + Express
最小構成

? AWSを使用しますか？ (Y/n)
```

### 方法2: Git Clone

```bash
# 1. リポジトリをクローン
git clone https://github.com/iwasaki-dev/claude-code-standards.git /tmp/claude-standards

# 2. .claudeディレクトリをコピー
cp -r /tmp/claude-standards/.claude .

# 3. テンプレートをコピー
cp /tmp/claude-standards/templates/CLAUDE.laravel.md CLAUDE.md

# 4. プロジェクト固有情報を編集
nano CLAUDE.md
```

### 方法3: 手動ダウンロード

個別にファイルをダウンロード：
```bash
mkdir -p .claude

# 必須ファイル
curl -o .claude/standards.md https://raw.githubusercontent.com/iwasaki-dev/claude-code-standards/main/.claude/standards.md
curl -o .claude/error-patterns.md https://raw.githubusercontent.com/iwasaki-dev/claude-code-standards/main/.claude/error-patterns.md

# Laravel用
curl -o .claude/laravel-react-guide.md https://raw.githubusercontent.com/iwasaki-dev/claude-code-standards/main/.claude/laravel-react-guide.md

# AWS使用時
curl -o .claude/aws-guide.md https://raw.githubusercontent.com/iwasaki-dev/claude-code-standards/main/.claude/aws-guide.md
```

---

## 🎯 使い方

### CLAUDE.mdでの参照

```markdown
# My Project

## Commands
npm run dev: Start development server
php artisan serve: Start Laravel server

## Architecture
Laravel 12 + React 18 + Inertia.js

## Standards and Best Practices
@.claude/standards.md
@.claude/laravel-react-guide.md
@.claude/error-patterns.md
@.claude/aws-guide.md

## Project-specific Information
- Database: MySQL 8.0 on RDS
- Storage: S3 for file uploads
- Authentication: Laravel Breeze + Inertia
```

### Claude Codeでの使用

```bash
# プロジェクトディレクトリで
claude

# Claude Codeが自動的にCLAUDE.mdを読み込む
# /init で再生成・調整も可能
```

---

## 🔄 更新方法

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/kai-tecweb/claude-code-standards

Awesome Lists containing this project

README

Claude Code 開発標準