Skip to content

feat(skills): extend github with AC-walk and close-with-evidence patterns 🎓#134

Draft
Klazomenai wants to merge 1 commit into
mainfrom
feat/115-github-ac-verification
Draft

feat(skills): extend github with AC-walk and close-with-evidence patterns 🎓#134
Klazomenai wants to merge 1 commit into
mainfrom
feat/115-github-ac-verification

Conversation

@Klazomenai

Copy link
Copy Markdown
Owner

Summary

Extends claude/skills/github/SKILL.md with the operator-strict workflow for closing Refs #N issues post-merge:

  • Five-step walk-and-decide: list AC → classify evidence type → verify → decide → comment with table
  • Three evidence types: code-state-verifiable / CI-state / operational-test (incl. deferral-by-invariant)
  • Verification table format (one row per AC + evidence + commit SHA)
  • 100%-or-don't-close rule (open is the load-bearing signal)
  • Auto-close keyword discipline (closure is explicit via gh issue close, never implicit via merge-time Closes #N)
  • Worked example showing partial-completion progress table
  • Anti-Patterns section gains two entries

Section slots between PR Review Replies and Deployment Sign-Off Conventions so the file flows: PR-review walk → PR-reply mechanics → Issue-close walk → Deployment sign-off.

Codifies discipline previously living only in operator-internal notes.

Test plan

  • make install-claude succeeds and propagates new section to ~/.claude/skills/github/SKILL.md
  • grep -n "## Issue Acceptance-Criteria Verification at Close" claude/skills/github/SKILL.md → present at line 91
  • grep -n "### Worked example" claude/skills/github/SKILL.md → present at line 131
  • Anti-Patterns gains two entries (Closing an issue without walking each AC, Using ... auto-close keywords even when authorised)
  • Copilot Review converges to zero remaining concerns
  • CI passes (any skill-CI gates if present)
  • Post-merge: close #115 with verification table citing this commit SHA

Refs #115

…erns 🎓

Adds "## Issue Acceptance-Criteria Verification at Close" section covering
the operator-strict workflow for closing issues against `Refs #N` PRs:

- Five-step walk-and-decide process (list / classify / verify / decide /
  comment)
- Three evidence types: code-state-verifiable, CI-state, operational-test
  (incl. deferral-by-invariant for forward-looking AC)
- Verification table format (one row per AC + evidence column + commit SHA)
- 100%-or-don't-close rule with open-is-the-load-bearing-signal rationale
- Auto-close keyword discipline (Closes/Fixes/Resolves never appear in
  commit/PR text; closure is explicit via `gh issue close`)
- Worked example showing a partial-completion progress table

Anti-Patterns section gains:
- Closing an issue without walking each AC against evidence
- Using auto-close keywords even when authorised to close

Section slots between `PR Review Replies` and `Deployment Sign-Off
Conventions` so the file flows: PR-review walk → PR-reply mechanics →
Issue-close walk → Deployment sign-off.

Pattern codifies discipline previously living in operator-internal notes
(memory/feedback_refs_issue_review.md).

Refs #115

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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.

1 participant