change-clarify

Installation
SKILL.md

change-clarify

What this skill does

Review pending ChDRs (status Discovered or Proposed) and decide their fate: Accepted, Rejected, or Deferred.

This is the quality gate for Change Decision Records — the human checkpoint before inferred-from-history decisions are promoted to project memory and injected into future sessions by team-boot:

  • Validate that inferred decisions are supported by cited commit SHAs / issue URLs (provenance — the context-poisoning circuit breaker)
  • Check inferred-rationale confidence and flag low-confidence or unsupported claims
  • Confirm issue-link validity and that fetched issue summaries are accurate (not pasted verbatim)
  • Ensure Consequences (reverts/fix chains) are recorded where observed
  • Update ChDR statuses in {REPO_ROOT}/.adlc/drafts/chdr/ChDR-{NNN}.md
  • Regenerate {REPO_ROOT}/.adlc/drafts/chdr/chdr.md index

This is an interactive command. Present exactly one ChDR per interaction and wait for user input.

When to use

Installs
148
GitHub Stars
143
First Seen
Aug 17, 2026