rule-creator

ルール作成者

.claude/rules/ にルールファイルを作成します。ルールは Claude Code によって自動検出され、エージェントのコンテキストに読み込まれます。

ステップ 0：既存のルールを確認する

作成する前に、ルールがすでに存在しているか確認します。

test -f .claude/rules/<rule-name>.md && echo "EXISTS" || echo "NEW"

存在する場合 → Read を使用して現在のルールファイルを確認し、Edit を使用して直接変更を適用します。更新後に、作成後の統合手順（ステップ 4）を実行します。

新規の場合 → ステップ 0.5 に進みます。

ステップ 0.5：関連項目の確認

作成に進む前に、エコシステムの関連項目を確認します。

1. .claude/lib/creators/companion-check.cjs の companion-check.cjs を使用します
2. checkCompanions("rule", "{rule-name}") を呼び出して、関連するアーティファクトを特定します
3. 関連項目チェックリストを確認し、不足している必須／推奨項目を記録します
4. このアーティファクトの完成後に、不足している関連項目を作成または検証する計画を立てます
5. 作成後の統合メモに、関連項目の確認結果を含めます

このステップは参考情報であり（作成を妨げるものではありません）、アーティファクトのエコシステム全体を考慮するためのものです。

使用する場面

• プロジェクト固有のコーディングガイドラインを作成する
• フレームワークの規約を文書化する
• チーム標準を確立する
• ワークフロープロトコルを定義する

ルールファイルの形式

ルールはシンプルな Markdown ファイルです。

# Rule Name

## Section 1

- Guideline 1
- Guideline 2

## Section 2

- Guideline 3
- Guideline 4

例：testing.md

# Testing

## Test-Driven Development

- Use TDD for new features and bug fixes (Red-Green-Refactor cycle)
- Write failing test first, then minimal code to pass, then refactor
- Never write production code without a failing test first

## Test Organization

- Add unit tests for utilities and business logic
- Add integration tests for API boundaries
- Keep tests deterministic and isolated (no shared state)
- Place test files in `tests/` directory mirroring source structure

作成ワークフロー

ステップ 1：入力を検証する

// Validate rule name (lowercase, hyphens only)
const ruleName = args.name.toLowerCase().replace(/[^a-z0-9-]/g, '-');

// Validate content is not empty
if (!args.content || args.content.trim().length === 0) {
  throw new Error('Rule content cannot be empty');
}

ステップ 2：ルールファイルを作成する

const rulePath = `.claude/rules/${ruleName}.md`;

// Format content as markdown
const content = args.content.startsWith('#')
  ? args.content
  : `# ${ruleName.replace(/-/g, ' ').replace(/\b\w/g, l => l.toUpperCase())}\n\n${args.content}`;

await writeFile(rulePath, content);

必須：インデックスに登録する

pnpm index-rules

total_rules の数が増えていることを確認します。インデックスに登録されるまで、ルールはエージェントから認識されません。

ステップ 3：自動検出を確認する

.claude/rules/ 内のルールは Claude Code によって自動的に読み込まれます。手動で登録する必要はありません。

// Verify file was created
const fileExists = await exists(rulePath);
if (!fileExists) {
  throw new Error('Rule file creation failed');
}

ステップ 4：作成後の統合を実行する

const {
  runIntegrationChecklist,
  queueCrossCreatorReview,
} = require('.claude/lib/creators/creator-commons.cjs');

await runIntegrationChecklist('rule', rulePath);
await queueCrossCreatorReview('rule', rulePath, {
  artifactName: ruleName,
  createdBy: 'rule-creator',
});

作成後の統合

ルールの作成後、統合チェックリストを実行します。

const {
  runIntegrationChecklist,
  queueCrossCreatorReview,
} = require('.claude/lib/creators/creator-commons.cjs');

// 1. Run integration checklist
const result = await runIntegrationChecklist('rule', '.claude/rules/<rule-name>.md');

// 2. Queue cross-creator review
await queueCrossCreatorReview('rule', '.claude/rules/<rule-name>.md', {
  artifactName: '<rule-name>',
  createdBy: 'rule-creator',
});

// 3. Review impact report
// Check result.mustHave for failures - address before marking complete

統合の検証：

• .claude/rules/ にルールファイルが作成されている
• ルールが Claude Code によって自動検出される
• ルールの内容が明確で、実行可能である
• 既存のルールと競合していない

使用例

コード標準ルールを作成する

Skill({
  skill: 'rule-creator',
  args: `--name code-standards --content "# Code Standards

## Organization
- Prefer small, cohesive files over large ones
- Keep interfaces narrow; separate concerns by feature

## Style
- Favor immutability; avoid in-place mutation
- Validate inputs and handle errors explicitly"`,
});

Git ワークフロールールを作成する

Skill({
  skill: 'rule-creator',
  args: `--name git-workflow --content "# Git Workflow

## Commit Guidelines
- Keep changes scoped and reviewable
- Use conventional commits: feat:, fix:, refactor:, docs:, chore:

## Branch Workflow
- Create feature branches from main
- Never force-push to main/master"`,
});

関連スキル

• skill-creator - 詳細なワークフローを作成します（完全な SKILL.md を必要とする複雑なガイダンス向け）
• hook-creator - ガバナンスルールに付随する強制フックを作成します

絶対原則

1. すべてのアーティファクトに関連スキーマが必須です — スキーマのないルールには、構造化検証のための契約がありません。ルールが構造化出力を生成する場合、または設定可能なパラメーターを持つ場合は、.claude/schemas/ に JSON スキーマを作成します。
2. すべてのアーティファクトは、少なくとも 1 つのエージェントに接続する必要があります — どのエージェントやスキルからも参照されないルールは孤立しています。そのルールが少なくとも 1 つのエージェントのコンテキストに関連していることを確認します（.claude/rules/ 内のルールは自動読み込みされますが、ドメイン固有のルールはエージェントのプロンプトから参照する必要があります）。
3. すべてのアーティファクトはカタログに登録する必要があります — カタログで追跡されていないルールは、発見や監査が困難です。適切なカタログにエントリーを追加するか、登録済みであることを確認します。
4. すべてのアーティファクトは統合検証に合格する必要があります — 作成完了とする前に、node .claude/tools/cli/validate-integration.cjs <rule-path> を実行します。検証に失敗するルールには、参照切れや競合がある可能性があります。
5. すべてのアーティファクトはメモリーエントリーを記録する必要があります — ルールの作成パターン、判断事項、問題点を .claude/context/memory/（learnings.md、decisions.md、issues.md）に記録します。メモリーがなければ、作成したことは今後のセッションから認識できません。

メモリープロトコル（必須）

開始前： .claude/context/memory/learnings.md を読みます。

完了後：

• 新しいルールのパターン → .claude/context/memory/learnings.md
• ルール作成時の問題 → .claude/context/memory/issues.md
• ガイドラインに関する判断 → .claude/context/memory/decisions.md

中断を前提としてください。メモリーに記録されていなければ、実施されていないものとみなします。

相互参照：クリエイターエコシステム

このスキルはクリエイターエコシステムの一部です。調査で不足が判明した場合は、適切な関連クリエイターを呼び出してください。

発見された不足	必要な成果物	呼び出すクリエイター	呼び出すタイミング
ドメイン知識を再利用可能なスキルにする必要がある	skill	Skill({ skill: 'skill-creator' })	不足がスキル領域全体に及ぶ場合
既存スキルのカバー範囲が不完全である	skill update	Skill({ skill: 'skill-updater' })	類似するスキルが存在するが不完全な場合
専用エージェントが必要な機能がある	agent	Skill({ skill: 'agent-creator' })	その機能を担うエージェントが必要な場合
既存エージェントに機能の更新が必要である	agent update	Skill({ skill: 'agent-updater' })	類似するエージェントが存在するが不完全な場合
ドメインにコード／プロジェクトのひな形が必要である	template	Skill({ skill: 'template-creator' })	再利用可能なコードパターンが必要な場合
動作に実行前／実行後のガードが必要である	hook	Skill({ skill: 'hook-creator' })	強制適用する動作が必要な場合
プロセスに複数フェーズのオーケストレーションが必要である	workflow	Skill({ skill: 'workflow-creator' })	複数ステップの調整が必要な場合
成果物に構造化された入出力の検証が必要である	schema	Skill({ skill: 'schema-creator' })	成果物の入出力に JSON スキーマが必要な場合
ユーザーとのやり取りにスラッシュコマンドが必要である	command	Skill({ skill: 'command-creator' })	ユーザー向けのショートカットが必要な場合
繰り返し使うロジックに再利用可能な CLI ツールが必要である	tool	Skill({ skill: 'tool-creator' })	CLI ユーティリティが必要な場合
限定的／単一成果物のみの機能	inline	この成果物内にのみ記載する	汎用化するには特定性が高すぎる場合

---

エコシステム連携契約（必須）

このクリエイタースキルは、連携するクリエイターエコシステムの一部です。ここで作成する成果物はすべて、関連するクリエイターと連携し、その検証に合格する必要があります。

• 所有者と実行経路については agent-creator
• 機能のパッケージ化と割り当てについては skill-creator
• 実行可能な自動化の窓口については tool-creator
• 強制適用とガードレールについては hook-creator
• ポリシーと静的チェックについては rule-creator と semgrep-rule-creator
• 標準化されたひな形については template-creator
• オーケストレーションとフェーズ管理については workflow-creator
• ユーザー／オペレーター向けコマンド UX については command-creator

クリエイター間のハンドシェイク（必須）

完了前に、関連するすべてのハンドシェイクを確認してください。

1. 成果物のルートが .claude/CLAUDE.md と関連するルーティングドキュメントに存在すること。
2. 検出／レジストリエントリーが更新されていること（該当するカタログ／インデックス／レジストリ）。
3. 関連する成果物が作成されているか、理由を明示して免除されていること。
4. 作成した成果物に対して validate-integration.cjs が成功すること。
5. スキルのメタデータを変更した場合は、スキルインデックスが再生成されていること。

Research Gate（Exa + arXiv — 両方必須）

新しいパターン、テンプレート、ワークフローを導入する場合は、調査が必須です。

1. 実装パターンとエコシステムのパターンを調査するには、Exa を使用します。
   • mcp__Exa__web_search_exa({ query: '<topic> 2025 best practices' })
   • mcp__Exa__get_code_context_exa({ query: '<topic> implementation examples' })
2. 学術研究を調べるには、arXiv を検索します（AI／ML、エージェント、評価、オーケストレーション、メモリ／RAG、セキュリティでは必須です）。
   • Exa 経由：mcp__Exa__web_search_exa({ query: 'site:arxiv.org <topic> 2024 2025' })
   • 直接 API：WebFetch({ url: 'https://arxiv.org/search/?query=<topic>&searchtype=all&start=0' })
3. 決定事項、制約事項、対象外の事項を、成果物の参照先やドキュメントに記録します。
4. 更新は最小限にとどめ、過剰な設計は避けます。

次のトピックに関わる場合、arXiv の調査は必須であり、代替手段ではありません： AI エージェント、LLM の評価、オーケストレーション、メモリ／RAG、セキュリティ、静的解析、または新たな方法論。

回帰に配慮したデリバリー

• 動作変更には、厳密に RED → GREEN → REFACTOR の手順を適用します。
• 変更したモジュールを対象にテストを実行します。
• 変更したファイルに対して、リンターとフォーマッターを実行します。
• コミットは関心事ごと（ロジック／ドキュメント／生成物）に分けます。