Aphelion Wiki
Language: English | 日本語 Last updated: 2026-05-16 Update history:
- 2026-05-16: analyst 分割に伴いエージェント数を 40 → 42 に更新（analyst-intake + analyst-core 追加 #139）
- 2026-05-12: ルール数 13 → 14 に更新（document-locations ルール追加 #117）
- 2026-05-01: Hooks-Reference リンク追加、ルール数 12 → 13 に更新 (#107)
- 2026-05-01: visual-designer 追加に伴いエージェント数を 39 → 40 に更新 (#109)
- 2026-04-30: ルール数 9 → 12 に修正 (#103)
- 2026-04-30: Agents-Doc.md を Agents Reference に追加（5 → 6 ページ）、Doc Flow を用語集に追加 (#54)
- 2026-04-25: terminology rebalance per #40 EN canonical: 2026-05-16 of wiki/en/Home.md Audience: 全ユーザー
Aphelion Wiki へようこそ。このWikiはAphelion Claude Codeエージェントワークフローの詳細リファレンスです。
初めての方はこちら → Getting Started
このWikiについて
Section titled “このWikiについて”Aphelion のリポジトリの README はクイックスタートと概要をカバーしています。この Wiki は README が意図的に省略している詳細なリファレンスを提供します。
| README | Wiki |
|---|---|
| プロジェクト概要と背景 | Architecture: Domain Model: 3 ドメインモデルとセッション分離 |
| クイックスタートコマンド | Getting Started: Claude Code セットアップ、初回実行ウォークスルー、シナリオ、トラブルシューティング |
| トリアージプラン表（概要） | Triage System: 選択ロジック、条件、エージェントマトリクス |
| エージェント一覧（名前のみ） | Agents Reference（ドメイン別）: Orchestrators & Cross-Cutting, Discovery, Delivery, Operations, Maintenance, Doc — 42 エージェントの入出力と NEXT 条件 |
| — | Rules Reference: 14 つの行動ルールのスコープとカスタマイズ方法 |
| — | Hooks Reference: Aphelion が配布する Claude Code フック（MVP 3 フック） |
| — | Contributing: エージェント・ルールの追加方法、Wiki メンテナンス |
| ページ | 説明 | 主な読者 |
|---|---|---|
| Getting Started | Claude Code セットアップ、初回実行、利用シナリオ、コマンドリファレンス | 新規ユーザー |
| Architecture（3 ページ） | Domain Model, Protocols, Operational Rules — 3 ドメインモデル、ハンドオフファイル、AGENT_RESULT プロトコル、ランタイム挙動 | エージェント開発者 |
| Triage System | 4 ティアプラン選択ロジック、ドメイン別エージェントマトリクス、必須エージェント | 全ユーザー |
| Agents Reference（6 ページ） | Orchestrators & Cross-Cutting, Discovery, Delivery, Operations, Maintenance, Doc — 42 エージェント全件 | エージェント開発者 |
| Rules Reference | 14 つの行動ルール: スコープ・自動ロード・相互関係 | エージェント開発者 |
| Hooks Reference | Aphelion フック: 使用方法・bypass・無効化・カスタマイズ | 全ユーザー |
| Contributing | エージェント・ルールの追加、バイリンガル同期ワークフロー | エージェント開発者 |
ペルソナ別入口
Section titled “ペルソナ別入口”「Aphelionを初めて使いたい」
Section titled “「Aphelionを初めて使いたい」”- Getting Started を読む — 使用するプラットフォームのクイックスタート
/discovery-flowを実行- Triage System を読んでどのエージェントが起動するか理解する
「Aphelion の内部動作を理解したい」
Section titled “「Aphelion の内部動作を理解したい」”- Architecture: Domain Model を読む — ドメインモデルとセッション分離
- Architecture: Protocols を読む — ハンドオフファイルと AGENT_RESULT
- Agents Reference: Orchestrators & Cross-Cutting と各ドメイン 5 ページを読む — 各エージェントの責務と連携
- Rules Reference を読む — 全エージェントに適用される行動制約
「新しいエージェントやルールを追加したい」
Section titled “「新しいエージェントやルールを追加したい」”- Contributing を読む — ファイルテンプレートと AGENT_RESULT 契約
- Architecture: Domain Model を読む — 新エージェントの配置場所を理解する
- Rules Reference を読む — 自動適用されるルールを理解する
「既存プロジェクトのバグ修正や小さな機能追加をしたい」
Section titled “「既存プロジェクトのバグ修正や小さな機能追加をしたい」”- プロジェクトに
SPEC.mdとARCHITECTURE.mdがあることを確認 (ない場合はまず/codebase-analyzerを実行) /maintenance-flow {トリガー説明}を実行 — Flow Orchestrator が Patch / Minor / Major にトリアージします- 各プランの詳細は Triage System: Maintenance Flow Triage を参照
| 用語 | 定義 |
|---|---|
| ドメイン | ワークフローの3つの主要スコープのいずれか：Discovery（要件探索）、Delivery（設計・実装）、Operations（デプロイ・運用）。Maintenance は独立した第 4 のフロー、Doc は顧客向けドキュメント生成のための独立した第 5 のオンデマンドフロー |
| Flow Orchestrator（フローオーケストレーター） | フロー全体を管理する agent（discovery-flow / delivery-flow / operations-flow / maintenance-flow / doc-flow） |
| トリアージ | フロー開始時にプロジェクト規模を評価してプランティアを選択するプロセス |
| プラン | 4段階の実行ティアのいずれか：Minimal / Light / Standard / Full |
| ハンドオフファイル | ドメイン間で情報を受け渡すために使用される .md ファイル（DISCOVERY_RESULT.md、DELIVERY_RESULT.md） |
| AGENT_RESULT | 完了時に各エージェントが出力する構造化ブロック |
| NEXT | 次に実行されるエージェントを指定する AGENT_RESULT のフィールド |
| STATUS | 完了ステータスフィールド：success / error / failure / suspended / blocked |
| blocked | 設計上の曖昧さによりエージェントが続行できない場合に使用する STATUS |
| 正規ソース（canonical source） | .claude/ — Claude Code の権威ある定義ファイル |
| PRODUCT_TYPE | プロジェクト成果物の分類：service / tool / library / cli |
| HAS_UI | プロジェクトにユーザーインターフェースが含まれるか（起動するエージェントに影響） |
| 自動承認モード | .aphelion-auto-approve ファイルで有効化されるモード。自動評価のために承認ゲートをスキップ |
| Maintenance フロー | 3 ドメインパイプラインから独立した第 4 のフロー。/maintenance-flow で起動し、既存プロジェクトの保守 (バグ・CVE・リファクタ・小機能追加) を扱う。トリアージは Patch / Minor / Major |
| MAINTENANCE_RESULT.md | Major プランでのみ生成されるハンドオフファイル。Delivery Flow の前処理として引き渡される |
| Doc フロー | 第 5 のフロー、オンデマンド。/doc-flow で起動し、顧客向け納品ドキュメント（HLD・LLD・API リファレンス・運用マニュアル・ユーザーマニュアル・引継ぎ資料）を生成する。トリアージは doc type 数ベース（1〜2→Minimal・3〜4→Light・5〜6→Standard・全 6 種+検証→Full）。自動連鎖なし |
| DOC_FLOW_RESULT.md | Doc フローの最終出力。生成済み deliverable・スキップ種別・次のステップを記録 |
- .claude/rules/aphelion-overview.md — Aphelionワークフロー概要（自動ロード）
- README.ja.md — プロジェクト入口（日本語）