Skip to content
This repository was archived by the owner on Mar 23, 2026. It is now read-only.

docs(workflow): separate merge-to-main from tag eligibility#12

Merged
devzucca merged 1 commit intomainfrom
dev
Mar 19, 2026
Merged

docs(workflow): separate merge-to-main from tag eligibility#12
devzucca merged 1 commit intomainfrom
dev

Conversation

@devzucca
Copy link
Copy Markdown
Owner

Summary

  • clarify that merge to main and release tagging are separate decisions
  • enforce docs-only and workflow-only changes as normally non-tag-eligible
  • add explicit tag decision matrix and user intent interpretation
  • teach the delivery agent to merge docs changes to main without auto-tagging

Validation

  • customization files validated in workspace
  • local pre-push gate passed

Copilot AI review requested due to automatic review settings March 19, 2026 09:05
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the AppLoggers delivery/tagging workflow documentation to explicitly separate “merge to main” from “create/push a release tag”, and adds guidance for interpreting user intent so docs/workflow-only changes can merge without triggering a release.

Changes:

  • Add a new “Tag Decision Matrix” reference document defining tag-eligible vs non-tag-eligible scenarios.
  • Update the documented release sequence to include an explicit tag-eligibility decision point (with a docs-only example).
  • Update skills/agent guidance to treat merge-to-main and release tagging as separate decisions and discourage auto-tagging.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
.github/skills/applogger-release-tagging/references/tag-decision-matrix.md Adds a decision matrix for tag eligibility.
.github/skills/applogger-release-tagging/references/release-sequence.md Inserts an explicit “decide tag-eligibility” step and a docs-only no-tag example.
.github/skills/applogger-release-tagging/SKILL.md Adds tag-eligibility rules and intent interpretation; links new matrix reference.
.github/skills/applogger-change-delivery/SKILL.md Adds guidance to avoid assuming every merge should be tagged; adds eligibility checkpoint.
.github/agents/applogger-delivery-engineer.agent.md Updates agent hard rules and workflow steps to avoid automatic tagging after merges.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines 59 to 61
2. Run [release verification](./references/release-verification.md).
3. If release config changed, verify package permissions and version propagation.
4. Confirm the GitHub Release and package publication completed.
6. Push the integrated change to `dev`.
7. Open PR from `dev` to `main`.
8. Merge only after checks are green.
9. Decide whether the merged change is release-tag eligible before invoking the release flow.
Comment on lines +23 to +27
1. complete docs change
2. push to `dev`
3. open PR `dev -> main`
4. merge after green checks
5. stop there, no tag
@devzucca devzucca merged commit dce5711 into main Mar 19, 2026
13 checks passed
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants