The AI-ready team playbook

.agents/settings.json

1. {
2. "permissions": {
3. "allow": ["Bash(npm run test:*)"],
4. "ask": ["Edit(db/migrations/**)"],
5. "deny": [
6. "Read(./.env*)",
7. "Read(./exports/customers/**)"
8. ]
9. }
10. }

.agents/rules/customer-data.md

1. ---
2. paths: ["services/billing/**", "db/**"]
3. ---
4. Agents read the seed copy in db/seed/ only.
5. Names, emails and cards never enter a prompt.
6. Approved: head of engineering, with legal.

AGENTS.md

1. # Acme checkout
2. Annual billing ships before usage pricing.
3. ## Commands
4. npm run test:billing (40 seconds)
5. npm run lint
6. ## Style
7. Money is integer cents, never floats.
8. Prices come from plans.ts, never typed.
9. ## Gotchas
10. Invoice numbers never skip or repeat.
11. Read docs/decisions/ before a billing spec.

.agents/rules/billing-service.md

1. ---
2. paths: ["services/billing/**"]
3. ---
4. Call billing through its client, never its tables.
5. Proration rounds down to the cent.

.agents/skills/launch-brief/SKILL.md

1. ---
2. description: Write a launch brief from a
3. request. Use for any new plan or price.
4. argument-hint: [request link]
5. ---
6. 1. Read AGENTS.md and docs/decisions/.
7. 2. Name the customer, problem and goal.
8. 3. List what changes for support and sales.
9. 4. Run checklist.md before you hand it over.
10. One page. A PM and an engineer start from it.

.agents/skills/launch-brief/checklist.md

1. # Before you hand it over
2. - [ ] Prices match plans.ts
3. - [ ] Legal wording copied, not rewritten
4. - [ ] Support has the answers a week early

.agents/skills/billing-change/SKILL.md

1. ---
2. description: Turn an approved brief into
3. small billing changes.
4. ---
5. 1. Explore: read the brief, then the code.
6. 2. Plan: one task per ten-minute review.
7. 3. Implement each task on its own branch.
8. 4. Write each task's test before its code.
9. 5. Commit on the branch. Never on main.
10. Stop and ask if a migration is needed.

.agents/skills/billing-change/plan-template.md

1. # Plan: {brief title}
2. ## Tasks, each small enough to review
3. ## Tests written first
4. ## Migrations: none, or ask a person

.agents/agents/reviewer.md

1. ---
2. name: reviewer
3. description: Reviews each billing change
4. before a person does.
5. tools: Read, Grep, Glob, Bash
6. ---
7. You did not write this diff. Read it cold.
8. Check proration, currency and refunds.
9. Run npm run test:billing and npm run lint.
10. Send it back if a rule in testing.md fails.

.agents/rules/testing.md

1. ---
2. paths: ["services/**/*.test.ts"]
3. ---
4. Every bug fix ships with the test that
5. would have caught it.

.agents/skills/release/SKILL.md

1. ---
2. description: Ship an approved change.
3. disable-model-invocation: true
4. ---
5. Only a person runs this. Agents cannot.
6. 1. Check the reviewer passed the change.
7. 2. Billing: the head of product approves.
8. 3. Anything else: the engineering manager.
9. 4. Release to 10% of accounts, then all.
10. 5. Watch the first hour. Roll back on errors.

.agents/agent-memory/reviewer/MEMORY.md

1. # What the reviewer has learned
2. Upgrades to annual charged twice. Check it.
3. Invoice numbers skipped once. Check it.