Add configurable worktree target path and session run diagnostics

README.md

@@ -25,6 +25,12 @@ TypeScript runtime for deterministic multi-agent execution with:
   - `artifactPointers`
   - `taskQueue`
 
+## Deep Dives
+
+- Session walkthrough with concrete artifacts from a successful provider run: `docs/session-walkthrough.md`
+- Orchestration engine internals: `docs/orchestration-engine.md`
+- Runtime event model and sinks: `docs/runtime-events.md`
+
 ## Repository Layout
 
 - `src/agents`
@@ -97,6 +103,7 @@ Provider mode notes:
 
 - `provider=codex` uses existing OpenAI/Codex auth settings (`OPENAI_AUTH_MODE`, `CODEX_API_KEY`, `OPENAI_API_KEY`).
 - `provider=claude` uses Claude auth resolution (`CLAUDE_CODE_OAUTH_TOKEN` preferred, otherwise `ANTHROPIC_API_KEY`, or existing Claude Code login state).
+- `CLAUDE_MODEL` should be a Claude model id/alias recognized by Claude Code (for example `claude-sonnet-4-6`); `anthropic/...` prefixes are normalized automatically.
 
 ## Manifest Semantics
 
@@ -267,6 +274,7 @@ jq -c 'select(.severity=="critical")' .ai_ops/events/runtime-events.ndjson
 
 - `AGENT_WORKTREE_ROOT`
 - `AGENT_WORKTREE_BASE_REF`
+- `AGENT_WORKTREE_TARGET_PATH` (optional relative path; enables sparse checkout and sets session working directory to that subfolder)
 - `AGENT_PORT_BASE`
 - `AGENT_PORT_BLOCK_SIZE`
 - `AGENT_PORT_BLOCK_COUNT`