Skip to content

Add pre-done PR check to heartbeat skill#10

Open
marvin-tensorleap wants to merge 1 commit into
masterfrom
ten-193-heartbeat-pr-check-clean
Open

Add pre-done PR check to heartbeat skill#10
marvin-tensorleap wants to merge 1 commit into
masterfrom
ten-193-heartbeat-pr-check-clean

Conversation

@marvin-tensorleap

Copy link
Copy Markdown
Collaborator

Why this change exists

Agents were prematurely closing issues as done while their linked GitHub PR was still open (not yet merged). This was surfaced in TEN-191 RCA and tracked as TEN-193. Without a structural guardrail in the shared heartbeat skill, every agent was susceptible to the same premature closure pattern.

How this PR fixes it

Adds an explicit Done Checklist subsection inside Step 8 — Update status of the heartbeat skill. The checklist makes the open-PR guard a first-class procedural check rather than a learnable inference. A parallel entry is added to the Critical Rules section so the rule is visible even on a quick scan.

Changes

skills/paperclip/SKILL.md — 19 lines added, 0 deleted:

  1. New ### Done Checklist subsection in Step 8 (between status-values line and ### Status Quick Guide):

    • Step 1: check if the issue has an open (unmerged) GitHub PR
    • Open PR → set in_review, leave comment "issue will close once PR merges"
    • Explicit callout: PR approved ≠ done — merge is the correct trigger
    • Quick-reference table: Open → in_review | Merged → done | No PR → done
  2. New critical rule at the top of the Critical Rules list:

    Never done with an open PR. If the issue has an open (unmerged) GitHub PR, set in_review not done. PR approved ≠ merged. See the Done Checklist in Step 8.

🤖 Generated with Claude Code

Agents were closing issues as done while their GitHub PR was still open,
causing premature closure before code actually merged. This adds an
explicit pre-done checklist in Step 8 and a critical rule that fires
before agents reach for the done status.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
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