Skip to main content
HS
HiSETSuccess
LeetCode Prep

Agent Starter Kit

Copy-paste AGENTS.md, rules, skills, subagents, hooks, MCP configs, CI workflows, and SDK scripts — filtered to your tools.

Setup builder

What do you use, and what do you need?

Your tools

Your needs

11 files match your setup.

Repo memory

Stop the agent inventing commands and conventions

AGENTS.md
# Agent guide

## Commands
- Install: pnpm install
- Dev: pnpm dev (port 3000)
- Test: pnpm test:unit — must pass before you finish
- Lint/format: pnpm lint --fix

## Layout
- src/app/        routes only; keep pages thin
- src/lib/        shared logic, no React
- src/components/ UI components
- docs/specs/     feature specs — read the relevant one before starting

## Conventions
- HTTP: use src/lib/http.ts; do not add new HTTP clients
- Errors: throw AppError; never swallow errors with an empty catch
- Tests live next to code as *.test.ts (Vitest)

## Working agreement
- For changes touching more than 3 files, propose a plan first
- Write or update tests for every behavior change
- Do not edit tests to make them pass on bug-fix tasks

## Never
- Edit generated files in src/gen/
- Add dependencies without asking
- Commit secrets or .env files
CLAUDE.md
.cursor/rules/api-routes.mdc

Specs & PRs

Give agents a clear definition of done

docs/specs/_template.md
.github/pull_request_template.md

Subagents

Get a clean-context reviewer

.claude/agents/reviewer.md

Hooks

Enforce rules that must always hold

.claude/settings.json
.agent/hooks/mark-dirty.sh
.agent/hooks/guard-claude.sh
.cursor/hooks.json
.cursor/hooks/guard.sh