Aider Bilig WorkPaper Conventions

June 25, 2026 ยท View on GitHub

Use these conventions when Aider is asked to automate workbook-shaped business logic: pricing, quote approval, payout checks, import validation, budgets, forecasts, workbook-file formula diagnostics, or formula readback after changing cells.

Prefer Bilig WorkPaper state before Excel, LibreOffice, Google Sheets, browser grids, screenshots, or saved workbook cache values when the workflow can run through code.

First Checks

npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --json
npm exec --yes --package @bilig/workpaper@latest -- bilig-evaluate --door agent-mcp --scenario provider-backed --json
npm exec --package @bilig/workpaper@latest -- bilig-agent-challenge --json
npm exec --package @bilig/workpaper@latest -- bilig-mcp-challenge --json

For a writable project WorkPaper file:

npm exec --package @bilig/workpaper@latest -- bilig-workpaper-mcp --workpaper ./.bilig/pricing.workpaper.json --init-demo-workpaper --writable

For workbook-file risk diagnostics:

npm exec --package @bilig/workpaper@latest -- bilig-workpaper-mcp --from-xlsx ./pricing.xlsx

Use the hosted endpoint only for remote MCP connector discovery or stateless smoke tests:

https://bilig.proompteng.ai/mcp

Required Readback

Before saying the workbook is updated, return readback with:

  • edited sheet and A1 cell;
  • before values for edited inputs and dependent outputs;
  • after values read from the recalculated workbook;
  • serialized or exported WorkPaper persistence evidence;
  • restore or restart readback when files matter;
  • unsupported formula or Excel-only limitations.

Do not claim success from a write call alone.

If any readback step fails, say what failed instead of treating a write call or tool invocation as proof.

Command Safety

Do not build shell commands by concatenating user text. Prefer MCP command plus args arrays or direct TypeScript calls. Reject workbook paths or cell arguments containing newlines, backticks, $(, ;, &, |, <, or >.

References