wayfinder について
wayfinderは、調査、決定事項、次の作業範囲をマップ化するエージェントスキルです。永続的なマップを管理し、未決事項を所定のチケット形式に振り分けます。依頼がない限り、実行には進みません。
主な機能
- 01目的と依存関係のマップ化
- 02次の阻害要因の追跡
- 03未決事項のチケット化
- 04成果物グラフのメタデータ管理
- 05通常は実行前に停止
活用シーン
- 01実装前の調査経路の整理
- 02後続作業を妨げる決定事項の追跡
- 03範囲を絞った調査・タスクチケットの作成
- 04完了した調査結果をプロジェクトマップに反映
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/wayfinderを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
Wayfinder
調査マップ、永続的なフロンティア、不確実性の振り分けを担います。デフォルトでは計画を立てます。目的地での実行や、別のチケット形式の定義は行いません。
出力または消費するすべてのチケットメタデータには、正規の
Ticket Envelope v1を使用します。シリアライズは
to-ticketsまたは共有 CLI に委任してください。
デフォルト
- マップは
docs/specs/<slug>.mdまたはdocs/specs/<slug>-wayfinder.mdに配置します。 - すべてのマップには、
## Artifact Graphセクションを1つ、安定したArtifact ID、Role: wayfinder、 およびStandalone: trueか、相互に対応するオーナーエッジを持つParentを1つだけ含めます。 - チケットは
docs/tickets/<spec-slug>/に配置します。 - 下位互換性はオプトインです。それでも、破壊的な移行、外部契約の破壊、取り消せない変更には必ず注意を促してください。
- 目的地自体が曖昧な場合に限り、簡潔な質問を1つだけします。それ以外の場合は前提を明示します。
目的地の確認
- 目的地が明確な場合：前提を明示し、すぐに計画を立てます。
- 儀礼的に
grillingを呼び出さないでください。 - 未解決の回答によって目的地、スコープ、または初期フロンティアが大きく変わる場合は、正規の grillingを呼び出します。
grillingの各ラウンドで質問し、確認を待ちます。- 確認前に永続的な成果物を作成しないでください。
保留中の決定
- 目的地が判明していて、未解決の決定がある場合：インタビューをその場で実行しないでください。
to-ticketsを使用して、execution_mode: HITLを含む正規のTicket Envelopeを出力します。その本文では、 grillingの実施と、その決定の確認を必須とします。- 決定が確認されるまで、そのチケットをフロンティアに残します。
- インタビューの状態を記録するTicket Envelopeのフィールドを追加しないでください。
プロセス
- 目的地、決定事項、不明点、対象外事項、次に進行を妨げるエッジを特定するのに必要な範囲だけ、コンテキストを再構成します。
- マップを作成または更新します。
# <Title>
## Artifact Graph
- Artifact ID: `artifact:<stable-id>`
- Role: `wayfinder`
- Standalone: true
## Type
Wayfinding spec
## Status
Active
## Destination
Reachable target outcome.
## Decisions So Far
- Decision, evidence, and durable record.
## Not Yet Specified
- Unknown that blocks reliable execution.
## Out of Scope
- Explicit exclusion.
## Frontier / Blocking Edges
- Edge, why it blocks, unblock condition, and owning ticket.
## Ticket Plan
- ID, type, mode, blockers, title, expected output.
## Next Review
- What the next agent or human inspects.
- アーキテクチャ、プロダクト、診断に関する永続的な決定を
to-specで記録し、マップからリンクします。 - 範囲を絞った
research、prototype、grilling、またはtaskチケットをto-ticketsで作成します。それぞれに質問または成果、根拠、フロンティア、作業計画、対象外事項を記載する必要があります。 - 既存のチケットを使用する前に、共有の
ticket-parseコマンドで解析し、そのモード、ブロッカー、IDを確認します。Blocked Byなどの見出しからこれらのフィールドを推測しないでください。 - ユーザーが実行を明示的に要求しない限り、マップ作成で止めます。準備ができたチケットを1つ
execute-ticketに、またはフォルダーをticket-autopilotに渡します。人間が1つのマップに対して複数のPiセッションを実行する場合は、複数セッションでの作業のルールに従ってください。
メンテナンス
- 永続化された目的地とスコープを、確認済みのコンテキストとして再利用します。
- ユーザーが明示的に変更した場合、または新たな根拠によって目的地、スコープ、初期フロンティアが大きく変わる場合を除き、
grillingをやり直さないでください。 - そのような変更がある場合は、永続的な更新を書き込む前に、目的地の確認に戻ります。
- 完了したチケットの根拠と決定事項をマップに反映します。
- 解決済みの不明点は、古い質問として残さず削除します。
- フロンティアは、次に取り組むべき重要なエッジ数件に絞ります。
- 推測するよりも、別の調査チケットを作成することを優先します。
- マップのパス、チケットフォルダー、準備完了またはブロック中のフロンティア、推奨する次のステップを報告します。
コメント
Markdown 対応