Открытый проект EQ プラットフォーム — страц проекта

Митать на русском (README.ru.md)

Laravel APIプロジェクトにおけるアーキテクチャの規準を強化するAIコーディングエージェント(クロードコード、カーソル、コピロットなど)のスキル:JSON:API v1.1、レイヤードアーキテクチャ、厳格なタイプ、フルテストカバレッジ。

インストール

ステップ1:スキルのインストール

ステップ 2: セットアップ CLAUDE.md (自動)

最初に使うと、自動的にプロジェクトの[CLAUDE.mdをチェックします。

• ** CLAUDE.md?** — Laravelアーキテクチャルールで[[T1]から1つを作成
• CLAUDE.md は存在しますが、Laravelセクションはありませんか? — Laravelセクションに追加
• 既に設定されていますか? — 通常通り

[CLAUDE.md テンプレートは、phaseディスパッチャとして機能します — それはあなたが何をしているかを検知します (エンティティティティを編集し、コードを見直し、テストを書く) そして、任意のコードを書く前に、エージェントが正しい参照ファイルを読み込むように強制します。

##手動設定(代替)

手動で設定したい場合:

または既存の CLAUDE.md に追加します。

それが何をしているか

アクティブにすると、Laravel APIプロジェクトごとに厳格なレイヤードアーキテクチャが強化されます。

##レイヤー境界

| レイヤー | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | は | お問い合わせ

Laravel API Production-Ready Architecture Skill

Открытый проект EQ Platform — страница проекта

Читать на русском (README.ru.md)

A skill for AI coding agents (Claude Code, Cursor, Copilot, etc.) that enforces architectural discipline in Laravel API projects: JSON:API v1.1, layered architecture, strict types, full test coverage.

Installation

Step 1: Install the skill

npx skills add streeboga/laravel-api-skill

Step 2: Setup CLAUDE.md (automatic)

On first use, the skill automatically checks your project’s CLAUDE.md:

• No CLAUDE.md? — Creates one from templates/CLAUDE.md with Laravel architecture rules
• CLAUDE.md exists but no Laravel section? — Appends the Laravel section
• Already configured? — Proceeds normally

The CLAUDE.md template acts as a phase dispatcher — it detects what you’re doing (creating an entity, reviewing code, writing tests) and forces the agent to read the correct reference files before writing any code.

Manual setup (alternative)

If you prefer to set it up manually:

# Copy the template to your project root
cp ~/.claude/skills/laravel-api/templates/CLAUDE.md ./CLAUDE.md

Or append to an existing CLAUDE.md:

cat ~/.claude/skills/laravel-api/templates/CLAUDE.md >> ./CLAUDE.md

What It Does

When activated, the skill enforces a strict layered architecture for every Laravel API project:

HTTP Request → Route → Middleware → Controller → Service → Repository → QueryBuilder → Model → DB
Response    ← JsonApiResource      ← Service   ← Repository ← QueryBuilder

Layer Boundaries

New Entity Generation

Ask the agent to create a new entity and it generates 14 files following the architecture:

1. Migration
2. Model (with ULID public keys)
3. Enum(s)
4. Create DTO + Update DTO (readonly classes)
5. Store Request + Update Request (with toDto())
6. QueryBuilder
7. Repository (interface only with a second implementation)
8. Service
9. Controller (thin, JSON:API compliant)
10. JsonApiResource
11. Routes (versioned, PATCH for updates)
12. Feature Tests

Code Review