Skip to content

README.md

Latest commit

 

History

History
210 lines (155 loc) · 6.49 KB

README.md

File metadata and controls

210 lines (155 loc) · 6.49 KB

AI Dev OS CLI

CI npm version License: MIT

AI Dev OS のセットアップ、更新、診断を1コマンドで実行します。

npx ai-dev-os init --rules typescript --plugin claude-code

何ができるか？

手動セットアップ CLI 使用時
git submodule add × 3リポジトリ npx ai-dev-os init（1コマンド）
テンプレートを手動コピー 自動コピー
hooks.json を手動マージ 自動マージ（バックアップ付き）
submodule の状態を手動確認 npx ai-dev-os doctor
submodule を手動更新 npx ai-dev-os update

クイックスタート

対話モード

npx ai-dev-os init

CLI がルールプリセットとプラグインの選択を案内します:

  AI Dev OS Setup
  ───────────────

  ? Select rules preset:
  ❯ TypeScript (Next.js)
    Python (FastAPI)

  ? Select plugin:
  ❯ Claude Code
    Kiro
    Cursor

  ✔ Added submodule: .ai-dev-os/core
  ✔ Added submodule: .ai-dev-os/rules
  ✔ Added submodule: .ai-dev-os/plugin
  ✔ Copied template → CLAUDE.md
  ✔ Merged hooks → .claude/settings.json
  ✔ Created .ai-dev-os.yaml

  Done! Next steps:
    1. Edit CLAUDE.md to customize for your project
    2. Run /ai-dev-os-init in Claude Code to generate L1/L2
    3. See: https://github.com/yunbow/ai-dev-os#quick-start

非対話モード

npx ai-dev-os init --rules typescript --plugin claude-code -y

コマンド

コマンド 説明
ai-dev-os init submodule 追加、テンプレートコピー、hooks マージ
ai-dev-os update submodule を最新版またはピンバージョンに更新
ai-dev-os doctor インストール状態の健全性チェック（7項目）
コマンド詳細

Update

# すべての submodule を最新に更新
npx ai-dev-os update

# 適用せずに更新を確認
npx ai-dev-os update --check

# 特定バージョンにピン留め
npx ai-dev-os update --ref v1.3.0

Doctor

npx ai-dev-os doctor

チェック項目:

  • Git リポジトリの有効性
  • .ai-dev-os.yaml 設定
  • submodule の初期化（core, rules, plugin）
  • テンプレートファイルの存在
  • hooks 統合ステータス
オプション 
Usage: ai-dev-os init [options]

Options:
  --rules <name>   ルールプリセット (typescript | python)
  --plugin <name>  プラグイン (claude-code | kiro | cursor)
  --ref <tag>      バージョンをピン留め (デフォルト: "latest")
  --no-hooks       hooks.json のマージをスキップ
  --dry-run        実行せずに内容を表示
  -y, --yes        対話プロンプトをスキップ
設定ファイル

CLI はプロジェクトルートに .ai-dev-os.yaml を作成します:

version: "1.0"
core:
  repo: https://github.com/yunbow/ai-dev-os
  ref: latest
  path: .ai-dev-os/core
rules:
  name: typescript
  repo: https://github.com/yunbow/ai-dev-os-rules-typescript
  ref: latest
  path: .ai-dev-os/rules
plugin:
  name: claude-code
  repo: https://github.com/yunbow/ai-dev-os-plugin-claude-code
  ref: latest
  path: .ai-dev-os/plugin
hooks:
  merged: true
  mergedAt: "2026-03-20T10:00:00Z"
利用可能なプリセット

ルール

ID 名前 リポジトリ
typescript TypeScript (Next.js) ai-dev-os-rules-typescript
python Python (FastAPI) ai-dev-os-rules-python

プラグイン

ID 名前 リポジトリ テンプレート Hooks
claude-code Claude Code ai-dev-os-plugin-claude-code CLAUDE.md Yes
kiro Kiro ai-dev-os-plugin-kiro AGENTS.md --
cursor Cursor ai-dev-os-plugin-cursor .cursorrules --
設計判断

CLI がやること

CLI は配達メカニズムです — git submodule のセットアップ、テンプレートのコピー、hooks のマージを行います。ルールやプラグインの中身は含みません。

CLI がやらないこと

判断 理由
rules/plugin の中身を CLI パッケージに内包 透明性・フォーク可能性が失われる
git submodule を廃止して npm 依存に置き換え 非 Node.js プロジェクトで使えなくなる
CLI を必須にする 「CLI なしでも使える」が設計原則
plugin リポジトリを廃止する CLI は「配達員」であり「コンテンツ」ではない
GitHub App / OAuth 連携 過剰。Git 操作だけで十分

核心原則

CLI は git submodule add と cp で手動でできることを自動化するものです。仮に CLI がなくなっても、AI Dev OS の全機能は手動セットアップで利用可能です。

関連

リポジトリ 説明
ai-dev-os コアフレームワーク
rules-typescript TypeScript / Next.js ガイドライン
rules-python Python / FastAPI ガイドライン
plugin-claude-code Claude Code 連携
plugin-kiro Kiro 連携
plugin-cursor Cursor 連携
benchmark 定量ベンチマーク — ガイドライン影響データ

ライセンス

MIT

言語: English | 日本語 | 简体中文 | 한국어 | Español