Skip to content

chore(changelog-drafter): add post-run critique section#77

Open
shivamsingh-007 wants to merge 3 commits into
cobusgreyling:mainfrom
shivamsingh-007:add-post-run-critique
Open

chore(changelog-drafter): add post-run critique section#77
shivamsingh-007 wants to merge 3 commits into
cobusgreyling:mainfrom
shivamsingh-007:add-post-run-critique

Conversation

@shivamsingh-007

@shivamsingh-007 shivamsingh-007 commented Jun 27, 2026

Copy link
Copy Markdown

Summary

Add post-run critique step to the Changelog Drafter pattern. After human review, the operator records missed items, false positives, grouping issues, retries, and prompt/policy adjustments so the next run benefits from past feedback. No auto-publish changes — report-only stays report-only.

Changes

  • Doc / example improvement
    • patterns/changelog-drafter.md — added step 8, Post-Run Critique section, failure mode row
    • starters/changelog-drafter/changelog-drafter-state.md.example — added example critique block

Checklist (from CONTRIBUTING)

  • All required sections present for patterns (no new pattern — existing doc)
  • Links work from README, patterns/README, starters/README, docs/index
  • No secrets, tokens, internal company URLs
  • STATE.md examples use .example suffix (unchanged)
  • Safety-related content references docs/safety.md (pattern already references it)
  • Ran node tools/loop-audit/dist/cli.js . and addressed findings

Testing / Dogfood

  • loop-audit passes on this repo (score: 100/100, L3)
  • Manual review of generated state / skill output (critique block matches documented format)

Screenshots / Examples

N/A — doc-only change. See the example critique block in starters/changelog-drafter/changelog-drafter-state.md.example.

Adds a Post-Run Critique step to capture missed items, false positives,
grouping issues, retries, and prompt/policy adjustments after each draft
run. Includes example in the starter state file and a failure mode row.
Copilot AI review requested due to automatic review settings June 27, 2026 09:45

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Adds a “Post-Run Critique” step to the changelog-drafter pattern so operators can capture what the previous draft missed/misclassified and carry concrete improvements into the next run.

Changes:

  • Adds a Post-Run Critique step and guidance to patterns/changelog-drafter.md.
  • Adds an example Post-Run Critique block to the changelog-drafter state starter.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File Description
starters/changelog-drafter/changelog-drafter-state.md.example Adds an example “Post-Run Critique” section to the state template.
patterns/changelog-drafter.md Documents the Post-Run Critique step and adds a related failure-mode mitigation.

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

Comment thread starters/changelog-drafter/changelog-drafter-state.md.example
Comment thread starters/changelog-drafter/changelog-drafter-state.md.example Outdated
Comment thread patterns/changelog-drafter.md
Comment thread patterns/changelog-drafter.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

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

Comment thread starters/changelog-drafter/changelog-drafter-state.md.example
Comment thread starters/changelog-drafter/changelog-drafter-state.md.example Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

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

## Recently Published
- v2.14.0 — published 2026-06-01 (human reviewed draft)

## Post-Run Critique (from last run)

## Post-Run Critique

After the human reviews the draft, the human reviewer or operator records what the previous run missed or misclassified so the next run improves. This captures review findings from the last draft run.
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