Skip to content
findplate

DocsAgents and CI

Agent rules and skills

One source of rules for every coding agent.

On this page

Rules with ruler

Every project has one source of rules in .ruler/AGENTS.md: the stack, structure, naming, commit format, test style and the oRPC, drizzle and better-auth conventions. ruler turns it into what each agent reads:

AgentFiles
Claude CodeCLAUDE.md, .mcp.json
CursorAGENTS.md, .cursor/mcp.json
opencodeAGENTS.md, opencode.json
ZedAGENTS.md, .zed/settings.json
oh-my-piAGENTS.md

.ruler/ruler.toml lists the agents and the MCP servers every one of them gets: context7, shadcn and vercel. The generated files are committed, so a fresh clone works without ruler. Keep the *.ruler-generated marker files next to them, ruler uses those to know what it owns.

findplate create runs ruler apply at the end. If ruler can't be fetched (offline), it skips with a note. Skip it on purpose with --no-agents.

To change a rule, edit .ruler/AGENTS.md and run:

pnpm agents

Skills

The workflow around a ticket ships as project skills in .ruler/skills, and ruler copies them into each agent's skills folder:

SkillWhat it does
dive-ticketresearch an issue before any plan or code
plan-ticketa blocker comment, or a detailed plan
shipmerge main, clean, check, push, open the PR, watch CI
review-ticketreview a PR and draft comments, never posts
triage-reviewscheck review comments against the code, draft replies
check-touchedlint, types and tests for the touched workspaces only
clean-prstrip restating comments from the branch diff

They work with GitHub issues and the Project board, and only commit or push when you invoke ship.

Public skills

findplate create also installs recommended public skills with the skills cli, listed in the skills field of the template's findplate.json: vercel-react-best-practices, vercel-composition-patterns, web-design-guidelines, shadcn, next-best-practices, turborepo, better-auth-best-practices, find-skills, and ai-sdk when the AI module is on. They land in .agents/skills and .claude/skills with a skills-lock.json.

Offline or a repo moved? That pack is skipped with a note and the rest still install. Skip all of it with --no-skills.

Today

Agents can already drive the generator itself with no prompts, see agent mode. The Next apps also carry an AGENTS.md that points agents to the bundled Next docs.