ディレクトリとファイルの規約

my-app/
├── .agents/
│   ├── rules/                    # プロジェクトが所有するルール
│   └── skills/                   # 依存関係から同期したスキル（生成）
├── cli/
│   ├── commands/                 # アプリのコマンド（任意）
│   └── plugins.ts                # CLI のプラグインの登録
├── client/
│   ├── pages/                    # 業務のページ
│   ├── layouts/                  # ページのレイアウト
│   ├── components/               # UI コンポーネント
│   ├── hooks/                    # 共有の操作と状態のロジック
│   ├── locales/                  # 翻訳
│   ├── theme/                    # テーマとスタイル
│   ├── routes.ts                 # ルート、メニュー、ナビゲーション
│   ├── plugins.ts                # Client のプラグインの登録
│   └── runtime.ts                # Client の組み立て
├── database/
│   └── main/
│       ├── migrations/           # スキーマとメタデータの変更
│       ├── seeds/                # 初期データ
│       ├── metadata/             # 外部の接続のメタデータ（任意）
│       └── collections/          # 解決済みのモデルのスナップショット（生成）
├── packages/                     # workspace のパッケージ（任意）
├── public/                       # 静的アセット
├── server/
│   ├── routes/                   # HTTP のルートと index.ts での登録
│   ├── services/                 # 業務の実装（任意）
│   ├── providers/                # サービスの登録とライフサイクル
│   ├── config/                   # 既定値、検証、環境変数の対応付け
│   ├── plugins.ts                # Server のプラグインの登録
│   └── runtime.ts                # Server の組み立て
├── tests/                        # テスト、フィクスチャー、ヘルパー
├── storage/                      # 実行時のデータ（生成）
├── dist/                         # ビルドの出力（生成）
├── node_modules/                 # インストール済みの依存関係（生成）
├── AGENTS.md                     # プロジェクトのガイダンスの入口
├── config.example.yml            # 設定の例
├── config.yml                    # ローカル / デプロイの設定
├── components.json               # shadcn の設定
├── package.json                  # スクリプト、依存関係、アプリのメタデータ
├── pnpm-lock.yaml                # 解決済みの依存関係のバージョン
└── pnpm-workspace.yaml           # workspace のパッケージのディレクトリ

packages/
├── app-plugin-orders/            # 実行時のプラグイン
│   ├── client/
│   │   ├── components/
│   │   ├── react-providers/      # React の Context の組み込み
│   │   ├── providers/            # Client の ServiceProvider
│   │   ├── plugin.ts
│   │   └── index.ts              # 公開の Client の入口
│   ├── server/
│   │   ├── services/
│   │   ├── providers/            # Server の ServiceProvider
│   │   ├── tokens.ts             # 公開のサービスの取り決め
│   │   ├── plugin.ts
│   │   └── index.ts              # 公開の Server の入口
│   ├── cli/
│   ├── database/
│   ├── skills/
│   ├── tests/
│   ├── AGENTS.md
│   └── package.json
├── orders-ui/                    # 独立した UI Registry のパッケージ
│   ├── registry/
│   ├── registry.json
│   ├── public/r/                 # ビルドしたアイテムの JSON（生成）
│   └── package.json
└── shared-domain/                # 内部の共有コード（任意）
    └── package.json