codex-harness: Instructions file for Codex

AGENTS.md - Codex harness 開発ガイド

このファイルは Codex CLI がこのリポジトリで作業する際の指針です。

プロジェクト概要

Harness は、Codex CLI を「Plan → Work → Review」の型で運用するためのガイドです。

特殊な点: このプロジェクトは「ハーネス自身を使ってハーネスを改善する」自己参照的な構成です。

Codex CLI の前提

• Codex は .codex/skills/<skill-name>/SKILL.md を読み込み、$skill-name で明示呼び出しする
• Codex は AGENTS.override.md を優先し、次に AGENTS.md、必要なら設定された fallback 名を参照する
• Hooks は未対応のため、暫定ガードは .codex/rules/*.rules の prefix_rule() で行う

開発ルール

コミットメッセージ

Conventional Commits に従う:

• feat: - 新機能
• fix: - バグ修正
• docs: - ドキュメント変更
• refactor: - リファクタリング
• test: - テスト追加/更新
• chore: - メンテナンス

バージョン管理

バージョンは VERSION がソース・オブ・トゥルース。 変更時は ./scripts/sync-version.sh bump を使用。

CHANGELOG 記載ルール（必須）

Keep a Changelog フォーマットに準拠

各バージョンエントリには以下のセクションを使用:

## [X.Y.Z] - YYYY-MM-DD

### Added
- 新機能について

### Changed
- 既存機能の変更について

### Deprecated
- 間もなく削除される機能について

### Removed
- 削除された機能について

### Fixed
- バグ修正について

### Security
- 脆弱性に関する場合

#### Before/After（大きな変更時のみ）

| Before | After |
|--------|-------|
| 変更前の状態 | 変更後の状態 |

セクション使い分け:

セクション	使うとき
Added	完全に新しい機能を追加したとき
Changed	既存機能の動作や体験を変更したとき
Deprecated	将来削除予定の機能を告知するとき
Removed	機能やコマンドを削除したとき
Fixed	バグや不具合を修正したとき
Security	セキュリティ関連の修正をしたとき

Before/After テーブル: 大きな体験変化（コマンド廃止・統合、ワークフロー変更、破壊的変更）があるときのみ追加。軽微な修正では省略可。

バージョン比較リンク: CHANGELOG.md 末尾に [X.Y.Z]: https://github.com/.../compare/vPREV...vX.Y.Z 形式で追加

コードスタイル

• 明確で説明的な名前を使う
• 複雑なロジックにはコメントを追加
• コマンド/エージェント/スキルは単一責任に保つ

リポジトリ構成

claude-code-harness/
├── codex/              # Codex CLI 配布物
├── commands/           # Claude Code 向けコマンド
├── agents/             # サブエージェント定義（Task tool で並列起動可能）
├── skills/             # エージェントスキル
├── scripts/            # シェルスクリプト（ガード、自動化）
├── templates/          # テンプレートファイル
├── docs/               # ドキュメント
└── tests/              # 検証スクリプト