把技術棧規則寫進 AGENTS.md / CLAUDE.md（改寫自 awesome-cursorrules）

# Project Rules — {{PROJECT_NAME}}

> Read this before writing or editing any code. These rules override your default conventions.

## Tech stack (authoritative versions)
- Language: {{LANGUAGE}} (e.g. TypeScript 5.x, strict mode on)
- Framework: {{FRAMEWORK_AND_VERSION}} (e.g. Next.js 15 App Router)
- Styling: {{STYLING}} (e.g. Tailwind CSS + shadcn/ui — do NOT introduce styled-components)
- State: {{STATE_MANAGEMENT}} (e.g. Zustand for client, TanStack Query for server state)
- Testing: {{TESTING}} (e.g. Vitest + Playwright)
- Package manager: {{PACKAGE_MANAGER}} (e.g. pnpm — use pnpm, never npm/yarn)

## Conventions (be specific and verifiable)
- File naming: {{FILE_NAMING}} (e.g. kebab-case for files, PascalCase for components)
- Imports: {{IMPORT_RULE}} (e.g. use the `@/` alias, no deep relative `../../..`)
- Components: {{COMPONENT_RULE}} (e.g. Server Components by default; add 'use client' only when needed)
- Errors: {{ERROR_RULE}} (e.g. never swallow errors; surface a typed error object)

## Hard bans (do NOT do these)
- {{BAN_1}} (e.g. no `any` — use `unknown` + a type guard)
- {{BAN_2}} (e.g. no inline secrets — read from env via the config module)
- {{BAN_3}} (e.g. no new dependencies without asking first)

## Definition of done
- Code type-checks ({{TYPECHECK_CMD}}) and lints ({{LINT_CMD}}) clean.
- Tests pass: {{TEST_CMD}}.
- New behavior has at least one test.

# (Cursor only) save as .cursor/rules/{{STACK}}.mdc with this frontmatter:
# ---
# description: Rules for {{FRAMEWORK_AND_VERSION}}
# globs: {{GLOB_PATTERN}}   # e.g. **/*.ts, **/*.tsx
# alwaysApply: false
# ---

# Project Rules — {{PROJECT_NAME}}

> Read this before writing or editing any code. These rules override your default conventions.

## Tech stack (authoritative versions)
- Language: {{LANGUAGE}} (e.g. TypeScript 5.x, strict mode on)
- Framework: {{FRAMEWORK_AND_VERSION}} (e.g. Next.js 15 App Router)
- Styling: {{STYLING}} (e.g. Tailwind CSS + shadcn/ui — do NOT introduce styled-components)
- State: {{STATE_MANAGEMENT}} (e.g. Zustand for client, TanStack Query for server state)
- Testing: {{TESTING}} (e.g. Vitest + Playwright)
- Package manager: {{PACKAGE_MANAGER}} (e.g. pnpm — use pnpm, never npm/yarn)

## Conventions (be specific and verifiable)
- File naming: {{FILE_NAMING}} (e.g. kebab-case for files, PascalCase for components)
- Imports: {{IMPORT_RULE}} (e.g. use the `@/` alias, no deep relative `../../..`)
- Components: {{COMPONENT_RULE}} (e.g. Server Components by default; add 'use client' only when needed)
- Errors: {{ERROR_RULE}} (e.g. never swallow errors; surface a typed error object)

## Hard bans (do NOT do these)
- {{BAN_1}} (e.g. no `any` — use `unknown` + a type guard)
- {{BAN_2}} (e.g. no inline secrets — read from env via the config module)
- {{BAN_3}} (e.g. no new dependencies without asking first)

## Definition of done
- Code type-checks ({{TYPECHECK_CMD}}) and lints ({{LINT_CMD}}) clean.
- Tests pass: {{TEST_CMD}}.
- New behavior has at least one test.

# (Cursor only) save as .cursor/rules/{{STACK}}.mdc with this frontmatter:
# ---
# description: Rules for {{FRAMEWORK_AND_VERSION}}
# globs: {{GLOB_PATTERN}}   # e.g. **/*.ts, **/*.tsx
# alwaysApply: false
# ---