Short answer
Keep one reviewed source for shared instructions and keep repo-specific details in each repo. AIPM does not install AGENTS.md, CLAUDE.md, or Cursor rules, but shared task workflows can become skills that AIPM installs into every repo at the same pinned version.
Words used in this guide
- AIPM: a tool that installs and updates reusable AI instructions.
- Package: a named group of files that people can install and update together.
- Workflow: a set of steps used to finish a task.
- Repository or repo: a project folder whose changes are saved and tracked.
- Git: a tool that records file changes so people can review or undo them.
What this means
Copied files soon become different
A copied instruction does not get later updates. After some time, each project may have different rules even when the team expects them to match.
Split shared and local instructions
Shared instructions should cover common review, testing, security, and documentation work. Repo-specific files should cover local commands, architecture, and limits.
Install a reviewed version
Turn shared task workflows into a skill. AIPM installs the same SKILL.md into .claude/skills (Claude Code) or .agents/skills (Codex), and Cursor loads both. Each repo pins a named version in aipm.package.json, so updates are visible and can be reviewed before they spread. Every way to share skills (repo, plugin marketplace, Claude app, registry) is compared in how to share Claude skills with your team.
Simple steps
- List the instructions repeated in several repos.
- Remove private and repo-specific details.
- Move shared task workflows into a SKILL.md.
- Publish the skill with AIPM.
- Install and update the package through normal Git review.
Where to go next
If you want to try this in a real project, start with how to use AIPM and the command reference. If you want to share your own workflow, read the publishing guide.
FAQ
Should every repo use exactly the same instructions?
No. Share the common base and keep local commands, architecture, and product rules in each repo.
How do teams keep instructions the same?
Keep shared task workflows in one skill with a version number and update each project with aipm update instead of copying files by hand. Keep always-on instruction files (AGENTS.md, CLAUDE.md, Cursor rules) in Git.