npm - foundruu - Versions diffs - 0.1.0 - Mend

foundruu 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (111) hide show

package/LICENSE +21 -0
package/README.md +119 -0
package/assets/templates/ai/_common/company/coding-standard.md +35 -0
package/assets/templates/ai/_common/company/git-workflow.md +40 -0
package/assets/templates/ai/_common/company/review-policy.md +30 -0
package/assets/templates/ai/_common/company/security.md +25 -0
package/assets/templates/ai/_common/project/architecture.md.hbs +29 -0
package/assets/templates/ai/_common/project/conventions.md +24 -0
package/assets/templates/ai/_common/project/overview.md.hbs +37 -0
package/assets/templates/ai/_common/project/testing.md +32 -0
package/assets/templates/ai/claude/CLAUDE.md.hbs +65 -0
package/assets/templates/ai/codex/CODEX.md.hbs +60 -0
package/assets/templates/base/.env.example +4 -0
package/assets/templates/base/README.md.hbs +73 -0
package/assets/templates/features/discord/.env.example.patch +3 -0
package/assets/templates/features/discord/package.json.patch +5 -0
package/assets/templates/features/docker/Dockerfile.hbs +38 -0
package/assets/templates/features/docker/docker-compose.yml.hbs +11 -0
package/assets/templates/features/eslint/eslint.config.js +14 -0
package/assets/templates/features/eslint/package.json.patch +11 -0
package/assets/templates/features/github-actions/.github/workflows/ci.yml.hbs +51 -0
package/assets/templates/features/lark/.env.example.patch +3 -0
package/assets/templates/features/lark/package.json.patch +5 -0
package/assets/templates/features/line-bot/.env.example.patch +2 -0
package/assets/templates/features/line-bot/package.json.patch +5 -0
package/assets/templates/features/prettier/.prettierignore +3 -0
package/assets/templates/features/prettier/.prettierrc +7 -0
package/assets/templates/features/prettier/package.json.patch +9 -0
package/assets/templates/features/react/index.html.hbs +12 -0
package/assets/templates/features/react/package.json.patch +17 -0
package/assets/templates/features/react/src/web/App.tsx.hbs +8 -0
package/assets/templates/features/react/src/web/main.tsx +9 -0
package/assets/templates/features/react/vite.config.ts +6 -0
package/assets/templates/features/react-laravel/package.json.patch +19 -0
package/assets/templates/features/react-laravel/resources/js/app.jsx.hbs +17 -0
package/assets/templates/features/react-laravel/vite.config.js +13 -0
package/assets/templates/features/vitest/package.json.patch +10 -0
package/assets/templates/features/vitest/tests/index.test.ts.hbs +7 -0
package/assets/templates/features/vitest/vitest.config.ts +11 -0
package/assets/templates/languages/laravel/.env.example.patch +12 -0
package/assets/templates/languages/laravel/composer.json.hbs +41 -0
package/assets/templates/languages/laravel/docs/SETUP.md.hbs +24 -0
package/assets/templates/languages/typescript/package.json.patch +20 -0
package/assets/templates/languages/typescript/src/index.ts.hbs +1 -0
package/assets/templates/languages/typescript/tsconfig.json +17 -0
package/assets/workflow/.ai/prompts/session-workflow.md +72 -0
package/assets/workflow/.ai/templates/session/design.md +21 -0
package/assets/workflow/.ai/templates/session/questions.md +34 -0
package/assets/workflow/.ai/templates/session/requirements.md +25 -0
package/assets/workflow/.ai/templates/session/summary.md +21 -0
package/assets/workflow/.ai/templates/session/tasks.md +13 -0
package/assets/workflow/.ai/templates/session/test.md +15 -0
package/assets/workflow/.ai/workflows/bugfix.md +19 -0
package/assets/workflow/.ai/workflows/development.md +27 -0
package/assets/workflow/.ai/workflows/feature.md +20 -0
package/assets/workflow/.ai/workflows/review.md +19 -0
package/dist/cli.d.ts +2 -0
package/dist/cli.js +89 -0
package/dist/cli.js.map +1 -0
package/dist/commands/doctor.d.ts +6 -0
package/dist/commands/doctor.js +64 -0
package/dist/commands/doctor.js.map +1 -0
package/dist/commands/init.d.ts +8 -0
package/dist/commands/init.js +94 -0
package/dist/commands/init.js.map +1 -0
package/dist/commands/session.d.ts +8 -0
package/dist/commands/session.js +96 -0
package/dist/commands/session.js.map +1 -0
package/dist/commands/update.d.ts +13 -0
package/dist/commands/update.js +64 -0
package/dist/commands/update.js.map +1 -0
package/dist/commands/workflow.d.ts +7 -0
package/dist/commands/workflow.js +64 -0
package/dist/commands/workflow.js.map +1 -0
package/dist/core/assets.d.ts +8 -0
package/dist/core/assets.js +29 -0
package/dist/core/assets.js.map +1 -0
package/dist/core/config.d.ts +17 -0
package/dist/core/config.js +31 -0
package/dist/core/config.js.map +1 -0
package/dist/core/copier.d.ts +25 -0
package/dist/core/copier.js +103 -0
package/dist/core/copier.js.map +1 -0
package/dist/core/fetcher.d.ts +10 -0
package/dist/core/fetcher.js +56 -0
package/dist/core/fetcher.js.map +1 -0
package/dist/core/logger.d.ts +7 -0
package/dist/core/logger.js +15 -0
package/dist/core/logger.js.map +1 -0
package/dist/core/sync.d.ts +26 -0
package/dist/core/sync.js +69 -0
package/dist/core/sync.js.map +1 -0
package/dist/doctor/checks.d.ts +5 -0
package/dist/doctor/checks.js +97 -0
package/dist/doctor/checks.js.map +1 -0
package/dist/doctor/deep.d.ts +39 -0
package/dist/doctor/deep.js +144 -0
package/dist/doctor/deep.js.map +1 -0
package/dist/doctor/rc.d.ts +13 -0
package/dist/doctor/rc.js +31 -0
package/dist/doctor/rc.js.map +1 -0
package/dist/doctor/runner.d.ts +3 -0
package/dist/doctor/runner.js +39 -0
package/dist/doctor/runner.js.map +1 -0
package/dist/doctor/types.d.ts +32 -0
package/dist/doctor/types.js +3 -0
package/dist/doctor/types.js.map +1 -0
package/dist/registry/templates.d.ts +18 -0
package/dist/registry/templates.js +45 -0
package/dist/registry/templates.js.map +1 -0
package/package.json +50 -0

package/assets/templates/features/eslint/package.json.patch ADDED Viewed

@@ -0,0 +1,11 @@
+{
+  "scripts": {
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "eslint": "^9.0.0",
+    "typescript-eslint": "^8.0.0"
+  }
+}

package/assets/templates/features/github-actions/.github/workflows/ci.yml.hbs ADDED Viewed

@@ -0,0 +1,51 @@
+name: CI
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+{{#eq language "typescript"}}
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+      - run: npm ci
+      - run: npm run typecheck
+{{#if (hasFeature "eslint")}}
+      - run: npm run lint
+{{/if}}
+{{#if (hasFeature "vitest")}}
+      - run: npm test
+{{/if}}
+      - run: npm run build
+{{/eq}}
+{{#eq language "python"}}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: pip install -r requirements.txt
+      - run: python -m pytest
+{{/eq}}
+{{#eq language "laravel"}}
+      - uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+      - run: composer install --no-interaction
+      - run: cp .env.example .env && php artisan key:generate
+      - run: php artisan test
+{{/eq}}

package/assets/templates/features/lark/.env.example.patch ADDED Viewed

@@ -0,0 +1,3 @@
+LARK_APP_ID=your_app_id
+LARK_APP_SECRET=your_app_secret
+LARK_VERIFICATION_TOKEN=your_verification_token

package/assets/templates/features/lark/package.json.patch ADDED Viewed

@@ -0,0 +1,5 @@
+{
+  "dependencies": {
+    "@larksuiteoapi/node-sdk": "^1.0.0"
+  }
+}

package/assets/templates/features/line-bot/.env.example.patch ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ LINE_CHANNEL_ACCESS_TOKEN=your_channel_access_token
2	+ LINE_CHANNEL_SECRET=your_channel_secret

package/assets/templates/features/line-bot/package.json.patch ADDED Viewed

@@ -0,0 +1,5 @@
+{
+  "dependencies": {
+    "@line/bot-sdk": "^9.0.0"
+  }
+}

package/assets/templates/features/prettier/.prettierignore ADDED Viewed

@@ -0,0 +1,3 @@
+dist/
+node_modules/
+coverage/

package/assets/templates/features/prettier/.prettierrc ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "all",
+  "printWidth": 100
+}

package/assets/templates/features/prettier/package.json.patch ADDED Viewed

@@ -0,0 +1,9 @@
+{
+  "scripts": {
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  },
+  "devDependencies": {
+    "prettier": "^3.0.0"
+  }
+}

package/assets/templates/features/react/index.html.hbs ADDED Viewed

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="ja">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{projectName}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/web/main.tsx"></script>
+  </body>
+</html>

package/assets/templates/features/react/package.json.patch ADDED Viewed

@@ -0,0 +1,17 @@
+{
+  "scripts": {
+    "dev:web": "vite",
+    "build:web": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "vite": "^5.4.0"
+  }
+}

package/assets/templates/features/react/src/web/App.tsx.hbs ADDED Viewed

@@ -0,0 +1,8 @@
+export default function App() {
+  return (
+    <main>
+      <h1>{{projectName}}</h1>
+      <p>FoundRuu で初期化されたプロジェクトです。</p>
+    </main>
+  );
+}

package/assets/templates/features/react/src/web/main.tsx ADDED Viewed

@@ -0,0 +1,9 @@
+import React from "react";
+import ReactDOM from "react-dom/client";
+import App from "./App";
+ReactDOM.createRoot(document.getElementById("root")!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);

package/assets/templates/features/react/vite.config.ts ADDED Viewed

@@ -0,0 +1,6 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+export default defineConfig({
+  plugins: [react()],
+});

package/assets/templates/features/react-laravel/package.json.patch ADDED Viewed

@@ -0,0 +1,19 @@
+{
+  "name": "{{projectName}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build"
+  },
+  "dependencies": {
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^4.3.0",
+    "axios": "^1.7.0",
+    "laravel-vite-plugin": "^1.0.0",
+    "vite": "^5.4.0"
+  }
+}

package/assets/templates/features/react-laravel/resources/js/app.jsx.hbs ADDED Viewed

@@ -0,0 +1,17 @@
+import React from "react";
+import ReactDOM from "react-dom/client";
+function App() {
+  return (
+    <main>
+      <h1>{{projectName}}</h1>
+      <p>FoundRuu で初期化された Laravel + React プロジェクトです。</p>
+    </main>
+  );
+}
+ReactDOM.createRoot(document.getElementById("app")).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);

package/assets/templates/features/react-laravel/vite.config.js ADDED Viewed

@@ -0,0 +1,13 @@
+import { defineConfig } from "vite";
+import laravel from "laravel-vite-plugin";
+import react from "@vitejs/plugin-react";
+export default defineConfig({
+  plugins: [
+    laravel({
+      input: ["resources/js/app.jsx"],
+      refresh: true,
+    }),
+    react(),
+  ],
+});

package/assets/templates/features/vitest/package.json.patch ADDED Viewed

@@ -0,0 +1,10 @@
+{
+  "scripts": {
+    "test": "vitest",
+    "test:coverage": "vitest --coverage"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^2.0.0",
+    "vitest": "^2.0.0"
+  }
+}

package/assets/templates/features/vitest/tests/index.test.ts.hbs ADDED Viewed

@@ -0,0 +1,7 @@
+import { describe, it, expect } from 'vitest'
+describe('{{projectName}}', () => {
+  it('works', () => {
+    expect(true).toBe(true)
+  })
+})

package/assets/templates/features/vitest/vitest.config.ts ADDED Viewed

@@ -0,0 +1,11 @@
+import { defineConfig } from 'vitest/config'
+export default defineConfig({
+  test: {
+    globals: true,
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'lcov'],
+    },
+  },
+})

package/assets/templates/languages/laravel/.env.example.patch ADDED Viewed

@@ -0,0 +1,12 @@
+APP_NAME={{projectName}}
+APP_ENV=local
+APP_KEY=
+APP_DEBUG=true
+APP_URL=http://localhost
+DB_CONNECTION=mysql
+DB_HOST=127.0.0.1
+DB_PORT=3306
+DB_DATABASE={{projectName}}
+DB_USERNAME=root
+DB_PASSWORD=

package/assets/templates/languages/laravel/composer.json.hbs ADDED Viewed

@@ -0,0 +1,41 @@
+{
+    "name": "app/{{projectName}}",
+    "description": "{{description}}",
+    "type": "project",
+    "require": {
+        "php": "^8.2",
+        "laravel/framework": "^11.0",
+        "laravel/tinker": "^2.9"
+    },
+    "require-dev": {
+        "fakerphp/faker": "^1.23",
+        "laravel/pint": "^1.13",
+        "mockery/mockery": "^1.6",
+        "nunomaduro/collision": "^8.0",
+        "phpunit/phpunit": "^11.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "App\\": "app/",
+            "Database\\Factories\\": "database/factories/",
+            "Database\\Seeders\\": "database/seeders/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\": "tests/"
+        }
+    },
+    "scripts": {
+        "post-autoload-dump": [
+            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump"
+        ]
+    },
+    "config": {
+        "optimize-autoloader": true,
+        "preferred-install": "dist",
+        "sort-packages": true
+    },
+    "minimum-stability": "stable",
+    "prefer-stable": true
+}

package/assets/templates/languages/laravel/docs/SETUP.md.hbs ADDED Viewed

@@ -0,0 +1,24 @@
+# {{projectName}} セットアップ
+このプロジェクトは FoundRuu の Laravel テンプレートで初期化されています。
+Laravel 本体のスケルトンはまだ含まれていないため、初回のみ以下を実行してください。
+```bash
+# Laravel スケルトンを現在のディレクトリへ展開（既存ファイルは保持される）
+composer create-project laravel/laravel /tmp/laravel-skeleton
+rsync -a --ignore-existing /tmp/laravel-skeleton/ ./
+rm -rf /tmp/laravel-skeleton
+composer install
+cp .env.example .env
+php artisan key:generate
+```
+## 開発
+```bash
+php artisan serve       # バックエンド
+npm run dev             # フロントエンド (Vite)
+php artisan test        # テスト
+./vendor/bin/pint       # フォーマッタ
+```

package/assets/templates/languages/typescript/package.json.patch ADDED Viewed

@@ -0,0 +1,20 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.1.0",
+  "description": "{{description}}",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/assets/templates/languages/typescript/src/index.ts.hbs ADDED Viewed

	@@ -0,0 +1 @@
1	+ console.log('Hello from {{projectName}}')

package/assets/templates/languages/typescript/tsconfig.json ADDED Viewed

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
+}

package/assets/workflow/.ai/prompts/session-workflow.md ADDED Viewed

@@ -0,0 +1,72 @@
+# AI開発セッション ワークフロー
+このドキュメントは、Claude Code / Codex などのAI開発エージェントが
+1つの開発セッションを進めるためのルールです。
+作業を始める前に必ずこの内容に従ってください。
+---
+あなたはAI開発セッションの作業者です。
+最初に `requirements.md` またはユーザーから与えられた要件を確認してください。
+要件が実装可能なレベルまで具体的であれば、そのまま設計・実装を開始してください。
+ただし、以下に該当する場合は実装を開始してはいけません。
+- 実装方法が複数考えられ、判断によって仕様が変わる
+- 画面やAPIの挙動が曖昧
+- DB変更の有無や内容が判断できない
+- 権限・認可条件が不明
+- 既存仕様への影響が大きそう
+- テスト観点を作れない
+- 仕様を推測しないと実装できない
+この場合は `questions.md` に確認事項を書き出してください。
+質問は重要度順に最大5件までにしてください。
+ユーザーから回答を受けたら `requirements.md` を更新し、要件が十分になったと
+判断できた時点で設計・実装へ進んでください。
+要件が十分な場合は、過剰に確認せず作業を進めてください。
+---
+## 進め方（要件ゲート）
+```
+requirements.md / ユーザーの要件を読む
+          │
+          ▼
+   要件は実装可能か？
+     ├─ はい → そのまま design.md → tasks.md → 実装 → test.md → summary.md
+     └─ いいえ → questions.md に確認事項（最大5件）
+                       │
+                       ▼
+                ユーザーの回答を待つ
+                       │
+                       ▼
+                requirements.md を更新 → 十分なら実装へ
+```
+- 要件確認は **最初の1回** を基本とします。
+- 要件が十分なら、**ユーザー確認を挟まずに** 作業を進めてかまいません。
+- 曖昧で実装方法が複数考えられる場合のみ、実装を開始せず質問します。
+- 大げさなワークフロー管理にはしないでください。必要なファイルだけ埋めます。
+## 各ファイルの役割
+| ファイル | いつ書くか | 内容 |
+| --- | --- | --- |
+| `requirements.md` | 最初 | 要件。ここが判定の起点 |
+| `questions.md` | 要件が不足しているときだけ | 確認事項（最大5件、重要度順） |
+| `design.md` | 要件が十分になった後 | 実装方針・変更対象・DB/API/UI・影響範囲 |
+| `tasks.md` | 設計後 | 実装/確認タスクと完了条件 |
+| `test.md` | 設計〜実装 | テスト観点・手動/自動テスト・リグレッション |
+| `summary.md` | 完了時 | 実施内容・変更ファイル・残課題・振り返り |
+## 注意
+- セッション成果物（`.ai/sessions/`）は Git 管理しません。作業メモとして自由に使ってください。
+- テンプレートは `.ai/templates/session/` にあります。

package/assets/workflow/.ai/templates/session/design.md ADDED Viewed

@@ -0,0 +1,21 @@
+# 設計 (Design)
+> 要件が十分だと判断できた後に記入します。
+## 実装方針
+<!-- どうアプローチするか。全体の方針 -->
+## 変更対象ファイル
+<!-- 追加 / 変更 / 削除するファイルの一覧 -->
+## DB変更
+<!-- テーブル・カラム・マイグレーションの有無と内容。なければ「なし」 -->
+## API変更
+<!-- エンドポイント・リクエスト/レスポンス・互換性。なければ「なし」 -->
+## UI変更
+<!-- 画面・コンポーネント・挙動の変更。なければ「なし」 -->
+## 影響範囲
+<!-- 既存機能への影響、リグレッションが起きうる箇所 -->

package/assets/workflow/.ai/templates/session/questions.md ADDED Viewed

@@ -0,0 +1,34 @@
+# 確認事項 (Questions)
+> 要件が曖昧で実装方法が複数考えられる場合のみ記入します。
+> 質問は重要度順に最大5件まで。要件が十分なら空のままで構いません。
+## 質問 1
+- **確認が必要な理由**:
+- **質問**:
+- **回答**:
+- **回答後の反映先**: <!-- requirements.md / design.md など -->
+## 質問 2
+- **確認が必要な理由**:
+- **質問**:
+- **回答**:
+- **回答後の反映先**:
+## 質問 3
+- **確認が必要な理由**:
+- **質問**:
+- **回答**:
+- **回答後の反映先**:
+## 質問 4
+- **確認が必要な理由**:
+- **質問**:
+- **回答**:
+- **回答後の反映先**:
+## 質問 5
+- **確認が必要な理由**:
+- **質問**:
+- **回答**:
+- **回答後の反映先**:

package/assets/workflow/.ai/templates/session/requirements.md ADDED Viewed

@@ -0,0 +1,25 @@
+# 要件 (Requirements)
+> AIエージェントは作業開始前にこのファイルを確認します。
+> ここが「実装可能なレベルまで具体的か」を判定する起点です。
+## 目的
+<!-- この作業で最終的に達成したいこと -->
+## 背景
+<!-- なぜこの作業が必要か。現状の課題や経緯 -->
+## 対象範囲
+<!-- どこまでを対象にするか（画面 / API / モジュール / 機能単位など） -->
+## 実装内容
+<!-- 具体的に何を作る・変えるか。箇条書きで -->
+## やらないこと
+<!-- 今回スコープ外にすること。誤解を避けるため明示する -->
+## 前提条件
+<!-- 使用技術・既存仕様・依存関係・制約など -->
+## 未確定事項
+<!-- まだ決まっていない点。ここが残っている場合は questions.md へ -->

package/assets/workflow/.ai/templates/session/summary.md ADDED Viewed

@@ -0,0 +1,21 @@
+# サマリ (Summary)
+> 作業完了時に記入します。次回のセッション改善に使います。
+## 実施内容
+<!-- 実際に行ったこと -->
+## 変更ファイル
+<!-- 追加/変更/削除したファイル -->
+## 確認結果
+<!-- テスト・動作確認の結果 -->
+## 残課題
+<!-- やり残し・別途対応が必要なこと -->
+## AI作業で詰まった点
+<!-- AIエージェントが判断に迷った点、手戻りが発生した点 -->
+## 次回改善したい指示
+<!-- 次回セッションで指示や要件をどう改善するか -->

package/assets/workflow/.ai/templates/session/tasks.md ADDED Viewed

@@ -0,0 +1,13 @@
+# タスク (Tasks)
+> design.md をもとに、実行可能な単位へ分解します。
+## 実装タスク
+- [ ]
+## 確認タスク
+- [ ]
+## 完了条件
+<!-- 何をもって完了とみなすか -->
+- [ ]

package/assets/workflow/.ai/templates/session/test.md ADDED Viewed

@@ -0,0 +1,15 @@
+# テスト (Test)
+> テスト観点を作れない場合は要件が不足しています（questions.md へ）。
+## テスト観点
+<!-- 何を確認すれば正しいと言えるか -->
+## 手動確認
+<!-- 手順と期待結果 -->
+## 自動テスト
+<!-- 追加/変更するテストコード、実行コマンド -->
+## リグレッション確認
+<!-- 既存機能が壊れていないことの確認 -->

package/assets/workflow/.ai/workflows/bugfix.md ADDED Viewed

@@ -0,0 +1,19 @@
+# Bugfix Workflow
+バグ修正のフロー。原因特定を修正より先に行う。
+## ステップ
+1. **再現** — バグを再現する手順・入力・環境を特定する。再現できない場合は `questions.md` に確認事項を書く
+2. **原因特定** — ログ・コードを追い、根本原因を特定する。症状への対処（パッチ）と根本修正を区別する
+3. **影響範囲確認** — 同じ原因による他の不具合、修正による副作用を洗い出す
+4. **失敗するテストを書く** — 修正前にバグを再現するテストを書き、失敗することを確認する
+5. **修正** — 最小限の変更で根本原因を修正する。無関係なリファクタリングを混ぜない
+6. **検証** — 追加したテストが通ること、既存テストが壊れていないことを確認する
+7. **サマリ** — 原因 / 修正内容 / 影響範囲 / 再発防止策を `summary.md` に書く
+## ルール
+- 原因が特定できていない状態で修正を始めない
+- 修正とリファクタリングを同じ変更に混ぜない
+- 「なぜ既存テストで検出できなかったか」を振り返りに書く

package/assets/workflow/.ai/workflows/development.md ADDED Viewed

@@ -0,0 +1,27 @@
+# Development Workflow
+AIエージェント（Claude Code / Codex 等）が開発を行うときの基本フロー。
+詳細な要件ゲートのルールは `.ai/prompts/session-workflow.md` を参照すること。
+## フロー
+```
+要件を読む → 実装可能か判定
+  ├─ 不足 → questions.md に質問（重要度順・最大5件）→ 回答待ち
+  └─ 十分 → 設計 → タスク分解 → 実装 → テスト → サマリ
+```
+## ステップ
+1. **要件確認** — `requirements.md`（またはユーザーの指示）を読み、目的・対象範囲・完了条件が実装可能なレベルか判定する
+2. **設計** — `design.md` に方針 / 変更対象 / DB / API / UI / 影響範囲を書く
+3. **タスク分解** — `tasks.md` に実装タスク・確認タスク・完了条件を書く
+4. **実装** — タスク単位で進め、既存コードの規約・スタイルに合わせる
+5. **テスト** — `test.md` の観点（正常系 / 異常系 / 境界値 / 既存影響）に沿って確認し、自動テストを実行する
+6. **サマリ** — `summary.md` に実施内容 / 変更ファイル / 残課題 / 振り返りを書く
+## ルール
+- 要件が曖昧なまま実装を始めない
+- 大量の変更を一度に行わず、タスク単位でコミット可能な状態を保つ
+- 破壊的変更・スキーマ変更・認証/決済まわりは必ず設計に明記する

package/assets/workflow/.ai/workflows/feature.md ADDED Viewed

@@ -0,0 +1,20 @@
+# Feature Workflow
+新機能を追加するときのフロー。Development Workflow をベースに、新機能特有の確認を加える。
+## ステップ
+1. **要件確認** — 何を作る / 作らないの境界、正常系・異常系、権限、完了条件を確認する。不足があれば `questions.md` へ
+2. **既存調査** — 類似機能・共通化できる既存コード・影響を受ける既存仕様を洗い出す
+3. **設計** — 新規/変更ファイル、API入出力、DBスキーマ変更（と理由）、UI、エラーケースを `design.md` に書く
+4. **タスク分解** — 動作確認可能な単位に分割する
+5. **実装** — 既存の規約・アーキテクチャに従う。新しい依存の追加は理由を明記する
+6. **テスト** — 新機能のテストを追加し、既存テストが全て通ることを確認する
+7. **ドキュメント** — README / API ドキュメント等、影響するドキュメントを更新する
+## チェックリスト
+- [ ] 既存機能への影響を設計に明記した
+- [ ] 異常系・境界値のテストを書いた
+- [ ] `.env.example` / 設定ファイルの追記漏れがない
+- [ ] ドキュメントを更新した