Skip to content

chore(ci): regenerate the agent skill references in the release instead of after every docs merge - #8811

Merged
leandrodamascena merged 1 commit into
developfrom
chore/agent-skill-references-in-release
Nov 14, 2026
Merged

leandrodamascena merged 1 commit into
developfrom
chore/agent-skill-references-in-release

Conversation

@leandrodamascena

Copy link
Copy Markdown
Contributor

Issue number:
closes #8806

Summary

Changes

Follow-up to #8807. The workflow that opened a PR after every docs merge was noise: one bot PR per docs change, for a file that only needs to be right when we publish.

  • agent_skill_references.yml is gone.
  • The release workflow regenerates the references right after update_layer_arn_v3.sh, in the same job, and the chore(ci): layer docs update PR now carries the references next to the layer version bump. One PR per release, which is where the drift came from in the first place.
  • Generator docstring and AGENTS.md updated to say so. Pre-commit hook and make agent-skill unchanged.
  • The idempotency reference is regenerated here too: three idempotency docs changes landed today and nothing picked them up, which is the point of this PR.

User experience

Contributors: nothing to do, same as after #8807. Maintainers: one less bot PR to merge; the references land with the release.

Verification

Workflow YAML parses; the new step reuses the Python already on the runner, the generator is stdlib only. The create-pr action adds the paths it receives with git add, so passing the references directory works like examples does today. Written with an AI assistant; I ran everything above myself.


By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

@leandrodamascena
leandrodamascena requested a review from a team as a code owner November 14, 2026 13:01
@leandrodamascena leandrodamascena added this to the 3.41.0 milestone Nov 14, 2026
@leandrodamascena leandrodamascena added the tech-debt Technical Debt tasks label Nov 14, 2026
@boring-cyborg boring-cyborg Bot added the github-actions Pull requests that update Github_actions code label Nov 14, 2026
@powertools-for-aws-oss-automation powertools-for-aws-oss-automation Bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Nov 14, 2026
@powertools-for-aws-oss-automation

Copy link
Copy Markdown

Referenced issues are closed or don't exist. Please ensure there is an open issue related to this change to avoid significant delays or closure.

@leandrodamascena
leandrodamascena merged commit 173de15 into develop Nov 14, 2026
9 of 10 checks passed
@leandrodamascena
leandrodamascena deleted the chore/agent-skill-references-in-release branch November 14, 2026 13:02
@sonarqubecloud

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

github-actions Pull requests that update Github_actions code size/M Denotes a PR that changes 30-99 lines, ignoring generated files. tech-debt Technical Debt tasks

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Maintenance: stop asking contributors to regenerate the agent skill references

1 participant