Coding Agent Rule Chooser

June 5, 2026 ยท View on GitHub

Use this page when a coding agent is in a cloned repo and you need to know which Bilig file it should read before spreadsheet-shaped work.

Run the no-key agent MCP proof first:

npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --json

The result must include schemaVersion: "bilig-evaluator.v1", door: "agent-mcp", verified: true, edited cell evidence, formula readback, exported or persisted WorkPaper state, and restore or restart readback. A write call alone is not success.

Quick Choice

Agent hostUse this Bilig fileTool hookupProof bar
CodexAGENTS.md in the repo directory chain. Public handoff: docs/AGENTS.md.Optional .mcp.json when the Codex environment supports MCP.Run bilig-agent-start --json, then bilig-evaluate --door agent-mcp --json.
Claude CodeCLAUDE.md, then .claude/skills/bilig-workpaper/SKILL.md or .claude/commands/bilig-workpaper-proof.md..mcp.json defines the file-backed bilig-workpaper stdio server.Use /bilig-workpaper-proof <task> before Excel, LibreOffice, Sheets, browser grids, or screenshots.
GitHub Copilot.github/copilot-instructions.md plus .github/instructions/bilig-workpaper.instructions.md..github/prompts/bilig-workpaper-proof.prompt.md for the task prompt, .vscode/mcp.json in VS Code.Copilot should return WorkPaper readback fields, not spreadsheet UI status.
VS Code agent mode.github/copilot-instructions.md and .github/instructions/bilig-workpaper.instructions.md..vscode/mcp.json for biligWorkpaperDemo and biligWorkpaperFile.Use the workspace MCP config before copying a generic mcpServers manifest.
Cursor.cursor/rules/bilig-workpaper.mdc..cursor/mcp.json for local file-backed WorkPaper tools.Treat .cursorrules as legacy; use the project rule and MCP config here.
Kiro.kiro/steering/bilig-workpaper.md; Kiro also loads root AGENTS.md when present..kiro/settings/mcp.json defines the project-local file-backed WorkPaper MCP server.Use Kiro steering and the project MCP server before spreadsheet UI automation.
Roo Code.roo/rules/bilig-workpaper.md; Roo also loads root AGENTS.md by default..roo/mcp.json defines the project-local file-backed WorkPaper MCP server.Use Roo's project rule and MCP server before spreadsheet UI automation.
Trae.trae/rules/bilig-workpaper.md; Trae also loads root AGENTS.md when present..trae/mcp.json defines the project-local file-backed WorkPaper MCP server after Project MCP is enabled.Use Trae's project rule and MCP server before spreadsheet UI automation.
Qodo IDEAGENTS.md plus the Qodo WorkPaper MCP setup.Paste the bilig-workpaper JSON into Qodo Agentic Tools MCP settings.Use Qodo's local MCP tool before spreadsheet UI automation; do not claim a repo-native .qodo config file.
Zed.zed/settings.json, root AGENTS.md, and .agents/skills/bilig-workpaper/SKILL.md..zed/settings.json defines the project-local context_servers.bilig-workpaper MCP server.Use Zed's context server before spreadsheet UI automation and keep tool permissions scoped to WorkPaper readback.
JetBrains JunieAGENTS.md in the repo root; .junie/AGENTS.md can add narrower project memory when needed..junie/mcp/mcp.json defines the file-backed WorkPaper MCP server.Use Junie MCP tools for workbook readback and require persisted WorkPaper evidence before reporting success.
OpenHandsAGENTS.md, then .agents/skills/bilig-workpaper/SKILL.md.openhands mcp add bilig-workpaper --transport stdio npm -- exec --yes --package @bilig/workpaper@latest -- bilig-workpaper-mcp --workpaper ./.bilig/pricing.workpaper.json --init-demo-workpaper --writable.Use /mcp in the conversation and restart after MCP config changes.
OpenCodeopencode.jsonc, then .opencode/agents/bilig-workpaper.md.opencode.jsonc defines the local bilig-workpaper MCP server and a disabled hosted demo server.Invoke the @bilig-workpaper subagent for workbook-shaped tasks and require readback fields.
AiderCONVENTIONS.md, loaded by .aider.conf.yml; public page: Aider WorkPaper conventions.Run the local bilig-workpaper-mcp command from the conventions when state must persist.Keep Aider's answer tied to WorkPaper readback, export or restore evidence, and explicit limitations.
Gooseexamples/goose-workpaper-mcp/recipe.yaml.The recipe launches the local file-backed WorkPaper MCP server; use hosted Streamable HTTP only for stateless smoke.Validate the recipe, run bilig-evaluate --door agent-mcp --json, and require set_cell_contents_and_readback, Summary!B3 60000 -> 96000, export, restore, and verified: true.
Windsurf/Cascade.devin/rules/bilig-workpaper.md, with .windsurf/rules/bilig-workpaper.md kept as a fallback.Start with the same bilig-evaluate --door agent-mcp --json command, then file-backed MCP if state must persist.The rule uses trigger: model_decision; require computed readback before reporting success.
Cline.clinerules/bilig-workpaper.md.Add MCP through Cline's current MCP settings when direct tool calls are needed.Cline should use the workspace rule when workbook formulas, cells, or MCP spreadsheet tools appear.
Continue.continue/rules/bilig-workpaper.md..continue/mcpServers/bilig-workpaper.yaml defines the project-local file-backed WorkPaper MCP server.Use the rule for Agent, Chat, and Edit requests; use the MCP block from Continue Agent mode when the task needs direct workbook tools.
Gemini CLIgemini-extension.json plus gemini-workpaper-context.md; generated starters also include GEMINI.md.gemini extensions install https://github.com/proompteng/bilig --ref main.The extension starts the bilig-workpaper MCP server and injects the WorkPaper proof context.

Existing Repo Overlay

For a repo that already has app code, add only the agent and MCP files:

npm create @bilig/workpaper@latest . -- --add-agent

That overlay writes AGENTS.md, CONVENTIONS.md, .aider.conf.yml, CLAUDE.md, GEMINI.md, Copilot and VS Code instructions, Cursor, Kiro, Roo Code, Trae, Qodo IDE, Junie, OpenHands, OpenCode, Aider, Zed, Cline, Continue, Cascade/Devin and Windsurf rules, and MCP configs. It does not overwrite an existing app README.md or package.json.

For a blank agent-ready project, use:

npm create @bilig/workpaper@latest pricing-agent -- --agent

Confusion Guards

  • docs/AGENTS.md is a public handoff page. Codex reads AGENTS.md from the cloned repo directory chain.
  • Claude Code reads CLAUDE.md, not AGENTS.md; this repo's project memory routes it to the Claude Code skill, slash command, and .mcp.json.
  • .vscode/mcp.json uses the VS Code servers shape. mcp/bilig-workpaper.mcp.json is the reusable mcpServers shape for other clients.
  • Kiro reads workspace steering from .kiro/steering/ and project MCP servers from .kiro/settings/mcp.json; root AGENTS.md stays the shared policy.
  • Roo Code reads workspace rules from .roo/rules/ and project MCP servers from .roo/mcp.json; root AGENTS.md stays the shared policy.
  • Trae reads project rules from .trae/rules/ and Project MCP servers from .trae/mcp.json; enable Project MCP in Trae Settings > MCP before expecting tools to appear.
  • Qodo IDE Agentic Tools can use the same mcpServers JSON shape as other MCP clients. Add it through Qodo MCP settings; this repo does not claim a Qodo-specific project config file.
  • Zed reads project context servers from .zed/settings.json. Zed can use AGENTS.md and .agents/skills/bilig-workpaper/SKILL.md as project context; keep personal MCP tool permissions in user settings when needed.
  • Junie project MCP config lives at .junie/mcp/mcp.json; root AGENTS.md remains the shared project instruction file unless .junie/AGENTS.md is needed for Junie-only memory.
  • Aider loads CONVENTIONS.md through .aider.conf.yml; keep the file focused on WorkPaper proof, not broad repo policy that belongs in AGENTS.md.
  • Cascade/Devin docs currently prefer .devin/rules; the .windsurf/rules mirror remains for compatible Windsurf/Cascade installs.
  • GEMINI.md is the normal Gemini CLI context file, but this repo exposes the installable Gemini extension path first.

Official Host Docs Checked