Skip to content

docs(shots): link uploaded shots in the pull request description - #98

Merged
ark-archastro merged 1 commit into
mainfrom
docs/shots-pr-description-link
Nov 10, 2026
Merged

ark-archastro merged 1 commit into
mainfrom
docs/shots-pr-description-link

Conversation

@ark-archastro

@ark-archastro ark-archastro commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

Review on ArchCode

Draft until firstlanding PR 22847 is deployed. The new section says the PR page does not match uploads by branch name, which is true only after that change ships.

Problem and author intent

The ArchCode pull request page used to list every Shots upload stamped with the PR's head branch name. Reused branch names made unrelated shots appear on later PRs. firstlanding PR 22847 replaces that match: the page shows only the runs that the PR description links.

After that change, an agent that uploads shots and never links them gets no gallery on its PR. Nothing in the shots skill tells it to add the link.

What changed

shots/SKILL.md section 6 gains "Link the shots in the pull request description":

  • put the upload's review URL (https://archdev.ai/shots/<owner>/<repo>/<feature>) in the PR description;
  • build that URL from the origin repository and feature name after an automatic upload, whose output the agent does not see;
  • a feature link shows every run of the feature, and a shot permalink pins one run;
  • the link must be on archdev.ai and name the head repository (the fork, for a fork PR).

The eight plugins/*/skills/shots/SKILL.md copies are regenerated with npm run build in tools/plugin-gen.

Scope

Documentation only. No CLI or catalog version change.

Risk

Low. Guidance text; linking the Shots URL is harmless before the web change ships.

User impact

Agents that follow the skill add a Shots link to PR descriptions, so their uploads appear on the PR page.

Testing

No end-to-end test applies: this is skill prose with no executable behavior. In tools/plugin-gen: npm run check (220 generated files match the catalog) and npm test (139 passed, 1 skipped, 0 failed).

Follow-ups

  • Mark ready once firstlanding PR 22847 is in production.

🤖 Generated with Claude Code

The ArchCode pull request page selects shots from Shots links in the PR
description instead of matching uploads by branch name
(ArchAstro/firstlanding#22847). Tell agents to put the upload's review URL
in the description, and how to pin one run.

Co-Authored-By: Claude <noreply@anthropic.com>
@ark-archastro
ark-archastro marked this pull request as ready for review November 10, 2026 21:54
@chatgpt-codex-connector

Copy link
Copy Markdown
Codex Review Summary: ❌ Failed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ❌ Failed 2026-11-10T21:54:05.147054Z
We couldn’t complete this review. Comment @codex review to try again.
1abcb81 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, add credits to your account and enable them for code reviews in your settings.

@ark-archastro
ark-archastro merged commit 355fe6f into main Nov 10, 2026
20 checks passed
@ark-archastro
ark-archastro deleted the docs/shots-pr-description-link branch November 10, 2026 21:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant