detached f9c8b6d

docs(subagents): clarify isolation behavior

commit
f9c8b6da0c9b523ecd282905532f6de654fece00
author
brice · · 2026-08-24 10:36 UTC
parent
8a835a8
signature
GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email
2 files · +2 -2
M packages/agent/tools/resident_tools_test.go +1 -1
@@ -71,7 +71,7 @@ func TestSubagentSpawnGuidanceRequiresIndependentOwnership(t *testing.T) {
7171 t.Fatal(err)
7272 }
7373 task := schema.Properties["task"].Description
74- for _, want := range []string{"concrete, bounded scope", "explicit ownership", "does not overlap"} {
74+ for _, want := range []string{"concrete, bounded scope", "explicit ownership", "does not overlap", "Shared isolation uses this working directory", "worktree isolation captures a patch without merging it"} {
7575 if !strings.Contains(task, want) {
7676 t.Fatalf("task schema missing %q: %s", want, task)
7777 }
@@ -71,7 +71,7 @@ func TestSubagentSpawnGuidanceRequiresIndependentOwnership(t *testing.T) {
71 t.Fatal(err)71 t.Fatal(err)
72 }72 }
73 task := schema.Properties["task"].Description73 task := schema.Properties["task"].Description
74- for _, want := range []string{"concrete, bounded scope", "explicit ownership", "does not overlap"} {74+ for _, want := range []string{"concrete, bounded scope", "explicit ownership", "does not overlap", "Shared isolation uses this working directory", "worktree isolation captures a patch without merging it"} {
75 if !strings.Contains(task, want) {75 if !strings.Contains(task, want) {
76 t.Fatalf("task schema missing %q: %s", want, task)76 t.Fatalf("task schema missing %q: %s", want, task)
77 }77 }
M packages/agent/tools/subagent_spawn.go +1 -1
@@ -84,7 +84,7 @@ const subagentSpawnSchemaTemplate = `{
8484 "properties": {
8585 "task": {
8686 "type": "string",
87- "description": "The full task description for the sub-agent. Assign a concrete, bounded scope and explicit ownership that does not overlap other active work. Be specific: the child normally has the main agent's built-in tools, including lsp when enabled, but a selected profile can restrict its tools; it shares this working directory and starts with NO context from this conversation."
87+ "description": "The full task description for the sub-agent. Assign a concrete, bounded scope and explicit ownership that does not overlap other active work. Be specific: the child normally has the main agent's built-in tools, including lsp when enabled, but a selected profile can restrict its tools; it starts with NO context from this conversation. Shared isolation uses this working directory; worktree isolation captures a patch without merging it."
8888 },
8989 "agent": {
9090 "type": "string",
@@ -84,7 +84,7 @@ const subagentSpawnSchemaTemplate = `{
84 "properties": {84 "properties": {
85 "task": {85 "task": {
86 "type": "string",86 "type": "string",
87- "description": "The full task description for the sub-agent. Assign a concrete, bounded scope and explicit ownership that does not overlap other active work. Be specific: the child normally has the main agent's built-in tools, including lsp when enabled, but a selected profile can restrict its tools; it shares this working directory and starts with NO context from this conversation."87+ "description": "The full task description for the sub-agent. Assign a concrete, bounded scope and explicit ownership that does not overlap other active work. Be specific: the child normally has the main agent's built-in tools, including lsp when enabled, but a selected profile can restrict its tools; it starts with NO context from this conversation. Shared isolation uses this working directory; worktree isolation captures a patch without merging it."
88 },88 },
89 "agent": {89 "agent": {
90 "type": "string",90 "type": "string",

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 1

Tags 476

↑↓ moveenter openesc close