docs: complete factual audit pass 2 — 90+ corrections
Second 10-agent parallel audit covering all remaining sections:
ultimate-guide.md (ch1-ch11), workflows/ (17 files), quiz/ (12 files),
examples/agents+skills+commands. Source of truth: official Anthropic docs.
Key corrections:
Hook system (+8 missing events):
- Complete 17-event list: PermissionRequest, PostToolUseFailure, SubagentStart,
TeammateIdle, TaskCompleted, WorktreeCreate, WorktreeRemove, SessionEnd
- SessionStart confirmed valid (previous audit wrongly doubted it)
- Hook output format: hookSpecificOutput.permissionDecision (not {"decision":"block"})
- Missing common input fields added: transcript_path, cwd, permission_mode
Agent YAML frontmatter (13 valid fields restored/added):
- Restored: disallowedTools, memory, background, isolation, skills, permissionMode, hooks
- Added new: maxTurns, mcpServers
- Fixed: tools format is comma-separated (not space-separated)
Plan Mode (12 occurrences fixed):
- Ctrl+G = "open plan in text editor" (NOT "enter plan mode")
- Plan Mode = Shift+Tab × 2 (Normal → acceptEdits → plan)
Commands table (10.1) + built-in commands (6.1):
- Added 18+ missing commands: /copy, /doctor, /hooks, /memory, /model,
/config, /permissions, /remote-control, /rename, /resume, /sandbox, etc.
Workflow files:
- agent-teams.md: removed fake --experimental-agent-teams flag
- hooks.yaml + post_edit event → settings.json + PostToolUse (2 files)
- TodoWrite → TaskCreate/TaskUpdate (3 files)
- task-management.md: removed fake "failed" task status
Quiz / examples:
- 01-010: Esc stops mid-action (not Ctrl+C)
- refactoring-specialist.md: removed MultiEdit (not a valid tool)
- ast-grep-patterns.md: name field (not title)
- validate-changes.md, diagnose.md: field name fixes
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
8cb9f9efa6
commit
4a0a0bf30e
22 changed files with 365 additions and 322 deletions
|
|
@ -214,17 +214,18 @@ Team Lead: "Review this PR for security issues"
|
|||
### Navigation Between Agents
|
||||
|
||||
**Built-in navigation**:
|
||||
- **Shift+Up/Down**: Switch between sub-agents in Claude Code interface
|
||||
- **tmux**: Use tmux commands if running in tmux session
|
||||
- **Shift+Down**: Cycle through teammates in in-process mode
|
||||
- **tmux/iTerm2**: Split pane mode with `teammateMode: "tmux"` (requires tmux or iTerm2 with `it2` CLI)
|
||||
- **Direct takeover**: You can take control of any agent's work when needed
|
||||
|
||||
**Example**:
|
||||
```bash
|
||||
# Terminal 1: Team lead
|
||||
claude --experimental-agent-teams
|
||||
# Terminal 1: Team lead (with env var set)
|
||||
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
|
||||
claude
|
||||
|
||||
# Claude spawns teammates automatically
|
||||
# You can navigate with Shift+Up/Down to inspect each agent
|
||||
# You can navigate with Shift+Down to cycle through teammates (in-process mode)
|
||||
```
|
||||
|
||||
### Context Management
|
||||
|
|
@ -286,8 +287,8 @@ source ~/.bashrc
|
|||
|
||||
```json
|
||||
{
|
||||
"experimental": {
|
||||
"agentTeams": true
|
||||
"env": {
|
||||
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
|
@ -311,9 +312,10 @@ source ~/.bashrc
|
|||
Claude should confirm:
|
||||
> "Yes, agent teams are enabled (experimental feature). I can spawn multiple agents to work in parallel when appropriate."
|
||||
|
||||
**Alternative verification** (check settings):
|
||||
**Alternative verification** (check env var):
|
||||
```bash
|
||||
cat ~/.claude/settings.json | grep agentTeams
|
||||
echo $CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS
|
||||
# Should output: 1
|
||||
```
|
||||
|
||||
### Multi-Terminal Setup
|
||||
|
|
@ -323,15 +325,15 @@ cat ~/.claude/settings.json | grep agentTeams
|
|||
```bash
|
||||
# Terminal 1: Research + bugfix
|
||||
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
|
||||
claude --session research-bugfix
|
||||
claude
|
||||
|
||||
# Terminal 2: Business ops
|
||||
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
|
||||
claude --session business-ops
|
||||
claude
|
||||
|
||||
# Terminal 3: Infrastructure
|
||||
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
|
||||
claude --session infra-setup
|
||||
claude
|
||||
```
|
||||
|
||||
**Benefits**:
|
||||
|
|
@ -772,7 +774,7 @@ With messaging (built-in):
|
|||
Mitigation:
|
||||
- Agents can message each other via mailbox system
|
||||
- Team lead synthesizes findings after all agents complete
|
||||
- Human can interrupt and redirect agents mid-workflow (Shift+Up/Down)
|
||||
- Human can interrupt and redirect agents mid-workflow (Shift+Down to cycle teammates)
|
||||
- Design tasks with minimal inter-agent dependencies
|
||||
```
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue