Skip to content

chore: mount this repo at .agents/pesudev-skills in project repos - #1

Merged
aditeyabaral merged 1 commit into
pesu-dev:mainfrom
aditeyabaral:chore/rename-submodule-path
Sep 24, 2026
Merged

aditeyabaral merged 1 commit into
pesu-dev:mainfrom
aditeyabaral:chore/rename-submodule-path

Conversation

@aditeyabaral

Copy link
Copy Markdown
Member

Summary

Renames the path where project repos mount this repository from .agents/pesu-skills to .agents/pesudev-skills, so the name matches the organisation (pesu-dev).

.agents/skills itself is not an option: it is the standard skills folder, which must point at the project's own skills (<project>/skills), not at this whole repository.

Changes

  • All 50 references across 26 files: both AGENTS.md files, the auth docs, skills and roles, and the README setup steps.
  • mdformat realigned two tables whose column widths changed.

Verification

  • pre-commit run --all-files: all hooks pass.
  • All 24 skills and 10 roles still have valid frontmatter, and every repository path they reference still exists.
  • No occurrences of pesu-skills remain.

Follow-up

pesu-dev/auth#163 moves its submodule to .agents/pesudev-skills and bumps it to this commit once this merges.

🤖 Generated with Claude Code

https://claude.ai/code/session_014mRURaNGTS36tUv8Vxh6Gw

The submodule path in project repos becomes .agents/pesudev-skills (was .agents/pesu-skills), so the
name matches the organisation, pesu-dev. It cannot be .agents/skills: that is the standard skills
folder, which must point at the project's own skills rather than at this whole repository.

Every path that agents follow from a project repo changes with it: the AGENTS.md files, the auth
docs, skills and roles, and the README's setup steps. pesu-dev/auth#163 moves its submodule to the
new path in step.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014mRURaNGTS36tUv8Vxh6Gw
@aditeyabaral
aditeyabaral requested a review from a team as a code owner September 24, 2026 07:11
@aditeyabaral
aditeyabaral merged commit 719f68b into pesu-dev:main Sep 24, 2026
2 checks passed
aditeyabaral added a commit to aditeyabaral/auth that referenced this pull request Sep 25, 2026
pesu-dev/skills#1 renamed the path project repos mount it at, from .agents/pesu-skills to
.agents/pesudev-skills, to match the organisation name. This moves the submodule there, renames it
in .gitmodules, repoints AGENTS.md, .agents/skills and .claude/skills, and bumps it to that merge
(719f68b) so the paths inside the agent material match.

It cannot be .agents/skills: that folder must be auth's own skills, which agents read one level
deep, not the whole pesu-dev/skills repository.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014mRURaNGTS36tUv8Vxh6Gw
aditeyabaral added a commit to pesu-dev/auth that referenced this pull request Sep 25, 2026
* chore: add agent instructions and skills from pesu-dev/skills

Coding agents opened in this repository now find their instructions, skills and roles straight
after cloning. They live in pesu-dev/skills, mounted as a git submodule at .agents/pesu-skills, and
three links point agents at the auth folder in it:

- AGENTS.md -> .agents/pesu-skills/auth/AGENTS.md, the instructions every agent reads
- .agents/skills -> the auth skills, the standard location for Agent Skills
- .claude/skills -> the same folder, because Claude Code does not read .agents/skills

The material covers the whole contribution loop: architecture, conventions, testing (including
the single-session live tests), the API contract, metrics, the PESU Academy flow, CI/CD, security,
and 24 skills from triage to opening a pull request. A sandboxed agent used it to implement, test,
review and prepare a change end to end.

Keeping it current: Dependabot opens a pull request against dev whenever pesu-dev/skills moves.
Its pull requests come from a branch in this repository and cannot bump the version, so:

- source.yaml waives the fork requirement only for dependabot[bot] on a dependabot/ branch; the
  base must still be dev
- version-check.yaml skips the job for dependabot[bot], which still satisfies the required check;
  a submodule bump changes nothing that is deployed

CONTRIBUTING gains a Coding Agents section: clone with --recurse-submodules (or run
git submodule update --init), the Windows symlink setting, and where to send changes.

Nothing deployed changes: the Dockerfile copies only app/ and the project files, and CI checks out
without submodules.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014mRURaNGTS36tUv8Vxh6Gw

* chore: bump version to 4.8.0

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014mRURaNGTS36tUv8Vxh6Gw

* fix: keep the agent-skills links out of ruff

CI checks out without submodules, so AGENTS.md, .agents/skills and .claude/skills are dangling
links there. `ruff format .` tries to read AGENTS.md (ruff formats Markdown) and fails with
"No such file or directory", which failed the Lint check on this PR.

They are not this project's code: pesu-dev/skills lints its own files. Excluding them also stops a
local ruff run, where the submodule is present, from checking another repository's Markdown.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014mRURaNGTS36tUv8Vxh6Gw

* chore: mount pesu-dev/skills at .agents/pesudev-skills

pesu-dev/skills#1 renamed the path project repos mount it at, from .agents/pesu-skills to
.agents/pesudev-skills, to match the organisation name. This moves the submodule there, renames it
in .gitmodules, repoints AGENTS.md, .agents/skills and .claude/skills, and bumps it to that merge
(719f68b) so the paths inside the agent material match.

It cannot be .agents/skills: that folder must be auth's own skills, which agents read one level
deep, not the whole pesu-dev/skills repository.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014mRURaNGTS36tUv8Vxh6Gw

---------

Co-authored-by: Claude Opus 5.5 <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