Skip to content

fix: remove project-specific story citation from checkpoint SKILL.md#322

Closed
rucka wants to merge 1 commit into
mainfrom
fix/checkpoint-no-story-citation
Closed

fix: remove project-specific story citation from checkpoint SKILL.md#322
rucka wants to merge 1 commit into
mainfrom
fix/checkpoint-no-story-citation

Conversation

@rucka

@rucka rucka commented Jul 12, 2026

Copy link
Copy Markdown
Collaborator

Fix: remove project-specific story citation from checkpoint SKILL.md

Type: Fix (KB skill) · Priority: P2 · Risk: Low (docs-only)

Motivation

Following up on the design-rules.md finding (KB guidelines must not reference this repo's own ADRs/decision-log/code, since they distribute in isolation to other adopting projects): a corpus-wide scan found the skill dataset is otherwise clean, except one spot — checkpoint/SKILL.md's frontmatter description and Composition Interface section both cited (story #256), a Pair-repo-specific issue number meaningless to any project installing this skill.

Changes Made

Removed both citations (dataset + installed mirror). The sentence still correctly conveys "this is a planned future composition" without tying it to this repo's own issue tracker.

Testing / Quality Gates

knowledge-hub check:links:  all valid
knowledge-hub test:         80/80 pass
mdlint:                     pass
docs:staleness:              PASS — 35 skills, 8 commands in sync

🤖 Generated with Claude Code

Both the frontmatter description and the Composition Interface section
cited "(story #256)" — a Pair-repo-specific issue number, meaningless
to any project that installs this KB-shipped skill. KB guidelines and
skills must not reference this repo's own ADRs, decision-log entries,
or issue-tracker numbers, since they distribute in isolation to other
projects. Removed both citations, dataset + installed mirror.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@rucka

rucka commented Jul 12, 2026

Copy link
Copy Markdown
Collaborator Author

Fold into #319 instead (same theme — skill-authoring quality, no-project-citation rule) — see fbe8b3c on that branch.

@rucka rucka closed this Jul 12, 2026
@rucka rucka deleted the fix/checkpoint-no-story-citation branch July 12, 2026 17:08
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