foundruu 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ruu5LP
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# FoundRuu CLI
+
+AI開発を標準化するためのプラットフォーム **FoundRuu** の CLI です。
+プロジェクトごとに異なるルール・開発フロー・ドキュメント不足によるAI品質のばらつきを解消し、
+人とAIが同じルール・同じ品質で開発できる環境を提供します。
+
+`Ruu5LP/dev-init-templates`（テンプレート）・`Ruu5LP/dev-workflow`（Workflow）・`Ruu5LP/DevDoctor`（診断）の3リポジトリを統合しています。
+
+## インストール
+
+```bash
+npm install
+npm run build
+npm link   # foundruu コマンドとして使えるようにする
+```
+
+## コマンド
+
+| コマンド | 説明 |
+|---|---|
+| `foundruu init [--template <id>] [--name <name>]` | テンプレート + Workflow + Rules + Doctor設定を一括導入 |
+| `foundruu workflow install` | Workflow / Prompt / Rules（`.ai/`）のみを既存リポジトリへ導入 |
+| `foundruu doctor [--json]` | リポジトリがAI開発可能な状態か診断（fail ありで exit 1） |
+| `foundruu doctor --deep [--since <ref>]` | docs/ と git 差分から AI開発プロセス品質をスコア診断 |
+| `foundruu update [--force]` | Workflow / Prompt / Rules を最新へ更新 |
+| `foundruu session start <name>` / `session list` | AI開発セッションの作成 / 一覧 |
+| `foundruu templates` | 利用可能なテンプレート一覧 |
+| `foundruu --help` / `--version` | ヘルプ / バージョン |
+
+## 利用フロー
+
+```bash
+# ① 新しいリポジトリにAI開発環境を構築
+mkdir my-app && cd my-app && git init
+foundruu init --template typescript --name my-app
+
+# ② 既存リポジトリには Workflow だけ導入
+foundruu workflow install
+
+# ③ セッションを作成し、AIエージェントに .ai/ を読ませて開発
+foundruu session start add-login-api
+
+# ④ いつでも健全性チェック
+foundruu doctor
+
+# ⑤ Workflow を最新へ
+foundruu update
+```
+
+## init で導入されるもの
+
+```
+.ai/
+  prompts/session-workflow.md    # 要件ゲート付き開発フロー
+  workflows/                     # development / feature / bugfix / review
+  templates/session/             # requirements / design / tasks / test / summary 等
+docs/ai/                         # 会社共通ルール + プロジェクトルール
+CLAUDE.md / CODEX.md             # AIエージェント向けエントリポイント
++ テンプレート本体（src/, tsconfig, ESLint, Prettier, Vitest, Docker, GitHub Actions, .env.example ...）
++ foundruu.json                  # FoundRuu 管理情報（update のバージョン基準）
+```
+
+## Doctor のチェック項目
+
+README / LICENSE / .gitignore / .env.example / package.json・composer.json /
+Docker / GitHub Actions / AI Rules / Workflow / Prompt / foundruu.json
+
+チェックは [src/doctor/checks.ts](src/doctor/checks.ts) に宣言的に定義されており、1エントリ追加するだけで拡張できます。
+`--json` 出力と exit code により GitHub Actions からも利用できます。
+
+プロジェクトルートの `.foundruurc` でカスタマイズできます:
+
+```json
+{
+  "doctor": {
+    "disable": ["docker"],
+    "severity": { "license": "error" }
+  }
+}
+```
+
+`foundruu doctor --deep` は DevDoctor 由来の品質診断で、docs/（および最新の `.ai/sessions/`）の
+要件・設計・テスト・AI指示ドキュメントをスコア化し、不足観点と改善案を提示します。
+
+## GitHub Actions として使う
+
+他リポジトリの PR チェックとして doctor を実行できます:
+
+```yaml
+jobs:
+  doctor:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Ruu5LP/RuunFoundry@main
+        with:
+          fail-on: error   # error / warning / never
+          deep: 'true'     # --deep のスコア診断も実行
+```
+
+結果はジョブサマリに表形式で出力されます。
+
+## 開発
+
+```bash
+npm run dev -- doctor   # ts-node で実行
+npm test                # vitest
+npm run typecheck
+```
+
+## ドキュメント
+
+- [docs/investigation.md](docs/investigation.md) — 3リポジトリの調査結果
+- [docs/architecture.md](docs/architecture.md) — 全体アーキテクチャ・設計判断
+- [docs/roadmap.md](docs/roadmap.md) — MVP以降のロードマップ
+
+## ライセンス
+
+MIT

package/assets/templates/ai/_common/company/coding-standard.md

@@ -0,0 +1,35 @@
+# コーディング規約
+
+## 基本方針
+
+- 読みやすさを最優先にする
+- 一貫性を保つ（既存のスタイルに合わせる）
+- 不要なコメントは書かない（コードで意図を伝える）
+- マジックナンバーは定数として定義する
+
+## 命名規則
+
+### TypeScript / JavaScript
+- 変数・関数: `camelCase`
+- クラス・型・インターフェース: `PascalCase`
+- 定数: `UPPER_SNAKE_CASE`
+- ファイル名: `kebab-case.ts`
+
+### Python
+- 変数・関数: `snake_case`
+- クラス: `PascalCase`
+- 定数: `UPPER_SNAKE_CASE`
+- ファイル名: `snake_case.py`
+
+## エラーハンドリング
+
+- エラーは適切な型で throw/raise する
+- エラーメッセージは英語で記述する
+- 握り潰しは絶対に禁止（空の catch は NG）
+
+## セキュリティ
+
+- シークレットは必ず環境変数で管理する
+- `.env` をコミットしない（`.env.example` のみ）
+- SQL インジェクション・XSS に注意する
+- 詳細は [security.md](./security.md) を参照

package/assets/templates/ai/_common/company/git-workflow.md

@@ -0,0 +1,40 @@
+# Git ワークフロー
+
+## ブランチ戦略
+
+```
+main        ← 本番リリース済み
+develop     ← 開発統合
+feature/*   ← 機能開発
+fix/*       ← バグ修正
+chore/*     ← 依存更新・設定変更
+```
+
+## コミットメッセージ規約（Conventional Commits）
+
+```
+<type>(<scope>): <subject>
+
+type:
+  feat     新機能
+  fix      バグ修正
+  docs     ドキュメントのみ
+  style    フォーマット（動作変更なし）
+  refactor リファクタリング
+  test     テスト追加・修正
+  chore    ビルド・補助ツール変更
+```
+
+例:
+```
+feat(auth): add JWT refresh token support
+fix(api): handle null response from external API
+docs(readme): update setup instructions
+```
+
+## PR ルール
+
+- 1 PR = 1 つの目的に絞る
+- レビュー前に自己レビューを行う
+- CI が通っていることを確認してからレビュー依頼する
+- マージは Squash merge を使用する

package/assets/templates/ai/_common/company/review-policy.md

@@ -0,0 +1,30 @@
+# レビューポリシー
+
+## レビュー観点
+
+### Must（必ず確認）
+- セキュリティ上の問題がないか
+- テストが網羅されているか
+- エラーハンドリングが適切か
+- 仕様を満たしているか
+
+### Should（できる限り確認）
+- パフォーマンス上の懸念がないか
+- 可読性・保守性が十分か
+- 命名が適切か
+
+### Nice to have（余裕があれば）
+- より良い実装方法の提案
+- 将来的な拡張性の考慮
+
+## レビューコメントの書き方
+
+- 問題点だけでなく改善案も添える
+- 個人を攻撃しない（コードを指摘する）
+- `nit:` プレフィックスで軽微な指摘を明示する
+
+## 承認基準
+
+- Must 項目を全てクリアしていること
+- CI（lint / test / typecheck）が通過していること
+- 1名以上の Approve があること

package/assets/templates/ai/_common/company/security.md

@@ -0,0 +1,25 @@
+# セキュリティガイドライン
+
+## シークレット管理
+
+- APIキー・パスワードは必ず環境変数で管理する
+- `.env` は `.gitignore` に追加し、絶対にコミットしない
+- `.env.example` にキー名のみ記載（値は空にする）
+- シークレットを誤ってコミットした場合は即座にローテーションする
+
+## 入力値の検証
+
+- 外部からの入力は必ずバリデーションする
+- SQL クエリはプレースホルダーを使用する（直接埋め込み禁止）
+- HTML を出力する場合は必ずエスケープする
+
+## 依存関係
+
+- `npm audit` / `pip-audit` を定期実行する
+- 既知の脆弱性がある依存を放置しない
+
+## API セキュリティ
+
+- 認証が必要なエンドポイントは必ず認証を実装する
+- レートリミットを設ける
+- CORS 設定を適切に行う（`*` は本番 NG）

package/assets/templates/ai/_common/project/architecture.md.hbs

@@ -0,0 +1,29 @@
+# アーキテクチャ
+
+## 概要
+
+（アーキテクチャの概要をここに記載してください）
+
+## コンポーネント構成
+
+（図や説明をここに記載してください）
+
+## データフロー
+
+（データの流れをここに記載してください）
+
+## 外部依存
+
+{{#if (hasFeature "discord")}}
+- **Discord API** — ボット機能
+{{/if}}
+{{#if (hasFeature "line-bot")}}
+- **LINE Messaging API** — チャットボット機能
+{{/if}}
+{{#if (hasFeature "lark")}}
+- **Lark API** — ビジネスチャット連携
+{{/if}}
+
+## 設計上の決定事項
+
+（重要な設計上の決定とその理由をここに記載してください）

package/assets/templates/ai/_common/project/conventions.md

@@ -0,0 +1,24 @@
+# プロジェクト規約
+
+## ファイル構成規約
+
+- `src/` 以下にソースコードを配置する
+- `tests/` 以下にテストコードを配置する（対象ファイルと同じ階層構造）
+- `docs/` 以下にドキュメントを配置する
+
+## インポート規約
+
+- 相対パスより絶対パスを優先する（エイリアス設定済みの場合）
+- 型のみのインポートは `import type` を使用する
+
+## 関数設計
+
+- 1関数 = 1責務を守る
+- 引数は 3つ以下を目安にする（超える場合はオブジェクト化）
+- 副作用のある関数と純粋な関数を分離する
+
+## コミットのタイミング
+
+- 動作確認済みの単位でコミットする
+- 途中状態（コンパイルエラーあり等）でコミットしない
+- lint / typecheck が通ってからコミットする

package/assets/templates/ai/_common/project/overview.md.hbs

@@ -0,0 +1,37 @@
+# プロジェクト概要
+
+## {{projectName}}
+
+{{#if description}}
+{{description}}
+{{else}}
+（プロジェクトの概要をここに記載してください）
+{{/if}}
+
+## 技術スタック
+
+- **言語:** {{languageLabel}}
+{{#if aiProviderLabels.length}}
+- **AI ツール:** {{#each aiProviderLabels}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}
+{{/if}}
+
+## 機能一覧
+
+{{#each featureLabels}}
+- {{this}}
+{{/each}}
+
+## ディレクトリ構成
+
+```
+{{projectName}}/
+├── src/          # ソースコード
+├── tests/        # テストコード
+├── docs/         # ドキュメント
+├── .ai/          # AI ルール
+│   ├── company/  # 社内共通ルール
+│   ├── project/  # プロジェクト固有ルール
+{{#if (hasAi "claude")}}│   ├── claude/   # Claude Code ルール
+{{/if}}{{#if (hasAi "codex")}}│   └── codex/    # Codex ルール
+{{/if}}└── README.md
+```

package/assets/templates/ai/_common/project/testing.md

@@ -0,0 +1,32 @@
+# テスト方針
+
+## テストの種類
+
+- **Unit Test** — 単一の関数・クラスをテストする
+- **Integration Test** — 複数コンポーネントの連携をテストする
+
+## テスト命名規則
+
+```
+describe('対象の名前', () => {
+  it('〜すること', () => { ... })
+  it('〜の場合に〜すること', () => { ... })
+})
+```
+
+## テストカバレッジ目標
+
+- 新規コード: 80% 以上
+- ビジネスロジック: 100% を目指す
+
+## テストを書かなくてよいもの
+
+- UI コンポーネントの見た目
+- 設定ファイル
+- 型定義のみのファイル
+
+## テストの禁止事項
+
+- 実際の API・DB を叩くテストをデフォルトで実行しない（CI が壊れる）
+- テスト間で状態を共有しない（各テストは独立させる）
+- `console.log` をテストコードに残さない

package/assets/templates/ai/claude/CLAUDE.md.hbs

@@ -0,0 +1,65 @@
+# CLAUDE.md
+
+このファイルは Claude Code がプロジェクトを理解するためのガイドです。
+
+---
+
+## プロジェクト概要
+
+**プロジェクト名:** {{projectName}}
+{{#if description}}**概要:** {{description}}{{/if}}
+
+- **言語:** {{languageLabel}}
+- **AI ツール:** {{#each aiProviderLabels}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}
+
+### 機能一覧
+{{#each featureLabels}}
+- {{this}}
+{{/each}}
+
+---
+
+## 必ず最初に読むファイル
+
+作業開始前に以下を読んでください：
+
+1. [コーディング規約](../company/coding-standard.md)
+2. [Git ワークフロー](../company/git-workflow.md)
+3. [レビューポリシー](../company/review-policy.md)
+4. [セキュリティガイドライン](../company/security.md)
+5. [プロジェクト概要](../project/overview.md)
+6. [アーキテクチャ](../project/architecture.md)
+7. [プロジェクト規約](../project/conventions.md)
+8. [テスト方針](../project/testing.md)
+
+---
+
+## 作業ルール
+
+### 実装前
+- 実装前に設計・方針を簡潔に書いてから着手すること
+- 大きな変更はユーザーに確認してから実施すること
+
+### 実装中
+- 小さい単位で実装・確認を繰り返すこと
+- テストを壊さないこと
+
+### 実装後（必須チェックリスト）
+{{#if (hasFeature "eslint")}}
+- [ ] `npm run lint` を実行してエラーがないこと
+{{/if}}
+{{#if (hasFeature "vitest")}}
+- [ ] `npm test` を実行して全テストが通ること
+{{/if}}
+- [ ] `npm run typecheck` を実行してエラーがないこと
+- [ ] `README.md` を最新状態に更新すること
+- [ ] `docs/` 以下のドキュメントを必要に応じて更新すること
+
+---
+
+## Claude Code 固有ルール
+
+- ファイルを読む前に「何を確認するか」を宣言すること
+- 複数ファイルの変更時は影響範囲を事前にリストアップすること
+- 不明点はコードを推測せず、ユーザーに質問すること
+- セキュリティに関わる変更は必ずユーザーの確認を取ること

package/assets/templates/ai/codex/CODEX.md.hbs

@@ -0,0 +1,60 @@
+# CODEX.md
+
+このファイルは Codex がプロジェクトを理解するためのガイドです。
+
+---
+
+## プロジェクト概要
+
+**プロジェクト名:** {{projectName}}
+{{#if description}}**概要:** {{description}}{{/if}}
+
+- **言語:** {{languageLabel}}
+- **AI ツール:** {{#each aiProviderLabels}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}
+
+### 機能一覧
+{{#each featureLabels}}
+- {{this}}
+{{/each}}
+
+---
+
+## 共通ルールの参照
+
+以下のドキュメントに従って作業してください：
+
+- [コーディング規約](../company/coding-standard.md)
+- [Git ワークフロー](../company/git-workflow.md)
+- [セキュリティガイドライン](../company/security.md)
+- [プロジェクト概要](../project/overview.md)
+- [プロジェクト規約](../project/conventions.md)
+- [テスト方針](../project/testing.md)
+
+---
+
+## 作業ルール
+
+### 変更単位
+- 小さい変更単位で作業すること（1 PR = 1 目的）
+- 大規模な変更（アーキテクチャ変更・大量ファイル変更）は事前にユーザーに確認すること
+
+### テスト
+- テストを壊さないこと
+- 新規機能には必ずテストを追加すること
+
+### 実装後チェック（必須）
+{{#if (hasFeature "eslint")}}
+- `npm run lint` でエラーがないこと
+{{/if}}
+{{#if (hasFeature "vitest")}}
+- `npm test` で全テストが通ること
+{{/if}}
+- `npm run typecheck` でエラーがないこと
+
+---
+
+## Codex 固有ルール
+
+- コードの意図が不明な場合は推測せず、コメントや構造から判断すること
+- 既存のコードスタイルに合わせること（独自スタイルを導入しない）
+- リファクタリングとバグ修正を同一 PR に混在させないこと

package/assets/templates/base/.env.example

@@ -0,0 +1,4 @@
+# Copy this file to .env and fill in your values
+# Never commit .env to version control
+
+NODE_ENV=development

package/assets/templates/base/README.md.hbs

@@ -0,0 +1,73 @@
+# {{projectName}}
+
+{{#if description}}
+{{description}}
+{{/if}}
+
+## Tech Stack
+
+- **Language:** {{languageLabel}}
+{{#if aiProviderLabels.length}}
+- **AI:** {{#each aiProviderLabels}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}
+{{/if}}
+
+## Features
+
+{{#each featureLabels}}
+- {{this}}
+{{/each}}
+
+## Getting Started
+
+```bash
+# Install dependencies
+npm install
+
+# Run development server
+npm run dev
+```
+
+{{#if (hasFeature "docker")}}
+## Docker
+
+```bash
+docker-compose up -d
+```
+{{/if}}
+
+{{#if (hasFeature "vitest")}}
+## Testing
+
+```bash
+npm test
+npm run test:coverage
+```
+{{/if}}
+
+{{#if (hasFeature "eslint")}}
+## Linting
+
+```bash
+npm run lint
+```
+{{/if}}
+
+## AI Documentation
+
+AI-specific rules and guidelines are located in `.ai/`:
+
+```
+.ai/
+├── company/      # Company-wide coding standards
+├── project/      # Project-specific conventions
+{{#if (hasAi "claude")}}
+├── claude/       # Claude Code rules → CLAUDE.md (symlink at root)
+{{/if}}
+{{#if (hasAi "codex")}}
+└── codex/        # Codex rules → CODEX.md (symlink at root)
+{{/if}}
+```
+
+## License
+
+MIT © {{year}}

package/assets/templates/features/discord/.env.example.patch

@@ -0,0 +1,3 @@
+DISCORD_TOKEN=your_discord_bot_token
+DISCORD_CLIENT_ID=your_client_id
+DISCORD_GUILD_ID=your_guild_id

package/assets/templates/features/discord/package.json.patch

@@ -0,0 +1,5 @@
+{
+  "dependencies": {
+    "discord.js": "^14.0.0"
+  }
+}

package/assets/templates/features/docker/Dockerfile.hbs

@@ -0,0 +1,38 @@
+{{#eq language "typescript"}}
+FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+FROM node:20-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --omit=dev
+COPY --from=builder /app/dist ./dist
+EXPOSE 3000
+CMD ["node", "dist/index.js"]
+{{/eq}}
+
+{{#eq language "python"}}
+FROM python:3.12-slim
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+COPY . .
+EXPOSE 8000
+CMD ["python", "-m", "uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
+{{/eq}}
+
+{{#eq language "laravel"}}
+FROM php:8.3-fpm-alpine
+WORKDIR /var/www
+RUN apk add --no-cache nginx
+COPY composer.json composer.lock ./
+RUN composer install --no-dev --optimize-autoloader
+COPY . .
+RUN php artisan config:cache && php artisan route:cache
+EXPOSE 80
+CMD ["php-fpm"]
+{{/eq}}

package/assets/templates/features/docker/docker-compose.yml.hbs

@@ -0,0 +1,11 @@
+services:
+  app:
+    build: .
+    ports:
+      - "3000:3000"
+    env_file:
+      - .env
+    volumes:
+      - .:/app
+      - /app/node_modules
+    restart: unless-stopped

package/assets/templates/features/eslint/eslint.config.js

@@ -0,0 +1,14 @@
+// @ts-check
+import eslint from '@eslint/js'
+import tseslint from 'typescript-eslint'
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    rules: {
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/no-explicit-any': 'warn',
+    },
+  },
+)