agent-harness

Agent Harness

サブコマンドのルーティング

/agent-harness <subcommand> として呼び出された場合、適切なワークフローに振り分けます。

サブコマンド	アクション
init <name>	python3 scripts/init_project.py "<name>" --project-dir "$(pwd)" を実行
sprint [req]	スプリントエージェントのワークフローを実行（references/sprint-agent.md を参照）
code	コーディングエージェントのワークフローを実行（references/coding-agent.md を参照）
996	996 並列オーケストレーションを実行（references/996-agent.md を参照）
status	python3 scripts/status.py --project-dir "$(pwd)" を実行
archive	アーカイブのワークフローを実行
force-archive	強制アーカイブのワークフローを実行
help または空	利用可能なコマンドを表示

使用例：

• /agent-harness init "My Project" - 新しいプロジェクトを初期化
• /agent-harness sprint "Add authentication" - スプリントを計画
• /agent-harness code - コーディングセッションを開始
• /agent-harness 996 - サブエージェントのオーケストレーションで並列コーディングを実行
• /agent-harness status - ステータスを表示

重要：スキルディレクトリではなく、必ず現在のプロジェクトディレクトリ内のファイルを操作してください。各ワークフローの開始時に、python3 scripts/resolve_project_dir.py を実行して正しい絶対パスを取得してください。features.json と progress.md の読み取り・書き込みには、すべてこのパスを使用してください。

スプリントエージェントとコーディングエージェントのサイクルを通じて、複雑な複数セッションのプロジェクトを実行するためのフレームワークです。

概要

Agent Harness を使うと、Claude は次の機能を通じて長期にわたるプロジェクトを管理できます。

• スプリントエージェント：機能を計画し、要件を細分化します
• コーディングエージェント：機能を一つずつ実装します
• 996 エージェント：サブエージェントを使って機能の並列実装を調整します
• 進捗の追跡：セッションをまたいでコンテキストを維持します
• 品質ゲート：各ステップでコードが動作することを確認します

コマンド

Agent Harness は、タブ補完に対応したスラッシュコマンドを提供します。/agent-harness と入力すると、すべてのコマンドが表示されます。

/agent-harness

利用可能なコマンドと使用方法を表示します。

出力：

Agent Harness Commands:
  /agent-harness init <name>           - Initialize new project tracking files
  /agent-harness sprint [req]          - Create or update sprint with feature breakdown
  /agent-harness code                  - Start coding session for next feature
  /agent-harness 996                   - Execute parallel coding with subagent orchestration
  /agent-harness status                - Show current project status
  /agent-harness archive               - Archive completed sprints
  /agent-harness force-archive         - Force archive ALL sprints (including incomplete)

/agent-harness init <name>

新しいプロジェクトの追跡ファイルを初期化します。

例： /agent-harness init My App

アクション：

• features.json と progress.md を作成
• python3 scripts/init_project.py "My App" を実行
• 初期化したファイルをコミット：git add features.json progress.md && git commit -m "chore: initialize project tracking"

/agent-harness sprint [requirements]

機能の内訳を含むスプリントを作成または更新します。

例：

• /agent-harness sprint - 現在のスプリントを確認し、次のスプリントを計画
• /agent-harness sprint Add user authentication with email and social login
• /agent-harness sprint Build dashboard with charts and filters

アクション：

1. 完了したスプリントがあればアーカイブ
2. 要件を分析
3. 受け入れ基準を定め、機能を個別に分割
4. features.json と progress.md のみを更新し、概要ドキュメントなどの追加ファイルは作成しない
5. スプリント計画の概要をターミナルに表示
6. コミットする前に、スプリント計画をユーザーに確認する
7. ユーザーの確認後、コミット：git add features.json progress.md && git commit -m "chore: sprint planning - <sprint-name>"
8. 詳細なワークフローについては sprint-agent.md を読む

/agent-harness code

次の機能のコーディングセッションを開始します。

アクション：

1. progress.md と features.json を確認
2. 次に保留中の機能を選択
3. セッションプロトコルに従って実装
4. 実装後にコードをコミット：git add -A && git commit -m "feat(<scope>): <description>"
5. プロトコルについては coding-agent.md を読む

/agent-harness 996

サブエージェントのオーケストレーションにより、コーディングタスクを並行して実行します。

例：

• /agent-harness 996 - デフォルト設定で並行オーケストレーションを実行します
• /agent-harness 996 --max-parallel=3 - 同時に実行するサブエージェントを3つに制限します

アクション：

1. 未完了のスプリントがあるか確認します
2. 依存関係とファイルの競合を分析します
3. 並行実行のためにサブエージェントを割り当てます
4. 結果を検証し、追跡ファイルを更新します
5. コミットします：git add -A && git commit -m "chore: 996 orchestration complete - N features"
6. プロトコルについては996-agent.mdをお読みください

使用するタイミング： 複数のコーディングタスクを並行して実行し、スプリントの完了を早めたい場合に使用します。

/agent-harness status

現在のプロジェクトのステータスを表示します。

出力：

• 現在のスプリントと目標
• 機能の完了状況
• 次に推奨される機能
• python3 scripts/status.pyを実行します

/agent-harness archive

完了したスプリントをアーカイブします。

アクション：

• 完了したスプリントを一覧表示します
• .agent-harness/archived/に移動します
• python3 scripts/archive_sprint.pyを実行します
• コミットします：git add -A && git commit -m "chore: archive completed sprint"

/agent-harness force-archive

未完了のものも含め、すべてのスプリントを強制的にアーカイブします。

警告： ステータスにかかわらず、すべてのスプリントがアーカイブされます。

アクション：

• アーカイブ対象のすべてのスプリントを一覧表示します
• ユーザーに確認します
• すべてを.agent-harness/archived/に移動します
• python3 scripts/archive_sprint.py --forceを実行します
• コミットします：git add -A && git commit -m "chore: force archive all sprints"

クイックスタート

python3 scripts/init_project.py "Project Name" -d "Description"
python3 scripts/status.py
python3 scripts/validate_structure.py

ワークフロー

1. スプリント計画（スプリントエージェント）

タイミング： 新規プロジェクトまたはイテレーションの開始時

1. ユーザー要件を分析します
2. 受け入れ条件を設定し、個別の機能に分割します
3. 依存関係に基づいて順序を決めます
4. features.jsonとprogress.mdを更新します

→ ワークフロー、スキーマ、例についてはreferences/sprint-agent.mdをお読みください

2. 機能の実装（コーディングエージェント）

タイミング： 各開発セッション

セッションの手順：

フェーズ	アクション
開始	pwd → progress.mdを読む → git log → lint/buildを実行
作業	機能を1つ選択 → 実装 → テスト
終了	progress.mdを更新 → features.jsonを更新 → コミット

→ 手順、テスト、スキーマについてはreferences/coding-agent.mdをお読みください

3. イテレーション

ループ：スプリントエージェント → コーディングエージェント → コーディングエージェント → ... → スプリントエージェント

コアファイル

ファイル	用途
features.json	スプリントと機能の追跡
progress.md	セッションログ - 先頭にエントリを追加します
AGENTS.md	プロジェクト固有の指示

→ スキーマについてはreferences/sprint-agent.mdまたはreferences/coding-agent.mdをご覧ください

スクリプト

すべてのスクリプトは、プロジェクトディレクトリを指定するための--project-dir / -pに対応しています。スラッシュコマンドを使う場合は、--project-dir "$(pwd)"が自動的に渡されます。

python3 scripts/resolve_project_dir.py [-s dir]                # Resolve project directory
python3 scripts/init_project.py <name> [-d desc] [-p dir]     # Initialize tracking
python3 scripts/status.py [-p dir]                             # Show status
python3 scripts/validate_structure.py [-p dir]                 # Validate features.json
python3 scripts/archive_sprint.py [-p dir] [--list|--dry-run]  # Archive completed sprints

重要：スクリプトを実行する際は、必ず$env:PYTHONIOENCODING="utf-8";を先頭に付けてください（WindowsのGBKとの互換性に必要です）。

重要なルール

1. 1セッションにつき機能は1つ - 複数の機能を実装しないでください
2. 常に動作するコードを残す - ビルドを壊さないでください
3. エンドツーエンドでテストする - ユーザーの体験を想定して検証してください
4. こまめにコミットする - 小さなコミットによりロールバックしやすくなります
5. 機能を削除しない - ステータスのみ変更してください
6. 進捗ログを使う - すべてのセッションを記録してください

リファレンス

エージェントの役割別：

• sprint-agent.md - スプリントエージェント：ワークフロー、機能の分割、スキーマ
• coding-agent.md - コーディングエージェント：セッションの手順、テスト、スキーマ
• 996-agent.md - 996エージェント：並行オーケストレーション、サブエージェントの割り当て、競合検出

完全な例：

• examples.md - features.json、progress.md、ワークフローの具体例