Skip to content

feat: support .changelog/instructions.md for custom AI prompts#67

Open
decofe wants to merge 1 commit intomasterfrom
onbjerg/changelog-instructions-file
Open

feat: support .changelog/instructions.md for custom AI prompts#67
decofe wants to merge 1 commit intomasterfrom
onbjerg/changelog-instructions-file

Conversation

@decofe
Copy link
Member

@decofe decofe commented Mar 12, 2026

Repos can now override the default AI prompt by dropping an instructions.md file in .changelog/. This lets repos define project-specific semver classification rules without passing --instructions on every invocation or modifying CI workflows.

Uses {packages} and {diff} as template placeholders, same as the built-in default.

Priority: --instructions CLI flag > .changelog/instructions.md > built-in default.

Co-Authored-By: onbjerg 8862627+onbjerg@users.noreply.github.com

Prompted by: onbjerg

Repos can now override the default AI prompt by placing an instructions.md
file in their .changelog/ directory. This lets repos define project-specific
semver classification rules without needing to pass --instructions on every
invocation.

Priority: --instructions flag > .changelog/instructions.md > built-in default.

Co-Authored-By: onbjerg <8862627+onbjerg@users.noreply.github.com>
@github-actions
Copy link
Contributor

⚠️ Changelog not found.

A changelog entry is required before merging. We've generated a suggested changelog based on your changes:

Preview
---
changelogs: minor
---

Added support for a `.changelog/instructions.md` file to override the default AI prompt, with priority order: `--instructions` flag > `.changelog/instructions.md` > built-in default. Updated README with documentation for this feature.

Add changelog to commit this to your branch.

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.

2 participants