agent-folder-init

エージェントフォルダーの初期化

許可された範囲

ユーザーの依頼と既存の承認の範囲内でのみ作業してください。このスキルを読み込んでも、新たな権限は付与されません。報告のみの依頼は報告のみにとどめ、依頼者が指定した対象、ホスト、プロバイダー、コスト上限を守ってください。範囲を広げる前に確認し、これらの制限を委任先にも伝えてください。

契約

入力：

• 既存のプロジェクトルート
• プロジェクト名と主要な技術スタック
• オプションのプラットフォーム用エントリーポイント：Claude Code、Codex、Cursor のいずれか、または複数

出力：

• デフォルトではドライランの計画
• 明示的に --write を指定した後の .agents/ ドキュメント構造とルートの AGENTS.md
• オプションの CLAUDE.md または .cursor/rules/agent-context.mdc。選択したプラットフォームが明示されている場合のみ生成されます。Codex は AGENTS.md を使用します
• 計画済み、書き込み済み、スキップ済み、変更なしのファイルの概要

作成・変更するもの：

• .agents/、ルートの AGENTS.md、オプションの CLAUDE.md、オプションの Cursor プロジェクトルール、.editorconfig
• アプリケーションのソースコードは作成しません

外部への副作用：

• デフォルトのドライランではありません。--write を指定した場合、ローカルファイルへの書き込みのみを行います

必要な確認：

• 書き込みを行う前に、ドライランの計画を確認し、--write を指定して再実行すること
• 既存のエントリーファイルを上書きする前に、--force-entry-files を追加すること。シンボリックリンクと通常ファイル以外の対象は常に拒否されます
• 現在のワークスペース外に書き込む前

委任先：

• 新しい製品リポジトリを開始する場合は project-init-orchestrator
• 新しい Shipshit.dev 製品をスキャフォールドする場合は project-init-orchestrator（v0 のルート）／npx @shipshitdev/v0
• 生成後にドリフトや古い設定を検出する場合は agent-config-audit

目的

このスキルは、以下を含む簡潔な AI エージェント用ドキュメントシステムを計画し、スキャフォールドします。

• セッションの追跡（.agents/sessions/ 内の日別ファイル）
• .agents/memory/ に保存する永続的なプロジェクトコンテキスト（ファイルごとにトピックは 1 つ）
• コマンド、ルール、エージェント、ユーザー設定、または別プロジェクトの設定をコピーせずに、サポート対象のプラットフォーム用エントリーポイントを用意

使用する場面

• 既存プロジェクトに AI コーディングアシスタント向けのコンテキストを追加する場合
• AI ファーストの開発ワークフローを設定する場合
• 既存プロジェクトを構造化された AI ドキュメントの利用に移行する場合

新しい Shipshit.dev 製品リポジトリでは、npx @shipshitdev/v0 にルーティングし、標準の .agents、.claude、.codex の設定を含む project-init-orchestrator を優先してください。

使用方法

スキャフォールドスクリプトを実行します。

python3 scripts/scaffold.py --help

# Basic usage
python3 scripts/scaffold.py \
  --root /path/to/project \
  --name "My Project"

# Review the plan, then write the shared files
python3 scripts/scaffold.py \
  --root /path/to/project \
  --name "My Project" \
  --write \
  --allow-outside

# Add only the documented Claude and Cursor entry surfaces
python3 scripts/scaffold.py \
  --root /path/to/project \
  --name "My Project" \
  --platform claude \
  --platform cursor \
  --write \
  --allow-outside

デフォルトでは常にドライランになります。--force-entry-files は、AGENTS.md、CLAUDE.md、または生成された Cursor エントリールールの上書きを許可する唯一のフラグです。その他の既存ファイルは保持されます。

生成される構造

ドキュメント（.agents/）

.agents/
├── README.md                    # Navigation hub
├── memory/
│   └── README.md                # Source of truth for durable project facts
└── sessions/
    ├── README.md                # Session format guide
    └── TEMPLATE.md              # Session file template

共有ルールとコーディング標準は、該当する AGENTS.md に記述します。AGENTS.override.md は意図的にサブツリーをオーバーライドする場合のみ使用し、CLAUDE.md は Claude 固有の追加事項にのみ使用してください。永続的な補足情報は .agents/memory/ に記述します。

タスク追跡には GitHub Issues（gh issue list、gh issue create）を使用します。ローカルのタスクファイルは使用しません。

プラットフォーム用エントリーポイント

AGENTS.md                         # shared instructions; native Codex entry
CLAUDE.md                         # only with --platform claude
.cursor/rules/agent-context.mdc   # only with --platform cursor

このスキャフォールドは .codex/commands を生成せず、ユーザー設定をコピーせず、ライブラリのチェックアウトをインポートしません。コピーするのは 4 つの .agents/ テンプレート、.editorconfig、および明示的に選択されたエントリーテンプレートのみです。正規のアセットが見つからない場合、書き込み前に処理を失敗させます。埋め込みの代替や古い代替はありません。

ルートファイル

• AGENTS.md - 共有プロジェクト指示と .agents/ の案内
• CLAUDE.md - AGENTS.md を参照する Claude 固有の追加事項（オプション）
• .editorconfig - エディター設定

主なパターン

memory/ ファイル

• ファイルごとにトピックは 1 つ：memory/architecture.md、memory/deployment.md、memory/entities.md など
• 各ファイルには、フロントマターに last_verified: YYYY-MM-DD フィールドを記載します。
• 一時的または短期間のみ有効な事実には status: temporary を追加します。

セッションファイル

• 1 日につき 1 ファイル：sessions/YYYY-MM-DD.md
• 同じ日に複数のセッションがある場合は、同じファイル内で「Session 1」「Session 2」などを使用します。

カスタマイズ

スキャフォールディング後に、次の項目をカスタマイズします。

1. ルートエージェントのエントリーファイル - プロジェクト固有のコーディング規約と「絶対にしてはいけないこと」のルールを追加します
2. .agents/memory/architecture.md - アーキテクチャの決定事項を記録します
3. .agents/memory/entities.md - データエンティティを記録します
4. .agents/memory/deployment.md - デプロイ手順と注意点を記録します
5. GitHub Issues - タスクの Issue を作成します（gh issue create）
6. プラットフォームのエントリーファイル - 共通の AGENTS.md に記載できない、ハーネス固有のガイダンスのみを追加します

他のスキルとの連携

このスキルは次のスキルと連携します。

スキル	連携方法
project-init-orchestrator	下位レベルのセットアップの前に、新しい製品のリクエストを v0 に振り分けます
project-init-orchestrator	新しい Shipshit.dev 製品ワークスペースに v0 を使用します
linter-formatter-init	スキャフォールディングしたプロジェクトに品質管理ツールをセットアップします
husky-test-coverage	pre-commit フックでテストカバレッジを適用します