Skip to content

AGENTS.md

Latest commit

 

History

History
32 lines (24 loc) · 1.92 KB

AGENTS.md

File metadata and controls

32 lines (24 loc) · 1.92 KB

AGENTS.md

Project Context

  • This repo is a bun monorepo.
  • Workspace packages live under apps/* and packages/* as declared in the root package.json.
  • Prefer workspace-aware commands from the repo root unless there is a clear reason to run inside a single app.

Do

  • Use bun for package management, script execution, and workspace operations.
  • Run installs from the repo root with bun install.
  • Use workspace-aware commands when appropriate, for example bun run --filter frontend build or bun run --filter learning-hono dev.
  • Use --cwd when you need to target one app directly, for example bun run --cwd apps/frontend test.
  • Add dependencies with bun add in the correct workspace, for example bun add --cwd apps/frontend <pkg>.
  • Keep changes scoped to the relevant workspace instead of duplicating config across apps.
  • Check the nearest package.json before adding scripts or dependencies.

Do Not

  • Do not use npm, pnpm, or yarn in this repo.
  • Do not introduce another lockfile format.
  • Do not install dependencies from inside a workspace if the same result should be managed from the repo root.
  • Do not assume every workspace has the same scripts; verify the target workspace first.
  • Do not move workspace packages outside apps/* or packages/* without updating the root workspace config.
  • Do not edit package.json dependency entries by hand when bun add or bun remove should be used.

Current Workspace Notes