Add md <> code comments

agents/claude.ts

@@ -1,3 +1,6 @@
+// changes to effort level configuration should be reflected in wiki/effort.md and docs/effort.mdx
+// changes to tool permissions should be reflected in wiki/granular-tools.md
+// changes to web search configuration should be reflected in wiki/websearch.md
 import { type Options, query, type SDKMessage } from "@anthropic-ai/claude-agent-sdk";
 import type { Effort } from "../external.ts";
 import { ghPullfrogMcpName } from "../external.ts";

agents/codex.ts

@@ -1,3 +1,6 @@
+// changes to effort level configuration should be reflected in wiki/effort.md and docs/effort.mdx
+// changes to tool permissions should be reflected in wiki/granular-tools.md
+// changes to web search configuration should be reflected in wiki/websearch.md
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import {

agents/cursor.ts

@@ -1,3 +1,6 @@
+// changes to effort level configuration should be reflected in wiki/effort.md and docs/effort.mdx
+// changes to tool permissions should be reflected in wiki/granular-tools.md
+// changes to web search configuration should be reflected in wiki/websearch.md
 import { spawn } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";

agents/gemini.ts

@@ -1,3 +1,6 @@
+// changes to effort level configuration should be reflected in wiki/effort.md and docs/effort.mdx
+// changes to tool permissions should be reflected in wiki/granular-tools.md
+// changes to web search configuration should be reflected in wiki/websearch.md
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";

agents/opencode.ts

@@ -1,3 +1,6 @@
+// changes to effort level configuration should be reflected in wiki/effort.md and docs/effort.mdx
+// changes to tool permissions should be reflected in wiki/granular-tools.md
+// changes to web search configuration should be reflected in wiki/websearch.md
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { ghPullfrogMcpName } from "../external.ts";

main.ts

@@ -1,3 +1,4 @@
+// changes to tool permissions should be reflected in wiki/granular-tools.md
 import { ensureProgressCommentUpdated } from "./mcp/comment.ts";
 import { initToolState, startMcpHttpServer } from "./mcp/server.ts";
 import { computeModes } from "./modes.ts";

mcp/bash.ts

@@ -1,3 +1,4 @@
+// changes to bash security (filterEnv, spawnBash) should be reflected in wiki/bash-sandbox.md, wiki/security.md, wiki/landlock.md, and docs/security.mdx
 import { type ChildProcess, type StdioOptions, spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { closeSync, openSync, writeFileSync } from "node:fs";

modes.ts

@@ -1,3 +1,4 @@
+// changes to mode definitions should be reflected in docs/modes.mdx
 import { type } from "arktype";
 import { ghPullfrogMcpName } from "./external.ts";
 

utils/instructions.ts

@@ -1,3 +1,4 @@
+// changes to prompt assembly should be reflected in wiki/prompt.md
 import { execSync } from "node:child_process";
 import { encode as toonEncode } from "@toon-format/toon";
 import { ghPullfrogMcpName, type PayloadEvent } from "../external.ts";