AGENTS.md 1.4 KB

AGENTS.md

Project assumptions

  • This is a pnpm-based Next.js project.
  • Prefer existing patterns and conventions already present in the repo.
  • If a task is ambiguous, inspect nearby similar implementations before proposing new patterns.
  • This is NOT the Next.js you know:This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in node_modules/next/dist/docs/ before writing any code. Heed deprecation notices.
  • This project is managed by pnpm.

Working style

  • For feature work touching more than 3 files, start by proposing a plan.
  • Prefer minimal, high-confidence diffs over broad refactors.
  • Reuse existing utilities, hooks, components, and service patterns when possible.
  • Do not introduce new dependencies unless necessary and explicitly justified.
  • If you are uncertain about something (requirement), you should ask instead of assuming.
  • Test your solutions before implementing it.

Environment

  • Ubuntu 25.01 in WSL2

Run

  • pnpm run dev to run as debug

Clean

  • After code changes, you should check whether there are codes no more functions and clear them.

Validation

  • After clean, run the relevant checks:
    • pnpm lint
    • pnpm typecheck
  • If one check fails, explain the likely cause before making another edit.

Output expectations

  • Summarize changed files
  • Explain the implementation approach briefly
  • List residual risks or follow-up work