Contributing
AI tooling
Rift is developed with AI agents, often several in parallel, each in its own worktree.
Their instructions for Claude Code (opens in a new tab) live in CLAUDE.md and .claude/: guidelines for the architecture, Git and docs, rules for PHP, Go, comments, tests and docs that load for the files they cover, and skills.
Recording AI-assisted work
Commits made with AI assistance end with a trailer naming the tool and the model that did the work, not one that only wrote the commit message:
Co-Authored-By: Claude Code <noreply@anthropic.com>
Model: Opus (claude-opus-5-5)
Agent skills
| Skill | What it does |
|---|---|
git-commit | Writes and checks the message for staged changes, used by agents. |
/open-pr | Opens a pull request with the title and description described in Commits and pull requests. |
/address-pr-comments | Works through open review feedback on a pull request, from Codex (opens in a new tab) or any reviewer. |
/update-dependencies | Updates Composer and Bun dependencies, the docs site's included, one commit per package. |
The slash commands are only run by hand: their skills set disable-model-invocation: true, so an agent never starts one on its own.
MCP servers
.mcp.json configures the Model Context Protocol (opens in a new tab) servers for this project, so every worktree gets the same ones:
| Server | What it is for |
|---|---|
| Context7 (opens in a new tab) | Current documentation for Laravel Zero, Pest, Larastan and the rest. |