Skip to content

ref(github-code): Add edit workflow, verification, and on-behalf-of attribution#392

Merged
dcramer merged 1 commit into
mainfrom
jr/improve-github-code-skill
May 21, 2026
Merged

ref(github-code): Add edit workflow, verification, and on-behalf-of attribution#392
dcramer merged 1 commit into
mainfrom
jr/improve-github-code-skill

Conversation

@sentry-junior
Copy link
Copy Markdown
Contributor

@sentry-junior sentry-junior Bot commented May 21, 2026

Extend github-code from a GitHub CLI command reference into a compact repo-edit and PR workflow skill. Folds in the high-value behavioral rules from code-change (junior-prod) that were previously buried in reference files the model wasn't reliably loading (see getsentry/cli#996 for the attribution miss that motivated this).

On-behalf-of attribution is inline, not in references

Co-authored-by trailers, Action taken on behalf of Full Name. footer, and session link are all in the main SKILL.md workflow steps where the model can't miss them.

Investigation and verification discipline added

Read referenced context, inspect real product/UI context before inventing content, know failure shape before editing bugs, re-root-cause after failed fixes. Choose a validation path before editing (scoped checks > targeted tests > full suites). Capture baselines for risky work. Separate pre-existing failures from regressions.

Edit discipline added

Keep public surfaces minimal, remove duplication introduced by the change, solve the behavior not just the tests. Compact checklist for multi-step work. Pause-and-plan for non-obvious architecture/security/concurrency work.

Commit and PR conventions inline

type(scope): Subject format, footer ordering, line length, draft PRs by default, reviewer-facing prose, handle resolution before assignment.

api-surface.md expanded

Added git commands for branch, status, log, diff, commit. Defaulted PR creation to --draft.

Intentionally not included

Full advisor protocol (orchestration-level, not GitHub ops), diff-quality gate (separate skill), exhaustive verification harness table (conditional detail better as progressive disclosure), multi-viewport screenshot protocol.

Refs getsentry/cli#996

Action taken on behalf of David Cramer.


View Session in Sentry

@vercel
Copy link
Copy Markdown

vercel Bot commented May 21, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
junior-docs Ready Ready Preview, Comment May 21, 2026 5:06am

Request Review

…ttribution

Extend the github-code skill from a GitHub CLI reference into a compact
repo-edit and PR workflow skill, folding in the high-value rules from
code-change that were previously only in reference files.

Key additions:

- Core rules: instruction precedence, no-guessing guardrails, no fake
  check claims
- Resolve target: validation path selection (scoped checks > targeted
  tests > full suites), baseline capture for risky work, pre-existing
  failure separation
- Investigation: read referenced context, inspect real product context
  for UI/docs, know failure shape before editing bugs, re-root-cause
  after failed fix
- Edit: keep public surfaces minimal, remove introduced duplication,
  solve the behavior not just the tests, compact checklist for
  multi-step work, pause-and-plan for non-obvious work
- Verify: explicit pre-packaging validation step
- Commit: on-behalf-of Co-authored-by trailers inline, footer ordering,
  line length
- PR: draft by default, reviewer-facing prose, session link footer,
  Action taken on behalf of footer, handle resolution before assignment
- api-surface.md: branch, status, log, diff, commit commands; default
  PR creation to --draft

Intentionally not included: full advisor protocol (orchestration-level),
diff-quality gate (separate skill), exhaustive verification harness
table (conditional detail), multi-viewport screenshot protocol.

Co-authored-by: David Cramer <[email protected]>
@sentry-junior sentry-junior Bot force-pushed the jr/improve-github-code-skill branch from 9ad4410 to 79817ba Compare May 21, 2026 05:05
@sentry-junior sentry-junior Bot changed the title ref(github-code): Add edit workflow, commit conventions, and on-behalf-of attribution ref(github-code): Add edit workflow, verification, and on-behalf-of attribution May 21, 2026
@dcramer dcramer marked this pull request as ready for review May 21, 2026 05:12
@dcramer dcramer merged commit 5e8373f into main May 21, 2026
16 checks passed
@dcramer dcramer deleted the jr/improve-github-code-skill branch May 21, 2026 05:50
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