ユーザーとしての開発者
AI コーディングツールの時代において、「ユーザー」と「開発者」の境界線は消えつつあります。バグを説明できれば、修正できます。機能を想像できれば、構築できます — コードベースをすでに理解している AI アシスタントと一緒に。
VMark はこの考え方を取り入れています。リポジトリには AI コーディングツール向けのプロジェクトルール、アーキテクチャドキュメント、規約があらかじめ設定されています。リポジトリをクローンし、AI アシスタントを開いて、コントリビュートを始めましょう — AI はすでに VMark の動作を知っています。
はじめに
- リポジトリをクローンする — AI 設定はすでに配置されています。
- AI ツールをインストールする — Claude Code、Codex CLI、またはGemini CLI。
- セッションを開く — ツールが
AGENTS.mdとルールを自動的に読み込みます。 - コーディングを始める — AI はプロジェクトの規約、テスト要件、アーキテクチャパターンを知っています。
追加のセットアップは不要です。AI に手伝ってもらうだけで始められます。
読書ガイド
AI を活用した開発が初めての方へ。これらのページは互いに積み重なっています:
- なぜ VMark を作ったのか — 非プログラマーがスクリプトからデスクトップアプリへと歩んだ旅
- AI を超強化する 5 つの基本的なスキル — Git、TDD、ターミナルリテラシー、英語、センス — すべての基盤となるもの
- 高価なモデルがなぜ安いのか — トークン単価はバニティメトリクス。タスク単価が重要
- サブスクリプション vs API プライシング — コーディングセッションでフラットレートサブスクリプションがトークン課金より優れている理由
- 英語プロンプトの方が優れている理由 — 翻訳、洗練、そして
::フック - クロスモデル検証 — Claude + Codex を使って互いに監査し、より良いコードを得る
- Issue であり PR ではない理由 — AI が管理するコードベースで Issue を受け付けて PR を受け付けない理由
- コストと工数の評価 —— 人間のチームで VMark を構築するコスト vs. AI 支援開発の実際のコスト
基本に慣れている方は、高度なワークフローのためにクロスモデル検証に直接進むか、VMark の AI 設定がどのように機能するかについてお読みください。
1 つのファイル、すべてのツール
AI コーディングツールはそれぞれ独自の設定ファイルを読み込みます:
| ツール | 設定ファイル |
|---|---|
| Claude Code | CLAUDE.md |
| Codex CLI | AGENTS.md |
| Gemini CLI | GEMINI.md |
3 か所で同じ指示を管理するのはエラーを起こしやすいです。VMark はこれを単一の情報源で解決しています:
AGENTS.md— すべてのプロジェクトルール、規約、アーキテクチャノートを含みます。CLAUDE.md— たった 1 行:@AGENTS.md（ファイルをインラインに展開する Claude Code ディレクティブ）。- Codex CLI —
AGENTS.mdを直接読み込みます。 - Gemini CLI —
GEMINI.mdの@AGENTS.mdを使って同じファイルをインラインに展開します。
AGENTS.mdを一度更新すれば、すべてのツールが変更を受け取ります。
@AGENTS.mdとは?
@プレフィックスは別のファイルのコンテンツをインラインに展開する Claude Code ディレクティブです。C の#includeに似ています — AGENTS.mdのコンテンツがその位置でCLAUDE.mdに挿入されます。詳細はagents.mdをご覧ください。
セカンドオピニオンとして Codex を使う
VMark はクロスモデル検証を使用しています — Claude がコードを書き、次に別の AI モデルである Codex（OpenAI から）が独立して監査します。これにより単一モデルが見落とす盲点を捉えます。詳細なセットアップ手順については、クロスモデル検証をご覧ください。
AI が知っていること
AI コーディングツールが VMark リポジトリを開くと、自動的に以下を受け取ります:
プロジェクトルール（.claude/rules/）
これらのファイルはすべての Claude Code セッションに自動読み込みされます。以下をカバーします:
| ルール | 強制する内容 |
|---|---|
| TDD ワークフロー | テストファースト必須; カバレッジ閾値がビルドをブロック |
| デザイントークン | 色のハードコードは禁止 — 完全な CSS トークンリファレンス付き |
| コンポーネントパターン | ポップアップ、ツールバー、コンテキストメニューパターンとコード例 |
| フォーカスインジケーター | アクセシビリティ: キーボードフォーカスは常に見えなければならない |
| ダークテーマ | .dark-themeセレクタールール、トークンパリティ要件 |
| キーボードショートカット | 3 ファイル同期手順（Rust、TypeScript、ドキュメント） |
| バージョンバンプ | 5 ファイル更新手順 |
| コードベース規約 | ストア、フック、プラグイン、テスト、インポートパターン |
カスタムスキル
スラッシュコマンドが AI に特化した機能を与えます:
| コマンド | 動作 |
|---|---|
/fix | 適切に問題を修正 — 根本原因分析、TDD、パッチなし |
/fix-issue | エンドツーエンドの GitHub Issue 解決（取得、ブランチ、修正、監査、PR） |
/codex-audit | 完全な 9 次元コード監査（セキュリティ、正確さ、準拠など） |
/codex-audit-mini | 小さな変更向けの高速 5 次元チェック |
/codex-verify | 以前の監査からの修正を検証 |
/codex-commit | 変更分析からのスマートコミットメッセージ |
/audit-fix | 監査、すべての発見を修正、検証 — クリーンになるまで繰り返す |
/feature-workflow | 特化したエージェントによるエンドツーエンドのゲート付きワークフロー |
/release-gate | 完全な品質ゲートを実行してレポートを生成 |
/merge-prs | オープンな PR を順番にレビューしてマージ |
/bump | 全 5 ファイルにわたるバージョンバンプ、コミット、タグ、プッシュ |
特化エージェント
複雑なタスクのために、Claude Code は特化サブエージェントに委任できます:
| エージェント | 役割 |
|---|---|
| プランナー | ベストプラクティスを調査し、エッジケースをブレインストーミングし、モジュール式のプランを作成 |
| 実装者 | プリフライト調査付きの TDD 駆動実装 |
| 監査者 | 正確さとルール違反について diff をレビュー |
| テストランナー | ゲートを実行し、Tauri MCP を通じて E2E テストを調整 |
| 検証者 | リリース前の最終チェックリスト |
プライベートオーバーライド
すべてのことが共有設定に含まれるわけではありません。個人的な好みには:
| ファイル | 共有? | 目的 |
|---|---|---|
AGENTS.md | はい | すべての AI ツールのプロジェクトルール |
CLAUDE.md | はい | Claude Code エントリーポイント |
.claude/settings.json | はい | チーム共有の権限 |
CLAUDE.local.md | いいえ | あなたの個人的な指示（gitignore） |
.claude/settings.local.json | いいえ | あなたの個人的な設定（gitignore） |
自分にのみ適用される指示のために、プロジェクトルートにCLAUDE.local.mdを作成します — 好みの言語、ワークフローの習慣、ツールの好みなど。