Skip to content

Co-locate Claude review checklists with their skills#1370

Open
labkey-martyp wants to merge 1 commit intodevelopfrom
fb_move_agents_to_claude
Open

Co-locate Claude review checklists with their skills#1370
labkey-martyp wants to merge 1 commit intodevelopfrom
fb_move_agents_to_claude

Conversation

@labkey-martyp
Copy link
Copy Markdown
Contributor

Rationale

The .agents/ directory predates LabKey standardizing on Claude Code as its main AI toolset, and was only being used to host review-checklist files referenced by two .claude/skills/ skills. Co-locate the rule files with their skills and consolidate the shared guidance under .claude/skills/.

Related Pull Requests

Changes

  • Move jest and react checklist files into .claude/skills/code-review-jest/ and .claude/skills/code-review-react/ respectively.
  • Promote the shared reviewer-priority and review-format guidance to .claude/skills/review-priority-and-format.md (renamed from common.md); both code-review skills reference it via ../review-priority-and-format.md.
  • Update Prerequisite links in each rule file to the new shared path.
  • Remove the now-empty .agents/ directory.
  • Smoke-test /code-review-jest and /code-review-react to confirm both skills resolve their Checklist links.

The .agents/ directory only existed to host review-checklist files
referenced by two .claude/skills/ skills (code-review-jest and
code-review-react). Each skill.md reached across the tree via
../../../.agents/review-checklists/..., which is more fragile and less
self-contained than the established skill pattern (e.g. wcag-compliance
keeps its checklist next to its skill.md). Co-locate the rule files with
their skills, and factor the shared reviewer-priority and review-format
guidance into a single file at .claude/skills/review-priority-and-format.md
(renamed from common.md to describe its contents).

* Move jest checklists from .agents/review-checklists/jest/ into
  .claude/skills/code-review-jest/.
* Move react checklists from .agents/review-checklists/react/ into
  .claude/skills/code-review-react/.
* Promote shared guidance to .claude/skills/review-priority-and-format.md;
  both code-review skills now reference it via
  ../review-priority-and-format.md.
* Update the Prerequisite link at the top of each rule file to the new
  shared path -- these had been dangling after the move.
* Remove the now-empty .agents/ directory.

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