Imported from yoshinani-dev/yoshinani-template-base (
AGENTS.md). Install upstream withnpx skills add yoshinani-dev/yoshinani-template-base. Copyright stays with the author.
AGENTS.md
このドキュメントは、AIエージェントがこのプロジェクトを理解し、適切にコードを生成・修正するためのガイドラインです。
プロジェクト概要
基本のモノレポプロジェクト。
プロジェクト構成
アプリケーション
apps/web: メインのWebアプリケーション(Next.js)
パッケージ
packages/ui: 共通のUIコンポーネントライブラリ
エージェント依存関係(Microsoft APM)
スキルなどのエージェント向け依存は Microsoft APM で管理しています。
- マニフェスト: ルートの
apm.yml - ロック:
apm.lock.yaml(コミットする) - 初回・依存更新後: リポジトリルートで
apm installを実行すると、ロックに従い.agents/skills/などへ展開されます
コーディング規約
- TypeScript: strict有効、
anyは避ける - React/Next.js: Server Componentsがデフォルト。必要な場合のみ
"use client"を使用 - App Router: Next.js App Routerの規約に従う
- フォーマット/リント: 変更後にBiomeとESLintを実行
コマンド
pnpm dev: 開発サーバー起動pnpm build: プロダクションビルドpnpm format: コードフォーマット(Biome)pnpm check: 型チェック、リント、フォーマットチェックpnpm test: テスト実行
Cursor Cloud specific instructions
- ランタイム: Node.js >= 22 と pnpm 10.12.4 が必要(VM環境にプリインストール済み)
- 開発サーバー:
pnpm devを実行すると portless 経由で Next.js(Turbopack)がhttps://web.localhostに起動する(初回のみローカル CA インストールと sudo プロンプトが必要) - リント/チェック: CIと同じ非対話的チェックには
pnpm check:ciを使用(pnpm checkは自動修正付き) - テスト:
pnpm test:ciでVitest単体テストをワンショット実行(pnpm testはwatchモード) - 外部サービス不要: データベース、Docker、外部APIへの依存なし。純粋なフロントエンドモノレポ
pnpm-workspace.yamlのonlyBuiltDependencies: ネイティブモジュール(sharp, esbuild等)のビルド承認は設定済み。対話的なpnpm approve-buildsは不要
