Skip to content

Commit 91817ae

Browse files
oratistclaude
authored
docs(behavior-parity): correct stale Tools table + add 2026-06 accuracy note (#151)
The Tools table marked Task, NotebookEdit, AskUserQuestion, EnterPlanMode / ExitPlanMode, EnterWorktree / ExitWorktree, ToolSearch, the seven TASK_TOOLS and the Cron tools as 🔄 deferred — every one of them is in BUILTIN_TOOLS and shipping. Flip them to ✅ (ScheduleWakeup → ⚠️: not a DeepCode tool; DeepCode uses CronCreate / `deepcode cron`). Fix the headless flags row: json-schema and include-partial-messages are implemented in headless.ts, not "parsed only". Add a dated accuracy note flagging that the remaining milestone tags (M3c/M8/…) lag the code, and listing this alignment batch's additions (-C/--cd, /diff, /release-notes, /bug, the /effort SSOT fix). Co-authored-by: t <t@t> Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent cac086d commit 91817ae

1 file changed

Lines changed: 44 additions & 35 deletions

File tree

docs/BEHAVIOR_PARITY.md

Lines changed: 44 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,15 @@
44
55
Legend: `` matches · `🟡` matches with caveats · `🔄` deferred · `⚠️` deliberately differs · `🆕` DeepCode-only addition
66

7+
> **2026-06 accuracy pass.** Several per-row tags below had drifted behind the
8+
> code (the Tools table in particular marked shipped tools as deferred — now
9+
> corrected). Treat the milestone tags (`M3c`, `M8`, …) as historical notes, not
10+
> current status. Additions landing in the alignment batch this pass:
11+
> CLI `-C` / `--cd` (Codex parity); the `/diff`, `/release-notes`, and `/bug`
12+
> (alias `/feedback`) slash commands; and a fix so the CLI `/effort` table reads
13+
> its numbers from `EFFORT_PARAMS` instead of a divergent hardcoded copy. The
14+
> rows below will be flipped to `` as those PRs merge.
15+
716
---
817

918
## Slash commands (30+ in Claude Code, ~20 shipped in DeepCode)
@@ -131,44 +140,44 @@ Specific deviations:
131140

132141
## Tools
133142

134-
| Tool | Claude Code | DeepCode | Status |
135-
| ------------------------------------------------------------------------------ | ----------- | -------- | ------------------------------------------- |
136-
| Read ||||
137-
| Write ||||
138-
| Edit ||||
139-
| Bash ||| ✅ + M3.5 sandbox wrap |
140-
| Grep ||| ✅ via ripgrep |
141-
| Glob ||| ✅ via fs.glob |
142-
| Skill ||| ✅ M5 |
143-
| Task (subagents) || 🔄 | M4 sub-agent files load; agent dispatch M4+ |
144-
| NotebookEdit || 🔄 | M8 |
145-
| AskUserQuestion || 🔄 | M3c+ |
146-
| ExitPlanMode || 🔄 | enforced via /mode |
147-
| EnterWorktree / ExitWorktree || 🔄 | M8 |
148-
| ToolSearch (deferred load) || 🔄 | M3c+ |
149-
| TaskCreate / Monitor / TaskList / TaskGet / TaskOutput / TaskStop / TaskUpdate || 🔄 | M8 (background tasks) |
150-
| CronCreate / CronList / CronDelete || 🔄 | M8 (cron daemon) |
151-
| ScheduleWakeup || 🔄 | M8 |
152-
| WebFetch ||| shipped M3c-rest — 5 MiB cap + abort |
153-
| WebSearch ||| shipped M3c-rest — DDG default + SearXNG |
154-
| TodoWrite ||| shipped M3c-rest — persists in sessionDir |
143+
| Tool | Claude Code | DeepCode | Status |
144+
| ------------------------------------------------------------------------------ | ----------- | -------- | ----------------------------------------------------------- |
145+
| Read ||| |
146+
| Write ||| |
147+
| Edit ||| |
148+
| Bash ||| ✅ + M3.5 sandbox wrap |
149+
| Grep ||| ✅ via ripgrep |
150+
| Glob ||| ✅ via fs.glob |
151+
| Skill ||| ✅ M5 |
152+
| Task (subagents) || | `TaskTool` in `BUILTIN_TOOLS` — spawns a sub-agent |
153+
| NotebookEdit || | shipped (`tools/notebook.ts`) |
154+
| AskUserQuestion || | shipped; returns null in headless |
155+
| EnterPlanMode / ExitPlanMode || | shipped; also drivable via `/mode plan` |
156+
| EnterWorktree / ExitWorktree || | shipped (`tools/worktree-tools.ts`) |
157+
| ToolSearch (deferred load) || | installed when MCP tools opt out of eager load |
158+
| TaskCreate / Monitor / TaskList / TaskGet / TaskOutput / TaskStop / TaskUpdate || | shipped — background tasks (`TASK_TOOLS`) |
159+
| CronCreate / CronList / CronDelete || | shipped — launchd-backed scheduler |
160+
| ScheduleWakeup || ⚠️ | not a tool in DeepCode — use `CronCreate` / `deepcode cron` |
161+
| WebFetch ||| shipped M3c-rest — 5 MiB cap + abort |
162+
| WebSearch ||| shipped M3c-rest — DDG default + SearXNG |
163+
| TodoWrite ||| shipped M3c-rest — persists in sessionDir |
155164

156165
## CLI flags
157166

158-
| Flag | Status |
159-
| ---------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
160-
| `--help` / `--version` ||
161-
| `--mode` / `--permission-mode` ||
162-
| `--model` / `--effort` ||
163-
| `--max-turns` ||
164-
| `--system-prompt` / `--append-system-prompt[-file]` ||
165-
| `--allowedTools` / `--disallowedTools` ||
166-
| `--bare` | 🔄 (parsed, semantics deferred) |
167-
| `--settings` / `--agents` / `--mcp-config` / `--plugin-dir` / `--plugin-url` | 🔄 (parsed only) |
168-
| `--no-plugins` / `--strict` | 🔄 (parsed only) |
169-
| `-p` headless | ✅ text/json/stream-json, 5 exit codes |
170-
| `--output-format` / `--json-schema` / `--include-partial-messages` | 🟡 output-format ✅; json-schema + include-partial-messages parsed only |
171-
| `--resume <id>` / `--continue` / `--fork-session` | 🔄 M3c+ |
167+
| Flag | Status |
168+
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
169+
| `--help` / `--version` | |
170+
| `--mode` / `--permission-mode` | |
171+
| `--model` / `--effort` | |
172+
| `--max-turns` | |
173+
| `--system-prompt` / `--append-system-prompt[-file]` | |
174+
| `--allowedTools` / `--disallowedTools` | |
175+
| `--bare` | 🔄 (parsed, semantics deferred) |
176+
| `--settings` / `--agents` / `--mcp-config` / `--plugin-dir` / `--plugin-url` | 🔄 (parsed only) |
177+
| `--no-plugins` / `--strict` | 🔄 (parsed only) |
178+
| `-p` headless | ✅ text/json/stream-json, 5 exit codes |
179+
| `--output-format` / `--json-schema` / `--include-partial-messages` | output-format + json-schema (lightweight top-level validation) + include-partial-messages all implemented (`headless.ts`) |
180+
| `--resume <id>` / `--continue` / `--fork-session` | 🔄 M3c+ |
172181

173182
## What DeepCode adds that Claude Code doesn't have (yet)
174183

0 commit comments

Comments
 (0)