docs/agent-corrections.md

# Corrections given to agents

Keep this file minimal. Include a correction only when both apply:

- It was given to an agent after the agent took an incorrect path.
- Another agent is likely to take that path again unless the correction is documented.

Write rules only; omit incident histories and anecdotes.

## Terminology

- Use “snapshot” for a point-in-time capture of code and conversation context; “revision” implies source control and changes the meaning.

## Forks

- Treat missing Antigravity conversation forks as a bug to fix; do not narrow the website's fork promises to Claude Code and Codex.

## Performance

- Keep the app preloading the transcript of every active, visible task when it loads the task list, so opening a task is instant; never trade that away to save downloads or memory.

## Security

- Accept other local OS accounts reaching preview forwards and Chrome’s loopback debugger on personal Macs; do not add authentication or account-isolating brokers for that threat.
- Let the app show any server file an agent can read; do not confine the file, raw, image or directory endpoints, or agent tools that show or copy files, to the task's worktree.
-											Audit of 4f88f8a
										
										
											2026-10-21 07:21:49 -07:00
+								# Corrections given to agents
 								Keep this file minimal. Include a correction only when both apply:
 								- It was given to an agent after the agent took an incorrect path.
 								- Another agent is likely to take that path again unless the correction is documented.
 								Write rules only; omit incident histories and anecdotes.
 								## Terminology
 								- Use “snapshot” for a point-in-time capture of code and conversation context; “revision” implies source control and changes the meaning.
-											Restore Chrome loopback debugging and document accepted local risks
										
										
											2026-10-21 08:44:03 -07:00
-											Trim redundant logging docs and record fork guidance
										
										
											2026-10-21 14:31:24 -07:00
+								## Forks
 								- Treat missing Antigravity conversation forks as a bug to fix; do not narrow the website's fork promises to Claude Code and Codex.
-											Preload transcripts of active visible tasks again
										
										
											2026-10-21 11:13:24 -07:00
+								## Performance
 								- Keep the app preloading the transcript of every active, visible task when it loads the task list, so opening a task is instant; never trade that away to save downloads or memory.
-											Restore Chrome loopback debugging and document accepted local risks
										
										
											2026-10-21 08:44:03 -07:00
+								## Security
 								- Accept other local OS accounts reaching preview forwards and Chrome’s loopback debugger on personal Macs; do not add authentication or account-isolating brokers for that threat.
-											Add show_page and show_file, and let file tools reach any path
										
										
											2026-10-21 18:29:01 -07:00
+								- Let the app show any server file an agent can read; do not confine the file, raw, image or directory endpoints, or agent tools that show or copy files, to the task's worktree.