Skip to content

chore: add ai-resources subtree#25

Merged
mcalthrop merged 4 commits intomainfrom
chore/add-ai-resources
Apr 17, 2026
Merged

chore: add ai-resources subtree#25
mcalthrop merged 4 commits intomainfrom
chore/add-ai-resources

Conversation

@mcalthrop
Copy link
Copy Markdown
Owner

Summary

  • Add ai-resources as a git subtree, providing shared Claude rules and skills
  • Add CLAUDE.md referencing ai-resources/CLAUDE.md to wire up the rules
  • Update .gitignore to accommodate the new subtree

Test plan

  • Verify ai-resources/ directory is present with all expected files
  • Confirm CLAUDE.md resolves correctly to ai-resources/CLAUDE.md
  • Check skills (fix-vulns, link-skills, md2pdf) are accessible

🤖 Generated with Claude Code

@mcalthrop mcalthrop marked this pull request as ready for review April 17, 2026 17:29
Copilot AI review requested due to automatic review settings April 17, 2026 17:29
@mcalthrop mcalthrop enabled auto-merge (squash) April 17, 2026 17:29
@mcalthrop mcalthrop merged commit c3233f9 into main Apr 17, 2026
7 checks passed
@mcalthrop mcalthrop deleted the chore/add-ai-resources branch April 17, 2026 17:29
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a shared ai-resources/ git subtree containing Claude rules and skills, then wires it into this repo via a root CLAUDE.md include and updated ignore rules so local AI tool state isn’t committed.

Changes:

  • Add ai-resources/ subtree with rules (rules/) and skills (skills/).
  • Add root CLAUDE.md that imports @ai-resources/CLAUDE.md.
  • Ignore .claude workspace state via .gitignore (and subtree-local ignore).

Reviewed changes

Copilot reviewed 16 out of 17 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
ai-resources/skills/md2pdf/md-to-pdf.config.js Adds shared md-to-pdf config (styling + footer template).
ai-resources/skills/md2pdf/SKILL.md Documents a /md2pdf skill using the bundled config.
ai-resources/skills/link-skills/SKILL.md Adds a skill to symlink subtree skills into .claude/skills/.
ai-resources/skills/fix-vulns/SKILL.md Adds a skill describing a pnpm audit → fix → PR workflow.
ai-resources/rules/zsh-bash-commands.md Adds guidance for running commands via zsh -i -c.
ai-resources/rules/pull-requests.md Adds PR creation/cleanup guidance.
ai-resources/rules/general.md Adds general AI workflow rules (scope control, British English, etc.).
ai-resources/rules/conventional-commits.md Adds Conventional Commits guidance.
ai-resources/rules/conventional-branch-names.md Adds Conventional Branch Names guidance.
ai-resources/rules/code-organisation.md Adds code organisation/testing placement guidelines.
ai-resources/rules/all.md Aggregates rules via @... includes.
ai-resources/README.md Documents how to consume/update the subtree and link skills.
ai-resources/CLAUDE.md Entry point to import all rules + skills in the subtree.
ai-resources/AGENTS.md Provides Codex instructions by delegating to CLAUDE.md.
ai-resources/.gitignore Ignores .claude/ within the subtree context.
CLAUDE.md Imports the subtree’s CLAUDE.md to enable shared rules/skills.
.gitignore Ignores .claude directory at repo root.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +6 to +7
const generatedAt = new Date().toLocaleString();
const inputFilename = path.basename(process.argv[process.argv.length - 1]);
Copy link

Copilot AI Apr 17, 2026

Choose a reason for hiding this comment

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

inputFilename is interpolated directly into an HTML footer template. Filenames can legally contain characters like &, <, or > which will be interpreted as HTML and can break the footer rendering. Consider HTML-escaping inputFilename (and any other interpolated values) before inserting them into footerTemplate.

Copilot uses AI. Check for mistakes.
Comment thread ai-resources/rules/all.md
# All Rules

@general.md
@zsh-node-commands.md
Copy link

Copilot AI Apr 17, 2026

Choose a reason for hiding this comment

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

@zsh-node-commands.md is referenced here, but there is no such file under ai-resources/rules/ (the only matching rule file is zsh-bash-commands.md). As written, importing @rules/all.md (and therefore @ai-resources/CLAUDE.md) will fail; update the reference or rename the rule file so the include resolves.

Suggested change
@zsh-node-commands.md
@zsh-bash-commands.md

Copilot uses AI. Check for mistakes.
Comment on lines +1 to +7
# Running Commands with the `bash` shell

When running commands in the `bash` shell:

```sh
zsh -i -c "..."
```
Copy link

Copilot AI Apr 17, 2026

Choose a reason for hiding this comment

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

This rule says it is about running commands with the bash shell, but the recommended invocation is zsh -i -c "..." and the rationale references .zshrc. Please clarify whether this rule is about the Claude bash tool (which may execute via zsh for nvm) or about zsh itself, and update the heading/wording accordingly to avoid confusion.

Copilot uses AI. Check for mistakes.
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