docs: add agent configuration

2026-03-19 15:35:06 +08:00
parent 1dcd138763
commit 12642e0a92
1 changed files with 33 additions and 0 deletions
@@ -0,0 +1,33 @@
+# AGENTS
+
+This repository allows sub-agent delegation for parallel implementation work.
+
+## Default Sub-Agent Configuration
+
+When spawning sub-agents for this repo:
+
+- model: `gpt-5.4`
+- reasoning effort: `xhigh`
+
+## Context Strategy
+
+Sub-agents should use this context policy:
+
+1. First attempt with `fork_context: true`
+2. If the sub-agent fails due to context-window pressure, retry with `fork_context: false`
+3. When retrying with `fork_context: false`, provide a compact task brief and explicitly list the local files the sub-agent must read first
+
+## Practical Guidance
+
+- Prefer fewer, higher-quality sub-agents over many shallow ones
+- Give each sub-agent a clearly isolated write scope
+- Keep shared integration files owned by the main thread whenever possible
+- If a sub-agent needs a shared dependency or a shared export change, have it report that back rather than editing unrelated files
+
+## Priority
+
+If there is any conflict between older default delegation habits and this file:
+
+- follow this file for sub-agent model selection
+- follow this file for sub-agent reasoning effort
+- follow this file for context fallback behavior