Skip to content

chore: no-issue: add Claude Code skills and top-level specs/ scaffold#10131

Open
tcaiger wants to merge 6 commits into
mainfrom
chore/workhorse-skills
Open

chore: no-issue: add Claude Code skills and top-level specs/ scaffold#10131
tcaiger wants to merge 6 commits into
mainfrom
chore/workhorse-skills

Conversation

@tcaiger

@tcaiger tcaiger commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Changes

Adds a cluster of Claude Code skills under .agents/skills/, ported and adapted from the workhorse repo, plus a top-level specs/ directory the skills write to. The skills sit in the tool-agnostic .agents/ directory, with a .claude/skills symlink so Claude Code discovers them. Markdown only — no application code, no runtime impact.

Skills — covering the spec → design → plan → test → implement → audit lifecycle:

  • Spec/design: interview, draft-spec-changes, spec-review, workshop, mock-this-up, ascii-design
  • Planning: tech-design, plan-implementation, plan-cards
  • Test cases: draft-test-cases, automate-test-cases
  • Build: implement, investigate-and-fix
  • Audits: bug-review, design-audit, security-audit, acceptance-audit

Plus shared convention docs under .agents/skills/shared/ (spec-format, plan-format, test-cases-format, card-plan-format, design-sourcing) that the skills reference. Everything is adapted to Tamanu — Linear tickets, main as the base branch, and the healthcare security rules from llm/project-rules/.

Specs location — the skills read and write specs in a new top-level specs/<area>/ tree (e.g. specs/invoicing), not docs/specs/. This PR scaffolds that directory with overview.md placeholders (a one-sentence summary each) for the obvious top-level domains: administration, encounters, fhir, imaging, immunisation, invoicing, labs, medication, patient, program-registry, programs, referrals, reports, scheduling, sync, vitals.

Adds the spec/design/plan/test/audit skill cluster under .claude/skills
plus shared convention docs, ported and adapted from the workhorse repo.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

@cursor cursor Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Want higher recall? High effort reviews run extra passes and find more bugs. A team admin can switch effort levels in the Cursor dashboard.

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit fe62a58. Configure here.


Ask focused questions — one or two at a time, not long lists. **Number your questions** so the user can reply by number.

For UI-heavy features, proactively create an HTML mockup when a visual would help. Read the relevant existing implementation in the repo first so it's grounded in what exists.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Interview mockups skip design rules

Medium Severity

The interview skill creates HTML mockups but only says to read existing UI code. It omits design-sourcing.md, so mockups may miss the required path, inline format, and “preserve unchanged aspects” rules used elsewhere.

Additional Locations (1)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit fe62a58. Configure here.

@review-hero

review-hero Bot commented Jun 23, 2026

Copy link
Copy Markdown

🦸 Review Hero Summary
3 agents reviewed this PR | 0 critical | 0 suggestions | 0 nitpicks | Filtering: consensus 3 voters

No issues found. Looks good!

tcaiger and others added 3 commits June 24, 2026 11:27
Specs live in a top-level specs/<area>/ tree (e.g. specs/invoicing),
not docs/specs/.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…olders

Seeds specs/<area>/overview.md placeholders for Tamanu's top-level
product/platform domains, each with a one-sentence summary.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@review-hero

review-hero Bot commented Jun 23, 2026

Copy link
Copy Markdown

🦸 Review Hero Summary
3 agents reviewed this PR | 0 critical | 0 suggestions | 0 nitpicks | Filtering: consensus 3 voters

No issues found. Looks good!

@jaskfla

jaskfla commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Adds a cluster of Claude Code skills under .claude/skills/

Can I suggest using .agents/skills/? I have a PR incoming that uses that, and symlinks .claude/skills to it

@tcaiger tcaiger force-pushed the chore/workhorse-skills branch from 1400160 to 9b4f899 Compare June 25, 2026 00:40
Relocates the skill cluster to the tool-agnostic .agents/skills directory
and adds a .claude/skills symlink so Claude Code still discovers them.
Internal cross-references updated to .agents/skills for tool-neutrality.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@tcaiger tcaiger force-pushed the chore/workhorse-skills branch from 9b4f899 to 80f6ce8 Compare June 25, 2026 02:11
@tcaiger tcaiger changed the title chore: no-issue: add Claude Code skills ported from workhorse chore: no-issue: add Claude Code skills and top-level specs/ scaffold Jun 25, 2026
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