From 6e5fa5b24d4eb91cddb7542fe7d95fd78481110a Mon Sep 17 00:00:00 2001 From: can1357 Date: Fri, 23 Jan 2026 13:46:01 +0100 Subject: [PATCH] docs: added guidelines for import patterns, prompt management, and static file handling - Added guidelines for import patterns, prompt management, and static file handling in the coding agent documentation. --- AGENTS.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 86fc79f44..295cbd830 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -24,6 +24,9 @@ This repo contains multiple packages, but **`packages/coding-agent/`** is the pr - **NEVER use inline imports** - no `await import("./foo.js")`, no `import("pkg").Type` in type positions, no dynamic imports for types. Always use standard top-level imports. - NEVER remove or downgrade code to fix type errors from outdated dependencies; upgrade the dependency instead - Always ask before removing functionality or code that appears to be intentional +- **NEVER use relative parent imports** (`../xxx`) — always use configured path aliases (e.g., `@/utils`, `~/components`) +- **NEVER build prompts in code** — no inline strings, no template literals, no string concatenation. Prompts live in static `.md` files; use Handlebars for any dynamic content. +- **Import static text files via Bun** — use `import content from "./prompt.md" with { type: "text" }` instead of `readFileSync` ## Bun Over Node