wayfinder

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Wayfinder — tìm đường, không lao vào đích

Wayfinder — 寻找路径，而非直奔目标

Một ý tưởng lớn vừa tới — quá lớn cho một phiên agent, và bọc trong sương: đường từ đây tới đích chưa hiện. Wayfinding là tìm cái đường đó, không phải lao thẳng vào đích. Skill này vẽ đường thành một bản đồ trên ledger issue, rồi làm các ticket quyết định của nó — mỗi ticket là một câu hỏi mà lời giải là một quyết định, không phải một lát cắt build — từng cái một, cho tới khi đường tới đích rõ và không còn gì để quyết.

Đây là bậc trước

/propose

: propose giả định đã biết hình dạng công việc; wayfinder dành cho lúc chưa biết.

一个新的大型想法刚刚出现——它对于单个 agent 会话而言过于庞大，而且笼罩在迷雾中：从当前状态通往目标的路径尚未显现。Wayfinding 的意义是找到那条路径，而不是直接冲向目标。这个 skill 会把路径绘制成 issue ledger 上的一张地图，然后逐一处理其中的决策型 ticket——每个 ticket 都是一个其解答构成决策的问题，而不是一小块 build——直到通往目标的路径清晰，且再也没有任何需要决策的事项。

这是位于

/propose

之前的一个阶段：propose 假定工作的形态已经清楚；wayfinder 则用于尚不清楚的阶段。

WHAT

Purpose và context

Purpose 与 context

Purpose: tìm ĐƯỜNG tới đích cho một chunk việc quá lớn và còn mù mờ — dựng bản đồ các ticket quyết định trên ledger issue rồi giải từng ticket tới khi đường rõ và không còn gì để quyết.
Trigger (when to use): gọi bằng tay khi có một ý tưởng lớn chưa rõ hình dạng, TRƯỚC cả
```
/propose
```
. Chỉ-gọi-tay (
```
disable-model-invocation: true
```
).
Non-goals: không sinh deliverable/build (đó là sau
```
/propose
```
); không giải hộ phía người trong ticket HITL; không cắt sẵn sương thành ticket; không giải việc nằm sau đích (out of scope).

Purpose： 为一个过大且仍模糊的 chunk 找到通往目标的路径——在 issue ledger 上绘制决策型 ticket 的地图，然后逐一解决，直到路径清晰且不再有任何需要决策的事项。
Trigger（何时使用）： 当一个大型想法尚未成形时，在
```
/propose
```
之前手动调用。仅限手动调用（
```
disable-model-invocation: true
```
）。
Non-goals： 不生成 deliverable/build（那是在
```
/propose
```
之后）；不代替用户回答 HITL ticket 中的问题；不提前把迷雾切割成 ticket；不处理目标之后的工作（out of scope）。

Mental model

ý tưởng loose → Destination → bản đồ (issue wayfinder:map, chỉ mục) → ticket quyết định (issue con, cạnh chặn) → frontier → giải một ticket → Decisions-so-far + dọn sương → … → đường rõ → bàn giao /propose

loose idea → Destination → 地图（issue wayfinder:map，索引）→ 决策型 ticket（子 issue，阻塞边）→ frontier → 解决一个 ticket → Decisions-so-far + 清理迷雾 → … → 路径清晰 → 移交给 /propose

。

Plan, don't do

Wayfinder mặc định là lập kế hoạch: mỗi ticket giải một quyết định, và bản đồ xong khi đường đã rõ — không còn gì phải quyết trước khi ai đó đi làm. Cái kéo bạn nhảy vào làm thường là tín hiệu đã tới mép bản đồ và tới lúc bàn giao sang

/propose

. Sinh quyết định, không sinh deliverable.

Wayfinder 默认用于制定计划：每个 ticket 解决一个决策；当路径已经清晰、任何人开始执行前已没有任何需要决策的事项时，地图便告完成。那种促使你直接开始执行的冲动，通常表明你已经到达地图边缘，应该移交给

/propose

。要生成的是决策，而不是 deliverable。

Gọi tên bằng TÊN, không bằng id

用名称而非 id 指代

Mỗi bản đồ và ticket là một issue, nên có một tên — tiêu đề của nó. Trong mọi thứ người đọc (tường thuật, Decisions-so-far), gọi bằng tên đó, không bao giờ bằng id trần. Một bức tường

#42, #43, #44

không đọc nổi; tên đọc được ngay. Id và link không biến mất — tên bọc lấy link — nhưng chúng đi bên trong tên, không thay tên.

每张地图和每个 ticket 都是 issue，因此都有一个名称——它的标题。在所有供人阅读的内容中（汇报、Decisions-so-far），都应按名称称呼，绝不只写裸 id。一面写着

#42, #43, #44

的墙根本读不懂；名称则一目了然。Id 和 link 并未消失——名称包裹着 link——但它们位于名称内部，不能取代名称。

Bốn kiểu ticket

四种 ticket

Mỗi ticket là HITL (có người sống trả lời) hoặc AFK (agent chạy một mình). Một ticket HITL chỉ giải qua trao đổi sống; agent không bao giờ đứng thay phía người — một agent grilling mà tự trả lời câu hỏi của chính mình là đã phá vỡ điều này.

research (AFK) — đọc tài liệu/API/kho tri thức để lôi ra một fact mà một quyết định đang chờ. Giải bằng một subagent
```
/research
```
(hoặc
```
/agent-reach
```
). Dùng khi cần tri thức ngoài thư mục hiện tại.
prototype (HITL) — nâng độ phân giải cuộc bàn bằng một bản thô cụ thể để phản ứng: một outline, một bản nháp, một stub, hoặc UI/logic. Dùng khi "trông thế nào" / "hành xử ra sao" là câu hỏi chính.
grilling (HITL) — hội thoại từng câu một. Trường hợp mặc định.
task (HITL hoặc AFK) — việc TAY phải xong trước khi một quyết định làm được: đăng ký một dịch vụ để xét API, cấp quyền, dời dữ liệu để thấy hình dạng. Kiểu duy nhất làm thay vì quyết — và nó đáng chỗ vì mở khoá một quyết định, không phải vì giao deliverable.

每个 ticket 要么是 HITL（由真人回答），要么是 AFK（由 agent 独自运行）。HITL ticket 只能通过实时交流来解决；agent 绝不能代替用户作答——一个不断追问、却自行回答自己问题的 agent，已经破坏了这项原则。

research（AFK）——阅读文档/API/知识库，提取某个决策正在等待的 fact。通过一个 subagent
```
/research
```
（或
```
/agent-reach
```
）来解决。当所需知识存在于当前目录之外时使用。
prototype（HITL）——用具体的初步成果提升讨论的分辨率：一个 outline、一份 draft、一个 stub，或 UI/logic。当“它看起来如何？”/“它的行为如何？”正是核心问题时使用。
grilling（HITL）——逐句展开对话。默认类型。
task（HITL 或 AFK）——在某个决策能够完成之前必须先完成的人工工作：注册服务以测试 API、授予权限、迁移数据以看清实际形态。这是唯一一种执行工作而非作出决策的类型——它之所以值得占用一个 ticket，是因为它能解锁一个决策，而不是因为它会交付 deliverable。

Fog of war

Bản đồ cố ý chưa đầy đủ: đừng vẽ cái chưa thấy. Ngoài các ticket sống là sương — cái nhìn mờ về những quyết định biết là sẽ tới nhưng chưa ghim được, vì chúng treo trên các câu hỏi còn mở. Giải một ticket dọn sương phía trước nó, cho tốt nghiệp bất cứ gì giờ đã ghim được thành ticket mới — từng cái một, tới khi đường tới đích rõ.

Sương hay ticket? Test là đặt được câu hỏi cho chính xác BÂY GIỜ chưa — không phải trả lời được chưa.

Ticket khi câu hỏi đã sắc — kể cả khi nó bị chặn và bạn chưa làm được.
Not yet specified khi bạn chưa phát biểu sắc được. Đừng cắt sẵn sương thành các mảnh cỡ-ticket: nó thô hơn một ticket, một mảng có thể tốt nghiệp thành vài ticket, hoặc không cái nào, khi frontier chạm tới.

地图有意保持不完整：不要绘制尚未看见的东西。除活跃 ticket 之外的就是迷雾——一幅模糊的景象，其中隐约可见一些已知迟早会出现的决策，但它们悬而未决于尚未回答的问题，因此还无法被固定下来。解决一个 ticket 时，要清理它前方的迷雾，让任何此时已可固定的事项逐一成为新 ticket——持续推进，直到通往目标的路径清晰。

迷雾还是 ticket？ 判断标准是现在能否提出一个准确的问题，而不是现在能否给出答案。

当问题已经明确时，用 Ticket，即使它受到阻塞、目前还无法解决。
如果还无法明确表述问题，则为 Not yet specified。不要提前把迷雾切割成 ticket 大小的碎片：它可能比一个 ticket 更粗糙，一个区域在 frontier 推进到此处时可能会衍生为多个 ticket，也可能一个都不会衍生。

Out of scope

Sương chỉ gom về phía đích. Đích cố định phạm vi, nên việc vượt nó là out of scope — không phải sương, không thuộc Not-yet-specified. Nó có mục riêng: việc bạn ý thức loại khỏi nỗ lực này. Out-of-scope không bao giờ tốt nghiệp. Một ticket đã tồn tại mà hoá ra nằm sau đích → đóng nó và để lại một dòng ở Out-of-scope, không giải nó trên đường.

迷雾只会向目标方向汇聚。目标限定了范围，因此超出目标的工作属于 out of scope——既不是迷雾，也不属于 Not-yet-specified。它有独立的章节：这是你有意识地从本次努力中排除的工作。Out-of-scope 永远不会衍生为 ticket。如果某个已经存在的 ticket 最终被发现位于目标之后 → 将其关闭，并在 Out-of-scope 中留下一行，不要在推进路径的过程中解决它。

Input và output contract

Input 和 output contract

	Field	Required?	Ý nghĩa
In	ý tưởng loose	có (chế độ Chart)	thứ cần tìm đường
In	bản đồ (issue `wayfinder:map` )	có (chế độ Work)	map đã dựng
In	ticket cụ thể	không (chế độ Work)	không có → lấy ticket frontier đầu tiên
Out	issue bản đồ + issue con + cạnh chặn	Chart	Destination, Not-yet-specified phác sương, Decisions-so-far rỗng
Out	một ticket đã claim → giải → đóng + con trỏ trong Decisions-so-far	Work	kèm ticket mới lộ ra / sương tốt nghiệp / out-of-scope cập nhật

	字段	是否必填？	含义
In	loose idea	是（Chart 模式）	需要寻找路径的对象
In	地图（issue `wayfinder:map` ）	是（Work 模式）	已建立的地图
In	具体 ticket	否（Work 模式）	未提供 → 获取第一个 frontier ticket
Out	地图 issue + 子 issue + 阻塞边	Chart	包含 Destination、勾勒迷雾的 Not-yet-specified，以及为空的 Decisions-so-far
Out	一个已 claim → 已解决 → 已关闭的 ticket + Decisions-so-far 中的子指针	Work	同时包含新出现的 ticket / 已具体化的迷雾 / 更新后的 out-of-scope

Rules và capabilities

Rules 和 capabilities

RULE-01 (MUST): Chỉ-gọi-tay (
```
disable-model-invocation: true
```
) — wayfinder là một hành động có chủ ý của user, không phải thứ model tự nhảy vào. Xem
```
[[skill-craft]]
```
.
RULE-02 (MUST): Plan, don't do — sinh quyết định, không sinh deliverable. Muốn nhảy vào làm = tới mép bản đồ = bàn giao
```
/propose
```
.
RULE-03 (MUST): Một ticket một phiên (trừ research), và claim trước khi làm (dùng
```
frontier.py
```
+ ô
```
claim
```
của ledger).
RULE-04 (MUST): Ledger là nguồn chân lý; tracker remote là mirror. Đọc
```
[[issue-tracker]]
```
cho cách diễn đạt ở repo này.
Capabilities: đọc/ghi issue trên ledger (tạo, nối cạnh chặn, claim, đóng); truy vấn frontier; hội thoại sống với user cho ticket HITL; bắn subagent research song song.

RULE-01（MUST）：仅限手动调用（
```
disable-model-invocation: true
```
）——wayfinder 是 user 有意发起的行为，而不是 model 自动介入。请参阅
```
[[skill-craft]]
```
。
RULE-02（MUST）：Plan, don't do——生成决策，不生成 deliverable。想直接开始执行 = 已到达地图边缘 = 移交给
```
/propose
```
。
RULE-03（MUST）：一个会话一个 ticket（research 除外），并且开始处理前先 claim（使用
```
frontier.py
```
和 ledger 的
```
claim
```
字段）。
RULE-04（MUST）：Ledger 是事实来源；远程 tracker 是镜像。阅读
```
[[issue-tracker]]
```
，了解该 repo 中的表达方式。
Capabilities：在 ledger 上读写 issue（创建、连接阻塞边、claim、关闭）；查询 frontier；就 HITL ticket 与 user 进行实时对话；并行派发 research subagent。

Failure boundaries

Vẽ frontier không lôi ra sương nào → đường đã rõ, không cần bản đồ: dừng, hỏi user muốn đi tiếp thế nào.
Ticket HITL không có người trả lời → blocked; agent không tự trả lời thay.
Ticket đã claim bởi phiên khác → không giải; chọn ticket frontier khác.
Lời giải lộ ra việc nằm sau đích → đóng ticket, ghi Out-of-scope (cancelled cho ticket đó).
Cái kéo muốn nhảy vào làm → tới mép bản đồ → bàn giao
```
/propose
```
.

绘制 frontier 后没有带出任何迷雾 → 路径已经清晰，不需要地图：停止，询问 user 想如何继续。
HITL ticket 没有人回答 → blocked；agent 不代替用户作答。
Ticket 已被其他会话 claim → 不予解决；改选另一个 frontier ticket。
解决过程暴露出位于目标之后的工作 → 关闭 ticket，记录到 Out-of-scope（该 ticket 状态为 cancelled）。
想要直接开始执行的冲动出现 → 到达地图边缘 → 移交给
```
/propose
```
。

HOW

Main workflow

Step	Type	Inputs	Action	Outputs/exit	Failure/next
W01	judgment	ý tưởng	(Chart) Đặt tên đích qua `/grilling` + `/domain-modeling`	một câu Destination	—
W02	judgment	Destination	(Chart) Vẽ frontier theo bề rộng	quyết định mở + bước đầu	không có sương → dừng, hỏi user
W03	effect	W01–W02	(Chart) Tạo bản đồ + ticket ghim được, nối cạnh chặn lượt hai	issue map + issue con	—
W04	effect	ticket research	(Chart) Bắn subagent research song song, rồi dừng	phát hiện gắn con trỏ	—
W05	deterministic	bản đồ	(Work) Nạp bản đồ, chọn ticket (user nêu hoặc `frontier.py --map <id>` ), claim trước	ticket đã claim	đã bị claim → chọn cái khác
W06	judgment	ticket	(Work) Giải — zoom khi cần; HITL thì hỏi người sống	lời giải	bí → `/grilling` + `/domain-modeling`
W07	effect	lời giải	(Work) Ghi resolution, đóng issue ( `status: done` ), append Decisions-so-far; tạo ticket mới / tốt nghiệp sương / loại out-of-scope	bản đồ cập nhật	—

Chi tiết từng bước (nguồn chân lý cho W01–W07):

Hai chế độ. Cả hai: không bao giờ giải quá một ticket mỗi phiên — trừ research.

Step	Type	Inputs	Action	Outputs/exit	Failure/next
W01	judgment	idea	（Chart）通过 `/grilling` + `/domain-modeling` 确定目标名称	一句 Destination	—
W02	judgment	Destination	（Chart）按广度绘制 frontier	开放的决策 + 最初可执行的步骤	没有迷雾 → 停止，询问 user
W03	effect	W01–W02	（Chart）创建地图 + 可固定的 ticket，在第二轮连接阻塞边	地图 issue + 子 issue	—
W04	effect	research ticket	（Chart）并行派发 research subagent，然后停止	附上指向发现结果的指针	—
W05	deterministic	地图	（Work）加载地图，选择 ticket（user 指定或 `frontier.py --map <id>` ），先 claim	已 claim 的 ticket	已被 claim → 选择另一个
W06	judgment	ticket	（Work）解决——必要时 zoom；如果是 HITL，则询问真人	解答	受阻 → `/grilling` + `/domain-modeling`
W07	effect	解答	（Work）写入 resolution，关闭 issue（ `status: done` ），将指针 append 到 Decisions-so-far；创建新 ticket / 让迷雾具体化 / 标记 out-of-scope	更新后的地图	—

各步骤的详细信息（W01–W07 的事实来源）：

两种模式。两者都遵循：每个会话绝不解决超过一个 ticket——research 除外。

Chart the map (dựng bản đồ)

Chart the map（绘制地图）

User gọi với một ý tưởng loose.

Đặt tên đích. Chạy
```
/grilling
```
+
```
/domain-modeling
```
(nếu có) ghim đích này tìm đường tới cái gì. Đích cố định phạm vi nên chốt trước. → Xong khi: một câu Destination mà mọi phiên sau định hướng được vào.
Vẽ frontier. Grill lại, theo bề rộng: fan ra khắp không gian thay vì sâu một luồng, lôi ra các quyết định mở và bước đầu làm được ngay. Không lôi ra sương nào → đường đã rõ, không cần bản đồ; dừng, hỏi user muốn đi tiếp thế nào.
Tạo bản đồ (nhãn
```
wayfinder:map
```
): Destination + Notes điền, Decisions-so-far rỗng, sương phác vào Not-yet-specified.
Tạo các ticket ghim được thành issue con — rồi nối cạnh chặn ở lượt hai (issue cần id trước khi trỏ nhau). → Xong khi: mọi ticket ghim-được đã có, phần chưa ghim ở lại sương.
Bắn subagent research. Mỗi ticket
```
research
```
→ một subagent giải song song, ghi phát hiện, gắn con trỏ ngữ cảnh từ ticket.
Dừng — dựng bản đồ là việc của một phiên; nó không tự-giải ticket nào.

user 使用一个 loose idea 调用。

确定目标名称。 运行
```
/grilling
```
+
```
/domain-modeling
```
（如果有），锁定此次要寻找路径的目标。目标会限定范围，因此必须先确定。→ 完成条件： 产出一句 Destination，之后每个会话都可以据此确定方向。
绘制 frontier。 再次进行 grilling，但要按广度展开：横向覆盖问题空间，而不是沿单一路径深入；找出开放的决策以及立即可执行的前期步骤。如果没有带出任何迷雾 → 路径已经清晰，不需要地图；停止并询问 user 想如何继续。
创建地图（标签
```
wayfinder:map
```
）：填写 Destination + Notes，Decisions-so-far 留空，并在 Not-yet-specified 中勾勒迷雾。
将可固定的 ticket 创建为子 issue——然后在第二轮连接阻塞边（issue 必须先有 id，才能互相指向）。→ 完成条件： 所有可固定的 ticket 均已建立，尚未固定的部分继续保留为迷雾。
派发 research subagent。 每个
```
research
```
ticket → 派一个 subagent 并行解决，记录发现结果，并从 ticket 附加上下文指针。
停止——绘制地图是一个会话的工作；它不会自行解决任何 ticket。

Work through the map (làm qua bản đồ)

Work through the map（沿地图推进）

User gọi với một bản đồ. Ticket là tuỳ chọn — không có thì bạn chọn quyết định kế, không phải user.

Nạp bản đồ (view thấp-phân-giải, không phải mọi thân ticket).
Chọn ticket. User nêu thì dùng. Không thì lấy ticket frontier đầu tiên (
```
frontier.py --map <id>
```
). Claim nó — ghi ô
```
claim
```
, trước mọi việc.
Giải — zoom khi cần: lấy thân đầy đủ của ticket liên quan trên yêu cầu; gọi các skill Notes chỉ tên. Bí thì
```
/grilling
```
+
```
/domain-modeling
```
.
Ghi lời giải: post lời giải làm resolution, đóng issue (
```
status: done
```
), append một con trỏ vào Decisions-so-far của bản đồ.
Thêm ticket mới lộ ra (tạo-rồi-nối); cho tốt nghiệp sương mà lời giải vừa ghim được, dọn khỏi Not-yet-specified. Lời giải lộ ra một ticket nằm sau đích → loại out of scope. Lời giải phủ định phần khác của bản đồ → cập nhật/xoá ticket đó.

user 使用一张地图调用。Ticket 是可选的——如果没有提供，应由你选择下一个决策，而不是让 user 选择。

加载地图（低分辨率视图，而非所有 ticket 正文）。
选择 ticket。User 指定则使用。否则获取第一个 frontier ticket（
```
frontier.py --map <id>
```
）。Claim 它——在任何操作之前写入
```
claim
```
字段。
解决——必要时 zoom：按需获取相关 ticket 的完整正文；按名称调用各 skill 的 Notes。遇到阻塞时使用
```
/grilling
```
+
```
/domain-modeling
```
。
写入解答：将解答作为 resolution 发布，关闭 issue（
```
status: done
```
），并向地图的 Decisions-so-far append 一个指针。
添加新出现的 ticket（先创建再连接）；对于刚被解答固定的迷雾，使其具体化并从 Not-yet-specified 中移除。如果解答暴露出一个位于目标之后的 ticket → 归入 out of scope。如果解答否定了地图的其他部分 → 更新/删除该 ticket。

Branches

ID	Kind	Guard	Hành vi	Skip / failure	Rejoin
B01	user_optional	user gọi với bản đồ có sẵn	chế độ Work through the map (W05–W07) thay cho Chart (W01–W04)	—	kết thúc phiên sau một ticket
B02	conditional_required	ticket kiểu research	giải bằng subagent `/research` (hoặc `/agent-reach` ), được phép song song quá một ticket	—	W07
B03	conditional_required	ticket HITL (prototype/grilling/task-HITL)	chỉ giải qua trao đổi sống với người	không có người → blocked	W07
B04	recovery	lời giải phủ định phần khác của bản đồ	cập nhật/xoá ticket đó	—	W07

ID	Kind	Guard	行为	Skip / failure	Rejoin
B01	user_optional	user 使用现有地图调用	Work through the map 模式（W05–W07）取代 Chart（W01–W04）	—	一个 ticket 后结束会话
B02	conditional_required	research 类型 ticket	使用 subagent `/research` （或 `/agent-reach` ）解决，允许并行处理多个 ticket	—	W07
B03	conditional_required	HITL ticket（prototype/grilling/task-HITL）	只能通过与真人的实时交流来解决	无人参与 → blocked	W07
B04	recovery	解答否定了地图的其他部分	更新/删除该 ticket	—	W07

Validation và stopping

Validation 和 stopping

Chart dừng sau W04 (không tự giải ticket nào). Work dừng sau đúng một ticket (trừ research). Bản đồ xong khi đường tới đích rõ và không còn gì để quyết → bàn giao

/propose

. Ticket tiếp theo do

frontier.py

+ ô

claim

quyết, không đoán.

Chart 在 W04 后停止（不会自行解决任何 ticket）。Work 在恰好解决一个 ticket 后停止（research 除外）。当通往目标的路径清晰且不再有任何需要决策的事项时，地图即告完成 → 移交给

/propose

。下一个 ticket 由

frontier.py

claim

字段决定，不要猜测。

Examples

Positive: "/wayfinder chuyển overstack sang multi-model dispatch" → grill ra Destination một dòng, frontier lộ 3 ticket (1 research về API provider, 2 grilling) → tạo map
```
wayfinder:map
```
+ 3 issue con, nối cạnh chặn lượt hai, bắn 1 subagent research → dừng.
Boundary/failure: "/wayfinder <map>" nhưng ticket frontier là grilling (HITL) và user vắng → blocked, agent không tự trả lời câu hỏi của mình; không giải ticket thứ hai trong phiên.

Positive： “/wayfinder chuyển overstack sang multi-model dispatch” → grilling 得出一行 Destination，frontier 暴露出 3 个 ticket（1 个关于 API provider 的 research，2 个 grilling）→ 创建 map
```
wayfinder:map
```
+ 3 个子 issue，在第二轮连接阻塞边，派发 1 个 research subagent → 停止。
Boundary/failure： “/wayfinder <map>”，但 frontier ticket 是 grilling（HITL），且 user 不在场 → blocked；agent 不自行回答自己的问题；同一会话中也不解决第二个 ticket。

Reference — Bản đồ

Reference — 地图

Bản đồ là một issue trên ledger (nhãn

wayfinder:map

). Ticket của nó là issue con. Bản đồ là một chỉ mục, không phải một kho: nó liệt kê các quyết định đã làm và trỏ tới ticket giữ chi tiết — một quyết định sống ở đúng một chỗ (ticket của nó), bản đồ không kể lại, chỉ gist và link. Cách bản đồ, ticket con, cạnh chặn, và frontier query sống ở đâu là tuỳ tracker — đọc

[[issue-tracker]]

§ "Wayfinding operations".

Thân bản đồ (nạp một lần mỗi phiên):

markdown

undefined

地图是 ledger 上的一个 issue（标签

wayfinder:map

）。它的 ticket 是子 issue。地图是一个索引，而不是仓库：它列出已经作出的决策，并指向保存详细信息的 ticket——一个决策只应存在于一个地方（即其所属 ticket）；地图不重复叙述，只提供 gist 和 link。地图、子 ticket、阻塞边及 frontier query 的具体实现取决于 tracker——阅读

[[issue-tracker]]

§ “Wayfinding operations”。

地图正文（每个会话加载一次）：

markdown

undefined

Destination

<đi tới cuối bản đồ này trông như thế nào — spec, quyết định, hay thay đổi mà nỗ lực này tìm đường tới. Một hai dòng; mỗi phiên định hướng vào nó trước khi chọn ticket.>

<到达这张地图尽头时应是什么样子——即本次努力正在寻找路径的 spec、决策或变更。一到两行；每个会话在选择 ticket 前都要以此确定方向。>

Decisions so far

<tên ticket đã đóng> — <gist một dòng của lời giải>

<已关闭 ticket 的名称> — <解答的一行 gist>

Not yet specified

Out of scope


Ticket là issue con, thân là câu hỏi, cỡ vừa một phiên:

```markdown


Ticket 是子 issue，正文是一个问题，规模应适合一个会话：

```markdown

Question

<quyết định hay điều tra mà ticket này giải>

undefined

<这个 ticket 要解决的决策或调查>

undefined

Origin

Chưng cất từ

mattpocock/skills

—

skills/engineering/wayfinder/SKILL.md

(clone

scratchpad/mattpocock-skills/

, 2026-07-15).

Absorb qua
```
/propose
```
→
```
150726-mattpocock-absorb
```
(T8), task
```
T-260715-01
```
. Đứng trên hạ tầng ledger T6/T7.
Commit: (verify-before-commit điền)

收录自

mattpocock/skills

——

skills/engineering/wayfinder/SKILL.md

（克隆至

scratchpad/mattpocock-skills/

，2026-07-15）。

通过
```
/propose
```
→
```
150726-mattpocock-absorb
```
（T8）吸收，task
```
T-260715-01
```
。构建于 ledger 基础设施 T6/T7 之上。
Commit： （verify-before-commit 时填写）