Repository navigation
Fix the stale pointers in the agent context files #763
Description
The runtime context file cites a GitHub App manifest, a PR skill and a source folder that do not exist; the harness README points at the pre-ADR-0016 .design folder; CLAUDE.md says the backlog-tools plugin has two skills when it ships four and leaves the gate's scope for plugins/, tools/, build/ and .github/ unstated. A flow reading these follows a dead pointer. Found in the 2026-09-27 repository review.
Context
.claude/orch-context.mdline 150 to 151: "as stated in.github/github-app.yml" (file absent) and "pull requests are created through thepr-jsdotnetskill" (no such skill in the repo or installed;delivery:push-branchanddelivery:pr-merge-readyare what exist). Line 212:src/Shared/(the folder issrc/Core/). Line 209 lists.github/and.claude/as documentation-only, which conflicts with thedelivery:flow-codeconfig-kind routing.src/Harness/README.mdlines 51 to 53 say the rules "live in.design" and the csproj embeds "the.designfiles"; the folder is.devbook/design/since ADR 0016. The table also omitssrc/Harness/Backlog.AzureFoundry.TestService, and the opening "these are Blazor Server hosts" no longer covers it.CLAUDE.md: "Neither of its skills" and the Further guidance list namebacklog-import-planandbacklog-run-plan-item;plugins/backlog-tools/skills/also holdsbacklog-import-inbox(user-invoked) andbacklog-answer-notes(model-invoked), so the gate paragraph does not say whetherbacklog-answer-notesroutes through a flow. The gate text coverssrc/andtests/only;plugins/,tools/,build/,.github/,.claude/are in neither the code gate nor the devbook gate while the flow-code description claims them.- Five vendored Aspire skills under
.agents/skills/aspire*/SKILL.md(928 lines) have no wrapper and no reference from any rule orCLAUDE.md;.claude/design/multi-account-settings.mdis an orphan design doc ("ready to implement", unreferenced).
- Correct the three pointers in
orch-context.md; align line 209 with the config-kind routing. - Fix the harness README path and add the TestService row.
- List all four backlog-tools skills in
CLAUDE.mdwith each one's relationship to the gate, and add one sentence stating which flowplugins/,tools/,build/,.github/and.claude/route through. - Either wrap and document the Aspire skills or delete them; move the orphan design doc into
.devbook/arc42/as a proposal viadelivery:flow-specor delete it.
Route through delivery:flow-code, config kind, per CLAUDE.md.
Activity
JSdotNet commentedon Sep 30, 2026
The issue sweep opened draft pull request #906 for items 2 and 3. Item 1 was already obsolete, because
.claude/orch-context.mdwas deleted in 3921e82. Item 4 is left for a person: keep or delete the vendored Aspire skills and.claude/design/multi-account-settings.md. The PR does not close this issue for that reason.JSdotNet commentedon Oct 5, 2026
The issue sweep (2026-10-05) stopped this issue at Scope Discovery and routed it to
flow-spec. It opened no branch or pull request.Items 1 to 3 are already on
main(commit 0db704f, guarded byAgentContextPointerTests). Only item 4 remains:flow-codework. The five vendored skills under.agents/skills/aspire*have no.claudewrapper. Only.claude/skills/run-backlog/SKILL.mdline 28 points at one of them (aspire/). Each should be wrapped and referenced fromcontext-loading.mdorCLAUDE.md, or deleted. A test inAgentContextPointerTestscan enforce it..claude/design/multi-account-settings.md("ready to implement") is referenced by nothing. Underdevbook-arc42.mdit can only become astatus: proposeddecision record, or be deleted. Branchesclaude/adr-sync-github-accounts(open PR docs(adr): sync GitHub accounts and the repository registry (local ADR 0020) #968) andclaude/sync-github-accountsmay already cover it.Once 4b is decided, 4a can go through
flow-codeon its own.JSdotNet commentedon Oct 15, 2026
The issue sweep (2026-10-15) opened draft pull request #1298 for item 4. Told to decide without waiting, it deletes the five vendored Aspire skills (rather than wrapping them) and records the built multi-account design as proposed local ADR 0031 (rather than deleting it outright); the pull request names both alternatives.
JSdotNet commentedon Oct 17, 2026
Closed by the issue sweep as already fixed: PR #1298 (merge 1d1b8a9, on main) drops the vendored skills and fixes the harness README pointers; .claude/orch-context.md is gone (commit 3921e82).