jpskill.com
🛠️ 開発・MCP コミュニティ

project-architecture

プロジェクトで使用している技術、フォルダ構成、設計の原則といった全体像を把握し、開発者が効率的に作業を進められるように、プロジェクトの構造を理解するSkill。

📜 元の英語説明(参考)

Overview of the project's tech stack, directory structure, and architectural patterns.

🇯🇵 日本人クリエイター向け解説

一言でいうと

プロジェクトで使用している技術、フォルダ構成、設計の原則といった全体像を把握し、開発者が効率的に作業を進められるように、プロジェクトの構造を理解するSkill。

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux 
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o project-architecture.zip https://jpskill.com/download/16948.zip && unzip -o project-architecture.zip && rm project-architecture.zip
🪟 Windows (PowerShell) 
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/16948.zip -OutFile "$d\project-architecture.zip"; Expand-Archive "$d\project-architecture.zip" -DestinationPath $d -Force; ri "$d\project-architecture.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)
  1. 1. 下の青いボタンを押して project-architecture.zip をダウンロード
  2. 2. ZIPファイルをダブルクリックで解凍 → project-architecture フォルダができる
  3. 3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
  4. 4. Claude Code を再起動
⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

  1. 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
  2. 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
  3. 3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
    • · macOS / Linux: ~/.claude/skills/
    • · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →
最終更新
2026-05-18
取得日時
2026-05-18
同梱ファイル
1

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

プロジェクトアーキテクチャと技術スタック

技術スタック

  • フレームワーク: Next.js 15 (App Router)
  • 言語: TypeScript
  • スタイリング: Tailwind CSS v4, CSS Modules (特定のコンポーネント用)
  • ドキュメント/コンテンツ: Docusaurus (textbook/ ディレクトリ内)
  • 認証: Better Auth (better-auth)
  • データベース: PostgreSQL (NeonDB)
  • ORM: Drizzle ORM
  • UIコンポーネント: Lucide React icons, カスタムコンポーネント

ディレクトリ構造

  • /app: Next.js App Router のページとレイアウト。
  • /components: 再利用可能なUIコンポーネント。
    • /auth: 認証関連のコンポーネント (フォームなど)。
  • /lib: ユーティリティ関数と共有ロジック。
    • auth-client.ts: Better Auth クライアントの設定。
    • auth.ts: Better Auth サーバーの設定。
  • /db: データベーススキーマと接続ロジック。
  • /drizzle: マイグレーション。
  • /textbook: ドキュメント/コンテンツ用の Docusaurus インスタンス。
    • /src: Docusaurus のソースファイル。

主要なパターン

  • ハイブリッドアプリ: Next.js ウェブアプリ (マーケティング、認証、ダッシュボード) と Docusaurus ドキュメントサイトを組み合わせます。
  • 認証統合: Next.js と Docusaurus 間で、Cookie/セッションを介して認証状態を共有します (AuthBar によって処理されます)。
  • スタイリング: グローバルな Tailwind スタイルは app/globals.css にあります。Docusaurus は textbook/src/css/custom.css に独自のテーマを持っています。

開発

  • ルートアプリを実行: npm run dev:root
  • ドキュメントアプリを実行: npm run dev:docs
  • 両方を実行: npm run dev
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

Project Architecture & Tech Stack

Tech Stack

  • Framework: Next.js 15 (App Router)
  • Language: TypeScript
  • Styling: Tailwind CSS v4, CSS Modules (for specific components)
  • Docs/Content: Docusaurus (in textbook/ directory)
  • Auth: Better Auth (better-auth)
  • Database: PostgreSQL (NeonDB)
  • ORM: Drizzle ORM
  • UI Components: Lucide React icons, Custom components

Directory Structure

  • /app: Next.js App Router pages and layouts.
  • /components: Reusable UI components.
    • /auth: Authentication related components (forms, etc.).
  • /lib: Utility functions and shared logic.
    • auth-client.ts: Better Auth client configuration.
    • auth.ts: Better Auth server configuration.
  • /db: Database schema and connection logic.
  • /drizzle: Migrations.
  • /textbook: Docusaurus instance for documentation/content.
    • /src: Docusaurus source files.

Key Patterns

  • Hybrid App: Combines a Next.js web app (marketing, auth, dashboard) with a Docusaurus documentation site.
  • Auth Integration: Shared authentication state between Next.js and Docusaurus via cookies/sessions (handled by AuthBar).
  • Styling: Global Tailwind styles in app/globals.css. Docusaurus has its own theme in textbook/src/css/custom.css.

Development

  • Run root app: npm run dev:root
  • Run docs app: npm run dev:docs
  • Run both: npm run dev