원클릭으로 Manus에서 모든 스킬 실행

pekko-gap-analysis

스타7

포크0

업데이트2026년 5월 13일 03:59

fraktor-rsの指定モジュール（actor / stream / remote / cluster / persistence / utils などの論理名）と Apache Pekkoの参照実装を比較し、不足機能を洗い出すギャップ分析スキル。公開API・trait・オペレーター・パターンを両側から抽出し、カテゴリ別に分類して難易度を付与する。APIレベルのギャップが少ない場合は、内部モジュール構造（責務分割・層配置・依存方向）の差分も分析する。トリガー：「Pekkoと比較して不足機能を洗い出して」「gap analysis」「ギャップ分析」「references/pekkoとの差分」「不足オペレーターを調べて」「Pekko対応状況」「modules/{name}の不足機能」といったPekko参照実装との比較リクエストで起動。

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

j5ik2o

j5ik2o/fraktor-rs

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

Pekko ギャップ分析

論理モジュール名 {name} に対応する fraktor-rs の現行クレート群と references/pekko/ 配下の参照実装を比較し、不足機能を体系的に完全に洗い出す。 ※YAGNIはここでは適用しないこと。完了のための計画を出す必要があります。中途半端な計画はNGです。

分析は以下の二段階で行う：

まず公開APIレベルのギャップを分析する
APIギャップが十分に少ない場合のみ、内部モジュール構造のギャップ分析に進む

APIギャップが大きい段階では、内部構造の差分よりも公開契約の不足解消が優先である。逆にAPIギャップが小さい段階では、次の改善余地は「内部責務の切り方」「層配置」「依存方向」に移る。

引数

モジュール名をケバブケースまたはスネークケースで受け取る。

/pekko-gap-analysis stream
/pekko-gap-analysis actor
/pekko-gap-analysis cluster

fraktor-rs の現行層構造

このリポジトリでは、論理モジュール名と実クレート名が 1:1 ではない。比較前に必ず modules/*/src/lib.rs と実ディレクトリを確認し、現在の crate split を基準 にスコープを定義すること。

基本形は *-core と *-adaptor-std の分離
actor-core は core/kernel/ と core/typed/ を持つ
remote-core だけは src/core/ ではなく src/domain/ を公開境界としている。remote parity では domain/ を core 相当として扱う
persistence-core は現状 *-adaptor-std と core/typed を持たない
std adaptor は core/domain の port を実装する詳細であり、JVM 実装技術との 1:1 互換を要求しない
embedded は将来の層として言及されることがあるが、現行ツリーに存在しない限り比較スコープへ仮定して入れない

Pekko との層マッピング

Pekko	fraktor-rs
`pekko/actor` (untyped)	`modules/actor-core/src/core/kernel/`
`pekko/actor-typed`	`modules/actor-core/src/core/typed/`
`pekko-stream`	`modules/stream-core/src/core/`
`pekko-remote` artery core	`modules/remote-core/src/domain/`
ランタイム固有アダプタ実装	`modules/*-adaptor-std/src/std/`

注意: すべてのモジュールが typed/ や std/ を持つわけではない。必ず src/lib.rs と実ディレクトリを確認してからマッピングを決定すること。

actor モジュールの固定スコープ

/pekko-gap-analysis actor では、汎用の modules/{name}/src/ ではなく、現行リポジトリ構造に合わせて次のパスを使う。

層	fraktor-rs 側	Pekko 側
kernel	`modules/actor-core/src/core/kernel/`	`references/pekko/actor/src/main/scala/org/apache/pekko/actor/`
typed wrapper	`modules/actor-core/src/core/typed/`	`references/pekko/actor-typed/src/main/scala/org/apache/pekko/actor/typed/`
std adaptor	`modules/actor-adaptor-std/src/std/`	actor runtime の std / JVM 実装相当のうち Rust で再現可能な adapter 契約

actor 調査では、まず 比較スコープ定義 を出力し、そのスコープだけを parity 分母にする。 Pekko ディレクトリ配下の raw 公開型数をそのまま分母にしてはならない。

actor parity 対象に含めるもの

Rust の actor runtime として意味を持つ公開契約だけを対象にする。

kernel actor core: actor, context, ref, path, selection, props, system message
supervision / lifecycle: supervisor strategy, directive, restart, DeathWatch, termination
typed core: typed actor ref, actor system, behavior, signal, interceptor, typed context
dispatch / mailbox: dispatcher abstraction, executor port, mailbox contract, mailbox requirement
routing: kernel / typed routing semantics, routee, routing logic, pool / group equivalent
event / logging: event stream, dead letter, logging adapter, tracing adapter contract
pattern: ask, pipe, retry, graceful stop, circuit breaker
receptionist / discovery: service key, receptionist command, listing
scheduling / timers: scheduler, timer scheduler, receive timeout
ref / resolution: actor path, selection, identify / identity
delivery / pubsub: producer / consumer controller, durable producer queue, topic
serialization contract: serializer trait, manifest, registry, transport information
extension: extension id, setup, registry
coordinated shutdown: phase, task, reason, termination
std adaptor: tokio / executor / scheduler / tracing など、core の port を実装する Rust 側 adapter

actor parity 対象外にするもの

次は n/a として分類し、actor parity の分母に入れない。

Java DSL / Java interop: AbstractActor, UntypedAbstractActor, ReceiveBuilder, BehaviorBuilder, javadsl/*, japi/*
Scala 構文拡張: implicit ops, package object convenience API
JVM reflection / classloader: DynamicAccess, ReflectiveDynamicAccess, ClassLoaderObjectInputStream
HOCON dynamic loading / configurator facade: JVM 設定ロード方式に依存する provider / configurator
Java serialization: JavaSerializer, DisabledJavaSerializer
JFR / flight recorder events
deprecated classic remoting / Netty / Aeron 固有実装
Pekko IO / TCP / UDP / DNS: actor core ではなく transport / network adapter の別スコープ
actor runtime に不要な Pekko util 全体互換: runtime 契約に必要な ByteString 等だけを対象にする
testkit 専用 API: ユーザーが testkit 調査を明示した場合だけ別スコープで扱う

actor 調査で必ず確認する項目

actor では次の順で確認し、レポートに根拠を残す。

現行パスが modules/actor-core と modules/actor-adaptor-std に分かれていることを確認する。modules/actor/src/ が存在しなくてもエラー扱いにしない。
references/pekko/actor/ と references/pekko/actor-typed/ を参照し、対象外 API を除いた parity 分母を作る。
カテゴリ別に、同名 API だけでなく同等セマンティクスを持つ別名実装も対応済みとして扱う。
todo!() / unimplemented!() / placeholder を検索し、スタブがあれば部分実装として記録する。
公開 API ギャップが少ない場合は、内部構造として DeathWatch の remote AddressTerminated 統合、kernel の public surface、typed/untyped 分離、core/std 境界を確認する。
raw 抽出数を出す場合は参考値として別枠に置き、parity カバレッジや「ギャップ大」の根拠にしない。
Pekko IO / TCP / UDP / DNS を調べる必要が出た場合は、actor core parity ではなく transport / network adapter の別ギャップ分析として明記する。

その他モジュールの固定スコープ

actor 以外も、現行リポジトリの *-core / *-adaptor-std 構造を優先する。固定スコープが定義されているモジュールでは、modules/{name}/src/ と references/pekko/{name}/src/ の単純対応を使わない。

引数	fraktor-rs 側	Pekko 側
`stream`	`modules/stream-core/src/core/`, `modules/stream-adaptor-std/src/std/`	`references/pekko/stream/src/main/`, `references/pekko/stream-typed/src/main/`
`remote`	`modules/remote-core/src/domain/`, `modules/remote-adaptor-std/src/std/`	`references/pekko/remote/src/main/`
`cluster`	`modules/cluster-core/src/core/`, `modules/cluster-adaptor-std/src/std/`	`references/pekko/cluster/src/main/`, `references/pekko/cluster-typed/src/main/`, `references/pekko/cluster-sharding/src/main/`, `references/pekko/cluster-sharding-typed/src/main/`, `references/pekko/cluster-tools/src/main/`, `references/pekko/distributed-data/src/main/`
`persistence`	`modules/persistence-core/src/core/`（現状 `*-adaptor-std` なし）	`references/pekko/persistence/src/main/`, `references/pekko/persistence-typed/src/main/`（`persistence-shared` は runtime API が必要なときだけ補助参照）
`utils`	`modules/utils-core/src/core/`, `modules/utils-adaptor-std/src/std/`	`references/pekko/actor/src/main/scala/org/apache/pekko/util/` のうち fraktor runtime に必要な utility

stream の対象範囲

stream では、Pekko Streams の実行モデルと operator semantics を対象にする。Scala / Java DSL の表層名ではなく、Rust の Source / Flow / Sink / BidiFlow / RunnableGraph / GraphDSL 相当の契約で比較する。

対象に含めるもの:

stream graph, shape, port, materialization, interpreter, fusing
Source / Flow / Sink / BidiFlow / RunnableGraph の主要 operator semantics
graph stage, handler, async callback, timer stage
attributes, supervision, restart, kill switch, queue, hub, throttle, completion strategy
actor interop, stream ref, typed stream interop
framing / compression / IO adapter のうち Rust std adapter として再現可能なもの

対象外にするもの:

Java DSL wrapper と Java interop 専用 API
Scala implicit / package ops / syntax sugar
stream-testkit, stream-tests, stream-tests-tck, stream-typed-tests
JVM dispatcher / materializer configurator / HOCON loading 固有 API
Reactive Streams TCK や test probe API。ユーザーが testkit 調査を明示した場合だけ別スコープにする

remote の対象範囲

remote では、Pekko Artery compatible な remote actor transport 契約を対象にする。

対象に含めるもの:

remote address, actor ref serialization, envelope, manifest, wire protocol
association, handshake, quarantine, disassociation, reconnect / backoff
failure detector, remote watcher, remote DeathWatch integration
transport abstraction と std TCP transport adapter
provider / extension installer / remote actor ref provider 相当の契約

対象外にするもの:

deprecated classic remoting
Netty / Aeron / TLS など特定実装技術の完全互換
Java serialization / Jackson module そのもの。serialization contract との接続点だけを対象にする
remote testkit / multi-node-testkit / remote-tests
HOCON provider loading や JVM classloader 固有 API

cluster の対象範囲

cluster では、cluster membership と virtual actor / sharding 相当の分散配置契約を対象にする。

対象に含めるもの:

cluster extension, cluster state, member / node status, gossip, vector clock
failure detector, downing provider, cluster provider
cluster router pool / group semantics
receptionist / discovery 連携のうち cluster membership に依存するもの
distributed pubsub / topic / broker semantics
sharding / grain / virtual actor / placement / identity lookup に相当する契約
std adapter の gossip transport, provider adapter, AWS ECS discovery adapter

対象外にするもの:

cluster-metrics。ユーザーが metrics 調査を明示した場合だけ別スコープにする
Kubernetes / discovery backend 固有実装の完全互換
multi-node-testkit, cluster tests, typed tests
Java / Scala DSL convenience API
JVM management / JMX / HOCON loading 固有 API

persistence の対象範囲

persistence では、write-side persistence runtime を対象にする。persistence-query はデフォルトでは別スコープにする。

対象に含めるもの:

persistent actor, event sourced behavior, recovery, journal, snapshot
persistent representation, envelope, sequence number, metadata
event adapter, read / write adapter, tagging
durable state store registry と durable state error contract
at-least-once delivery, unconfirmed delivery, persistent FSM
plugin proxy / extension / in-memory journal / in-memory snapshot store

対象外にするもの:

persistence-query。ユーザーが query 調査を明示した場合だけ別スコープにする
persistence-testkit, persistence-tck, persistence-typed-tests
JDBC / Cassandra など特定 storage plugin の完全互換
Java DSL wrapper / Scala syntax sugar
HOCON plugin loading / JVM reflection 固有 API

utils の対象範囲

utils は Pekko の汎用 util 全体互換ではなく、fraktor runtime の no_std / std 境界を支える portable utility を対象にする。

対象に含めるもの:

shared ownership / lock / once / rwlock / debug lock adapter
queue / wait / collection primitives
timer wheel / delay / scheduler capacity profile
URI / address parsing に必要な net utility
actor / stream / remote / cluster の実装で直接使われる ByteString, Timeout, StablePriorityQueue 等の runtime utility semantics

対象外にするもの:

JVM reflection, classloader, Java version, flight recorder loader
Scala collection compatibility / ccompat
Pekko 内部最適化用 util の完全互換
Java API helper / boxed type / manifest helper など JVM 型システム依存 API

固定スコープ共通ルール

固定スコープがあるモジュールでは、次を必ず守る。

レポート冒頭に「比較スコープ定義」を出し、対象に含める参照ディレクトリと除外ディレクトリを明記する。
*-tests, *-testkit, *-tck, docs, bench-jmh は、ユーザーが明示した場合だけ分母に含める。
Java / Scala / JVM 固有 API は n/a に分類し、parity 分母には入れない。
raw 抽出数を出す場合は参考値として分離し、カバレッジ計算や「ギャップ大」の根拠にしない。
typed 参照ディレクトリは、fraktor 側に対応する typed API または同等セマンティクスがある場合に対象へ入れる。単なる Java / Scala DSL 差分は対象外にする。
std adapter は core の port を実装する詳細として扱い、JVM 実装技術そのものの互換性を要求しない。

既存レポートの扱い

docs/gap-analysis/{name}-gap-analysis.md が既にある場合は必ず先に読む。前回の比較スコープ、対象外判定、未解決ギャップを把握し、現行ツリーと一致しているか再検証 すること。既存レポートの数値や判定を、確認なしにそのまま再利用してはならない。

ワークフロー

※必要に応じて、sub-agents, multi-agentsを使って効率的に調査してもよい。

1. 対象ディレクトリの特定と層構造の把握

まず docs/gap-analysis/{name}-gap-analysis.md があれば読み、前回定義された固定スコープと現状との差分を把握する。次に、引数 {name} を論理モジュール名として下表の実パスへ解決する。modules/{name}/src/ のような汎用パスを前提にしてはならない。

引数	core 相当 root	std root	typed root candidate	補足
`actor`	`modules/actor-core/src/core/kernel/`	`modules/actor-adaptor-std/src/std/`	`modules/actor-core/src/core/typed/`	actor は kernel / typed 分離が前提
`stream`	`modules/stream-core/src/core/`	`modules/stream-adaptor-std/src/std/`	なし	typed interop は core/dsl 内に現れる
`remote`	`modules/remote-core/src/domain/`	`modules/remote-adaptor-std/src/std/`	なし	`domain/` を core 相当として扱う
`cluster`	`modules/cluster-core/src/core/`	`modules/cluster-adaptor-std/src/std/`	なし	現状 `core/typed/` は存在しない
`persistence`	`modules/persistence-core/src/core/`	なし	なし	現状 `*-adaptor-std` / `core/typed` は存在しない
`utils`	`modules/utils-core/src/core/`	`modules/utils-adaptor-std/src/std/`	なし	runtime に必要な util だけを対象にする

解決した実パスが存在することを確認する。存在しない場合はユーザーに報告して終了する。ただし actor の modules/actor/src/ のような存在しない汎用パスはエラー扱いにしない。固定スコープの実パスが存在すれば調査を続行する。

存在確認と層把握（必須）:

ls modules
ls references/pekko
cat modules/<crate>/src/lib.rs
ls modules/<crate>/src
ls references/pekko/<pekko-module>/src

追加確認:

actor は core/kernel/ と core/typed/ の両方を確認する
remote は src/domain/ が公開境界なので、src/core/ を探しに行かない
persistence は std adaptor がなくても正常。未存在をギャップとして数えない
Pekko 側は通常 src/main/scala/ が本体で、src/test/ / src/multi-jvm/ は既定で除外する

2. Pekko側のAPI抽出

Pekko 側は src/main/scala/ を主対象にし、Scala / Java ソースから公開 API 候補を抽出する。javadsl、japi、src/test/、src/multi-jvm/、testkit 系は既定スコープに混ぜない。

Scala 側の棚卸しは rg を優先する。Rust 側との意味対応を確認するときだけ Serena を併用してよいが、Scala 抽出の主手段にはしない。

# Scala の公開型・トレイト・オブジェクトを列挙
rg '^\s*(?:final |sealed |abstract |private |protected )*(?:case )?(?:class|trait|object|enum)\s+' <pekko-main-roots...>

# 主要な公開メソッドを列挙
rg '^\s+(?:final |override |protected |private )*def\s+\S+' <pekko-main-roots...>

抽出後、private / private[...] 修飾付きのもの、Java DSL、Scala 構文糖、JVM 固有 API はフィルタで除外する。

固定スコープがある場合は、抽出直後に対象外 API を分類して parity 分母から除外する。raw 抽出結果は必要に応じて参考値として残すが、カバレッジ計算には使わない。

抽出結果を以下のカテゴリに分類する：

カテゴリ	例（streams の場合）
型・トレイト	Source, Flow, Sink, Graph, Shape
オペレーター	map, filter, flatMap, merge, zip
マテリアライゼーション	Keep, viaMat, toMat
グラフDSL	GraphDSL.Builder, fan-in/fan-out
ライフサイクル	KillSwitch, watchTermination
エラー処理	recover, recoverWith, supervision
その他	ユーティリティ、設定、テストキット

3. fraktor-rs側のAPI抽出（層別）

fraktor-rs 実装から 層ごとに 公開 API を抽出する。raw declaration の棚卸しと、到達可能な公開面の確認を分けること。pub が見えたからといって、そのまま parity 対象とみなしてはならない。src/lib.rs、親 mod.rs、re-export を見て、外部から到達できる公開契約かを確認する。

Rust 側の symbol 確認は Serena の find_symbol / get_symbols_overview が使えるなら優先し、網羅的な抽出・placeholder 検出は rg で補う。

# raw public type declarations
rg '^\s*pub(?:\([^)]*\))?\s+(?:struct|trait|enum|type)\s+' <fraktor-core-root> <fraktor-std-root>

# raw public method declarations
rg '^\s*pub(?:\([^)]*\))?\s+(?:async\s+)?(?:const\s+)?(?:unsafe\s+)?fn\s+\w+' <fraktor-core-root> <fraktor-std-root>

# placeholder / TODO / stub の検出
rg 'todo!\(|unimplemented!\(|panic!\("not implemented"|TODO|FIXME|placeholder|stub' <fraktor-core-root> <fraktor-std-root>

typed サブ層が存在する場合だけ別集計する。現行ツリーでは actor だけが modules/actor-core/src/core/typed/ を持つ。remote は domain/ を core 層として扱う。

同じカテゴリ体系で分類し、各APIに 所属層 を付記する。

4. ギャップの特定（層を考慮）

Pekkoに存在してfraktor-rsに存在しない機能を特定する。

判定基準（名前だけでなくシグネチャ・セマンティクスを総合的に確認する）：

実装済み: 同名または同等のシグネチャを持つメソッド/型が存在し、同じ契約を満たす
別名で実装済み: 名前は異なるが同じ機能を提供 → 対応シンボルを明記して根拠を示す
部分実装: シグネチャは存在するが本体が todo!() / unimplemented!() → スタブ
未実装: 対応する機能が存在しない → ギャップ

層の判定（必須）: 各ギャップについて、実装すべき層を判定する：

判定基準	実装先
コアロジック・trait定義・no_stdで実現可能	core
tokio/std依存・ネットワーク・ファイルIO	std
型パラメータ化されたラッパーAPI	core/typed
untyped kernel の拡張	core/{domain}

5. APIギャップが少ないかの判定

以下のいずれかを満たす場合、APIレベルの主要ギャップは概ね埋まっている とみなし、内部モジュール構造ギャップ分析に進む：

型単位カバレッジが 80% 以上
hard / medium の未実装ギャップが 5件以下
主要カテゴリ（型・主要オペレーター・ライフサイクル）ごとに、致命的な欠落が 0 件、かつカテゴリごとの未実装ギャップが 1 件以下

上記を満たさない場合は、内部モジュール構造分析は省略してよい。その場合は「APIギャップが支配的であり、構造比較は後続フェーズ」と明記すること。

6. 内部モジュール構造ギャップ分析

APIギャップが少ない場合のみ実施する。目的は、公開APIでは見えないが、今後の実装速度・保守性・責務境界に影響する差分 を洗い出すこと。

6.1 対象

fraktor-rs 側: 解決済みの core 相当 root、std root、必要に応じて typed root
Pekko 側: 解決済みの src/main/scala/ roots と、その配下の internal package / impl / stage / protocol など

6.2 抽出観点

以下の観点で、Pekko側の内部モジュール構造を抽出する：

観点	確認内容
責務分割	interpreter / stage / logic / materializer / dispatcher などの分離有無
層配置	公開API層と内部実装層がどう分かれているか
依存方向	上位DSL → 下位実行基盤への片方向依存になっているか
共有内部部品	複数APIで再利用される内部抽象が存在するか
実装の集約点	機能追加時に中心となる内部モジュールがどこか
テスト支援構造	testkit / utilities / adapters が本体からどう分離されているか

6.3 調査手順

# Pekko 側の内部ディレクトリと Scala ファイルを把握
find <pekko-main-root> -type f \( -name "*.scala" -o -name "*.java" \)
rg '^package ' <pekko-main-roots...>

# fraktor-rs 側の内部ディレクトリを把握
find <fraktor-core-root> -type f -name "*.rs"
find <fraktor-std-root> -type f -name "*.rs"   # 存在する場合
rg '^\s*(pub\(crate\)|mod) ' <fraktor-core-root> <fraktor-std-root>

必要に応じて Serena でシンボル単位の責務境界を確認する。

6.4 比較方法

以下の単位で比較する：

モジュール境界: Pekkoの内部責務に対して、fraktor-rsに対応するサブモジュールがあるか
責務の置き場所: ある責務が core にあるべきか std にあるべきかが妥当か
typed/untyped の分離: fraktor-rsの core/typed が薄いラッパーに留まっているか
実装集約の不足/過剰: 1責務が分散しすぎていないか、逆に1モジュールへ詰め込みすぎていないか
将来の拡張経路: 新規APIを追加する際の受け皿になる内部モジュールが存在するか

6.5 構造ギャップの判定

以下のいずれかに該当する場合は、構造ギャップとして記録する：

Pekkoでは独立責務として分離されているが、fraktor-rsでは未分離で責務が混在している
fraktor-rsに対応モジュールはあるが、core / std / core/typed の置き場所が不自然
typed 層が薄いラッパーを超えて重いロジックを抱えている
同じ責務が複数サブモジュールへ分散し、変更点が集約されていない
実装追加時の拡張ポイントが見えず、都度散発的に追加される構造になっている

逆に、以下は構造ギャップにしない：

Rust/no_std 制約により Pekko と同じパッケージ分割が成立しない
公開API差分を吸収するための一時的な内部差分で、責務境界が明確
Less is more / YAGNI の観点で、未使用の細分化を意図的に持たない

6.6 構造ギャップの出力粒度

構造ギャップごとに次を明記する：

項目	内容
ギャップ名	例: `materialization責務の集約点不足`
Pekko側の根拠	対応する package / class / trait / object
fraktor-rs側の現状	対応モジュール、または未配置
問題の種類	未分離 / 誤配置 / 責務分散 / 過剰分割
推奨アクション	新規サブモジュール追加 / 既存モジュールへ集約 / core↔stdの再配置
緊急度	low / medium / high

7. 難易度の分類

各ギャップに対して実装難易度を付与する：

難易度	基準
trivial	既存APIの組み合わせ・委譲のみで実装可能。新規公開型の追加なし
easy	新規公開型1-2個の追加で実装可能。既存traitの拡張不要
medium	新規公開型3個以上、または既存traitの拡張が必要
hard	アーキテクチャ変更・基盤レイヤーの修正を伴う
n/a	Rust/no_stdの制約上実装不要、JVM固有、またはdeprecated

構造ギャップにも同じ難易度を適用してよいが、難易度の意味は以下で補正する：

trivial: 既存モジュールへの責務移動や再配置だけで済む
easy: 新規サブモジュール1-2個の追加で済む
medium: 複数モジュールにまたがる責務再編が必要
hard: core/std 境界や typed/untyped 方針の見直しが必要

8. 結果の出力

以下のフォーマットで結果を出力する：

# {name} モジュール ギャップ分析

更新日: YYYY-MM-DD

## 比較スコープ定義

この分析で parity 対象に含める範囲と、`n/a` として除外する範囲を先に明記する。
固定スコープがある場合は、そのスコープ表に従って Java / Scala / JVM 固有 API、testkit / TCK / tests、実装技術固有 API を分母から除外したことを明記する。

## サマリー

| 指標 | 値 |
|------|-----|
| Pekko 固定スコープ対象概念（または parity 対象 API 数） | N |
| fraktor-rs 固定スコープ対応概念 | M |
| 固定スコープ概念カバレッジ | M/N (XX%) |
| raw public type declarations | R（core/domain: X, std: Y） |
| raw public method declarations | S（core/domain: X, std: Y） |
| hard / medium / easy / trivial gap | H / M / E / T |

raw declaration count は参考値であり、parity 分母に使わない。

## 層別カバレッジ

| 層 | Pekko 対応範囲 | fraktor-rs 現状 | 評価 |
|----|----------------|-----------------|------|
| core / kernel / domain | ... | ... | ... |
| typed surface（存在する場合） | ... | ... | ... |
| std / adaptor | ... | ... | ... |

## カテゴリ別ギャップ

各カテゴリのヘッダーには **実装済み数 / Pekko総数 (カバレッジ%)** を明記する。
これによりサマリーのカバレッジ数値の根拠をカテゴリ単位で検証できる。

ギャップ（未対応・部分実装・n/a）のみテーブルに列挙する。
実装済みはカテゴリの件数カウントに含めるが、テーブル行には追加しない。

### カテゴリ名　✅ 実装済み X/Y (ZZ%)

| Pekko API | Pekko参照 | fraktor対応 | 実装先層 | 難易度 | 備考 |
|-----------|-----------|-------------|----------|--------|------|
| `methodName` | `Flow.scala:L123` | 未対応 | core/typed | easy | 説明 |
| `ClassName` | `Graph.scala:L45` | 部分実装 | core/kernel | trivial | `foo.rs:L12` にスタブあり |
| `RuntimeX` | `Runtime.scala:L78` | 未対応 | std | medium | tokio依存 |

### ...（カテゴリごとに繰り返し）

## 内部モジュール構造ギャップ

APIギャップが少ないと判定した場合のみ、このセクションを追加する。
該当しない場合は「今回はAPIギャップが支配的なため省略」と明記する。

| 構造ギャップ | Pekko側の根拠 | fraktor-rs側の現状 | 推奨アクション | 難易度 | 緊急度 | 備考 |
|-------------|---------------|--------------------|----------------|--------|--------|------|
| `責務名` | `impl/package/path` | `modules/...` | `coreへ集約` | medium | high | 説明 |

## 実装優先度

この節のルール:
- ここで出す優先度は「今の要求で実装すべきか」ではなく、「Pekko parity ギャップをどの順で埋めるか」を示す
- この節では **YAGNI を適用しない**。未要求でも parity ギャップなら優先順位付けの対象に含める
- 新しいフェーズ名、追加軸、思いつきの派生提案を増やしてはならない
- 優先度へ載せる項目は、必ず直前の「カテゴリ別ギャップ」に列挙済みの項目だけに限定する
- したがって、この節は「新しい提案」ではなく「既存ギャップの再配置」でなければならない

分類ルール:
- Phase 1: trivial / easy。既存設計の範囲で API surface や placeholder を埋められるもの
- Phase 2: medium。追加ロジックは要るが、既存の core / std 境界の中で閉じるもの
- Phase 3: hard。低レベル stage authoring、新規 transport、remote 連携など、新しい基盤やアーキテクチャ変更を要するもの
- 対象外（n/a）: JVM 固有、Java 相互運用専用、deprecated など parity 対象外のもの

出力制約:
- 各 Phase には、カテゴリ別ギャップから再掲した項目のみを書く
- 各項目には実装先層（core, core/typed, std）を必ず付記する
- 「別案」「将来的には」「追加で考えられる」など、ギャップ表にない派生提案を書いてはならない
- ギャップ数が少なくても Phase を増やさず、既存の Phase 1-3 のどれかへ入れる

## まとめ

必ず最後にまとめセクションを出力すること。以下の内容を含める：

- 全体カバレッジの一言評価（「主要機能はカバー済み」「基盤部分が手薄」等）
- parity を低コストで前進できる未実装機能（Phase 1〜2 の代表例）
- parity 上の主要ギャップ（Phase 3 の代表例）
- APIギャップが少ない場合は、次のボトルネックが内部構造にあるかどうかの一言評価

注意事項

ほとんどのロジックはcoreに集中している前提
std は core/domain のポートを実装するアダプタモジュール
YAGNIをここでは使うな！完了のための計画になっているか確認し、漏れがある場合は是正すること
出力したファイルを cat docs/gap-analysis/${name}-gap-analysis.md で開き、レポートの存在と内容の両方を確認すること
n/a 判定は保守的に行う（JVM固有、Akka互換層、deprecated機能のみ）
Rust/no_std 固有の制約（cfg_std_forbid lint等）を考慮する

pekko-gap-analysis

이 저장소의 다른 Skills

이 저장소의 다른 Skills

Pekko ギャップ分析

引数

fraktor-rs の現行層構造

Pekko との層マッピング

actor モジュールの固定スコープ

actor parity 対象に含めるもの

actor parity 対象外にするもの

actor 調査で必ず確認する項目

その他モジュールの固定スコープ

stream の対象範囲

remote の対象範囲

cluster の対象範囲

persistence の対象範囲

utils の対象範囲

固定スコープ共通ルール

既存レポートの扱い

ワークフロー

1. 対象ディレクトリの特定と層構造の把握

2. Pekko側のAPI抽出

3. fraktor-rs側のAPI抽出（層別）

4. ギャップの特定（層を考慮）

5. APIギャップが少ないかの判定

6. 内部モジュール構造ギャップ分析

6.1 対象

6.2 抽出観点

6.3 調査手順

6.4 比較方法

6.5 構造ギャップの判定

6.6 構造ギャップの出力粒度

7. 難易度の分類

8. 結果の出力

注意事項

関連スキル

Pekko ギャップ分析

引数

fraktor-rs の現行層構造

Pekko との層マッピング

actor モジュールの固定スコープ

actor parity 対象に含めるもの

actor parity 対象外にするもの

actor 調査で必ず確認する項目

その他モジュールの固定スコープ

stream の対象範囲

remote の対象範囲

cluster の対象範囲

persistence の対象範囲

utils の対象範囲

固定スコープ共通ルール

既存レポートの扱い

ワークフロー

1. 対象ディレクトリの特定と層構造の把握

2. Pekko側のAPI抽出

3. fraktor-rs側のAPI抽出（層別）

4. ギャップの特定（層を考慮）

5. APIギャップが少ないかの判定

6. 内部モジュール構造ギャップ分析

6.1 対象

6.2 抽出観点

6.3 調査手順

6.4 比較方法

6.5 構造ギャップの判定

6.6 構造ギャップの出力粒度

7. 難易度の分類

8. 結果の出力

注意事項

関連スキル