@@ -211,44 +211,8 @@ conventions:
211211https://github.github.com/gh-aw/<category>/<page-slug>/
212212```
213213
214- Use the table below as your authoritative map of source reference files to
215- rendered doc URLs. When the agent discovers additional pages while fetching
216- docs, add them to its working knowledge.
217-
218- | Source file in github/gh-aw | Rendered URL |
219- | ---| ---|
220- | ` .github/aw/github-agentic-workflows.md ` | ` https://github.github.com/gh-aw/introduction/overview/ ` |
221- | ` .github/aw/syntax-core.md ` | ` https://github.github.com/gh-aw/reference/syntax/ ` |
222- | ` .github/aw/syntax-agentic.md ` | ` https://github.github.com/gh-aw/reference/agentic/ ` |
223- | ` .github/aw/syntax-tools-imports.md ` | ` https://github.github.com/gh-aw/reference/tools/ ` |
224- | ` .github/aw/triggers.md ` | ` https://github.github.com/gh-aw/reference/triggers/ ` |
225- | ` .github/aw/memory.md ` | ` https://github.github.com/gh-aw/reference/memory/ ` |
226- | ` .github/aw/safe-outputs.md ` | ` https://github.github.com/gh-aw/reference/safe-outputs/ ` |
227- | ` .github/aw/safe-outputs-content.md ` | ` https://github.github.com/gh-aw/reference/safe-outputs-content/ ` |
228- | ` .github/aw/safe-outputs-automation.md ` | ` https://github.github.com/gh-aw/reference/safe-outputs-automation/ ` |
229- | ` .github/aw/safe-outputs-management.md ` | ` https://github.github.com/gh-aw/reference/safe-outputs-management/ ` |
230- | ` .github/aw/safe-outputs-runtime.md ` | ` https://github.github.com/gh-aw/reference/safe-outputs-runtime/ ` |
231- | ` .github/aw/network.md ` | ` https://github.github.com/gh-aw/reference/network/ ` |
232- | ` .github/aw/messages.md ` | ` https://github.github.com/gh-aw/reference/messages/ ` |
233- | ` .github/aw/subagents.md ` | ` https://github.github.com/gh-aw/reference/subagents/ ` |
234- | ` .github/aw/loop.md ` | ` https://github.github.com/gh-aw/reference/loop/ ` |
235- | ` .github/aw/patterns.md ` | ` https://github.github.com/gh-aw/guides/patterns/ ` |
236- | ` .github/aw/workflow-patterns.md ` | ` https://github.github.com/gh-aw/guides/workflow-patterns/ ` |
237- | ` .github/aw/token-optimization.md ` | ` https://github.github.com/gh-aw/guides/token-optimization/ ` |
238- | ` .github/aw/context.md ` | ` https://github.github.com/gh-aw/reference/context/ ` |
239- | ` .github/aw/skills.md ` | ` https://github.github.com/gh-aw/reference/skills/ ` |
240- | ` .github/aw/reuse.md ` | ` https://github.github.com/gh-aw/guides/reuse/ ` |
241- | ` .github/aw/experiments.md ` | ` https://github.github.com/gh-aw/reference/experiments/ ` |
242- | ` .github/aw/github-mcp-server.md ` | ` https://github.github.com/gh-aw/reference/github-mcp-server/ ` |
243- | ` .github/aw/mcp-clis.md ` | ` https://github.github.com/gh-aw/reference/mcp-clis/ ` |
244- | ` .github/aw/agentic-workflows-mcp.md ` | ` https://github.github.com/gh-aw/reference/agentic-workflows-mcp/ ` |
245- | ` .github/aw/cli-commands.md ` | ` https://github.github.com/gh-aw/reference/cli-commands/ ` |
246- | ` .github/aw/pr-reviewer.md ` | ` https://github.github.com/gh-aw/guides/pr-reviewer/ ` |
247- | ` .github/aw/report.md ` | ` https://github.github.com/gh-aw/guides/report/ ` |
248- | ` .github/aw/llms.md ` | ` https://github.github.com/gh-aw/reference/llms/ ` |
249- | ` .github/aw/workflow-constraints.md ` | ` https://github.github.com/gh-aw/reference/workflow-constraints/ ` |
250- | ` .github/aw/workflow-editing.md ` | ` https://github.github.com/gh-aw/guides/workflow-editing/ ` |
251- | ` github.blog/tag/github-for-beginners/ ` | ` https://github.blog/tag/github-for-beginners/ ` |
214+ Use the prebuilt doc index at ` /tmp/gh-aw/data/doc-index.json ` as the
215+ authoritative source of rendered doc page URLs and section anchors.
252216
253217---
254218
@@ -308,7 +272,7 @@ docs, add them to its working knowledge.
308272## Identify Concepts and Tasks
309273
310274For each file in ` target_files ` , scan the file for every ** concept** , ** task** ,
311- ** term** , or ** feature** that has a matching reference page in the docs-site table
275+ ** term** , or ** feature** that has a matching reference page in the doc index
312276above. Consider:
313277
314278- Frontmatter fields mentioned (` on: ` , ` permissions: ` , ` tools: ` , ` safe-outputs: ` ,
@@ -322,7 +286,7 @@ above. Consider:
322286For each matched concept, resolve the most precise URL using the doc index loaded
323287in the previous step:
324288
325- 1 . Look up the page URL for the concept in the docs-site table .
289+ 1 . Look up the page URL for the concept in the doc index .
3262902 . If the doc index has anchors for that page, find the anchor whose ` text ` most
327291 closely matches the concept term (case-insensitive, partial match allowed).
3282923 . If a matching anchor is found, use its ` url ` field (which includes ` #anchor-id ` )
@@ -349,7 +313,7 @@ Build a mapping:
349313]
350314```
351315
352- Only include entries where a matching URL exists in the table .
316+ Only include entries where a matching URL exists in the doc index .
353317
354318---
355319
0 commit comments