GoNavi is a cross-platform desktop client for connecting to and working with many kinds of data sources, including SQL databases, caches, message queues, vector stores, and search systems. It is for developers who query, edit, audit, and synchronize data or provide structured context to coding agents.
Borrowing it
Nothing to install: this file belongs to Syngnat/GoNavi. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/Syngnat/GoNavi/dev/AGENTS.mdgit clone --depth 1 https://github.com/Syngnat/GoNaviWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/syngnat/gonavi/agents-md)<a href="https://agentmods.dev/instructions/syngnat/gonavi/agents-md"><img src="https://agentmods.dev/badge/instructions/syngnat/gonavi/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/syngnat/gonavi/agents-md"><img src="https://agentmods.dev/badge/instructions/syngnat/gonavi/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.03908 | $0.03908 |
| Opus 5.5 | $0.01563 | $0.01563 |
| Sonnet 5.5 | $0.00782 | $0.00782 |
| Haiku 4.5 | $0.00391 | $0.00391 |
Grade B, and why
GoNavi AGENTS.md scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Asks for rootmediumPrivilege escalation
A mod that escalates privileges can change anything on the machine, not only the project.
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer How it starts
The opening of the file, as written. The whole thing — 228 lines — stays where its author put it; the contents beside it link to each section on GitHub.
GoNavi 编码规约
本文件是 GoNavi 的规约索引与跨语言硬约束。Cursor、Claude Code、Codex 及其他能读取仓库提示词的 AI 都必须遵守。语言专属手册以链接为准，不要另写一套。
配套入口：
CLAUDE.md→ Claude Code.cursor/rules/*.mdc→ Cursor（按文件类型自动附加）- 本文件 → Codex / Cursor / 通用 Agent
GO_STYLE.md→ Go 专属手册（改*.go时必读）GO_STYLE.md→ Go 专属手册（改*.go时必读）
标记含义与《阿里巴巴 Java 开发手册》一致：【强制】 必须执行，【推荐】 默认执行，【参考】 有充分理由才可偏离。
0. 项目是什么
GoNavi 是 Wails v2 + Go + React 18 的跨平台数据源工作台，不是 Electron 应用，也不是普通前后端分离 Web。
| 层 | 位置 | 职责 |
|---|---|---|
| 桌面壳 | main.go |
Wails 启动、窗口、菜单 |
| Wails 绑定 | internal/app |
给前端/MCP/Web RPC 的 App 方法，保持薄 |
| 领域实现 | internal/db、internal/ai、internal/sync、internal/connection 等 |
驱动、AI、同步、类型 |
| UI | frontend/src |
React + Ant Design 5 + Zustand + Monaco |
| 文案 | shared/i18n/*.json |
前后端共用目录 |
| 生成物 | frontend/wailsjs/ |
禁止手改 |
| Go 手册 | GO_STYLE.md |
Go 专属规约（Uber + Google + Effective Go + 本仓库） |
| Java | tools/jmx-helper、internal/jvm/testdata |
小工具/夹具，跟《阿里巴巴 Java 开发手册》 |
Go module：GoNavi-Wails。默认集成分支：dev。
1. 【强制】体积与拆分（本仓库最高优先级）
当前债务（禁止继续加行）：frontend/src/components/QueryEditor.tsx、App.tsx、store.ts、DataGrid.tsx、Sidebar.tsx、queryEditor/QueryEditorHelpers.ts、internal/app/methods_file.go、methods_db.go、app.go。
正确范例：DataGridShell / DataGridCore / DataGridModals 拆文件；components/queryEditor/、components/sidebar/、components/ai/ 拆目录；Go 侧 methods_db_objects.go、methods_db_transaction.go、application_icon_windows.go。
1.1 限额
| 对象 | 【强制】上限 | 【推荐】 |
|---|---|---|
| 新建生产源文件 | 800 行 | 400 行 |
| 存量超标文件 | 禁止净增加行数 | 每次改动都拆走一块 |
| 函数 / 组件函数体 | 120 行 | 80 行 |
| 测试文件 | 1500 行 | 按场景拆成多个 *.test.ts(x) / *_test.go |
frontend/wailsjs/** |
0 行手改 | 走 Wails 生成 |
1.2 拆分原则
- 能拆包拆包，能拆类拆类，能拆 hook 拆 hook。 不要用「先写在一个文件里以后再拆」作为默认。
- 一个文件只承担一个主题：一种驱动能力、一种 UI 面板、一组绑定方法、一个 hook。
- 触碰超标文件时，必须把本次改动抽到新文件；允许的最小动作是「新逻辑写在新文件，旧文件只留 re-export / 接线」。
- 禁止为了过限额做无意义换行、把逻辑藏进巨型字符串、或把测试和实现揉进同一生产文件。
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday Changed · +1 lines · +103 tokens per session ca7335bd9f50
- 6d ago Changed · +63 lines · +989 tokens per session scan A → B abe99fb724e9
- 29d ago First seen · 164 lines · 2,816 tokens per session scan A 8bef830906d4
GoNavi AGENTS.md is an instructions file published in the GitHub repository Syngnat/GoNavi (2,072 stars, last pushed today), licensed Apache-2.0. It adds 3,908 tokens to every session, about $0.0156 per session on Opus 5.5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-17.
Other instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
deepseek-harness AGENTS.md
AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.
vscode copilot-instructions.md
Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).