Domain 1

Agentic Architecture

Learning Progress 0%
TS 1.1

Design and implement agentic loops for autonomous task execution

Knowledge
  • Loop lifecycle: send request → inspect stop_reason → execute tools → return results for next iteration
  • "tool_use" means continue; "end_turn" means terminate
  • Tool results are appended to conversation history so the model reasons about its next action
  • Model-driven decision-making vs pre-configured decision trees
Skills
  • Implement loop control: continue on "tool_use" , terminate on "end_turn"
  • Append tool results to conversation context between iterations
  • Avoid anti-patterns: parsing natural language for termination, using only iteration caps, checking assistant text as a completion indicator
TS 1.2

Orchestrate multi-agent systems with coordinator-subagent patterns

Knowledge
  • Hub-and-spoke: coordinator manages all inter-subagent communication, error handling, information routing
  • Subagents have isolated context — they do NOT automatically inherit coordinator's conversation history
  • Coordinator role: task decomposition, delegation, result aggregation, selecting which subagents to invoke
  • Risk: overly narrow decomposition leads to incomplete coverage of broad research topics
Skills
  • Design coordinators that dynamically select subagents based on query complexity
  • Partition research scope across subagents to minimize duplication
  • Implement iterative refinement loops: coordinator evaluates output → re-delegates → re-synthesizes
  • Route all subagent communication through coordinator for observability
TS 1.3

Configure subagent invocation, context passing, and spawning

Knowledge
  • Task tool is the mechanism for spawning subagents; allowedTools must include "Task"
  • Subagent context must be explicitly provided — no automatic inheritance or shared memory
  • AgentDefinition config: descriptions, system prompts, tool restrictions per subagent type
  • Fork-based session management for exploring divergent approaches from a shared baseline
Skills
  • Include complete prior findings directly in the subagent's prompt (pass web search results, document analysis outputs)
  • Use structured data formats to separate content from metadata when passing context
  • Spawn parallel subagents by emitting multiple Task calls in a single coordinator response
  • Design coordinator prompts that specify research goals rather than step-by-step procedural instructions
TS 1.4

Implement multi-step workflows with enforcement and handoff patterns

Knowledge
  • Programmatic enforcement (hooks, prerequisite gates) vs prompt-based guidance — prompt instructions have non-zero failure rate
  • Deterministic compliance required (e.g., identity verification before financial operations) → must use programmatic enforcement
  • Structured handoff protocols for mid-process escalation: customer details, root cause, recommended actions
Skills
  • Implement programmatic prerequisites that block downstream tool calls (e.g., block process_refund until get_customer returns a verified ID)
  • Decompose multi-concern requests into distinct items, investigate in parallel, then synthesize a unified response
  • Compile structured handoff summaries when escalating to human agents who lack conversation access
TS 1.5

Apply Agent SDK hooks for tool call interception and data normalization

Knowledge
  • PostToolUse hooks intercept tool results for transformation before the model processes them
  • Hook patterns intercept outgoing tool calls to enforce compliance (e.g., blocking refunds above a threshold)
  • Hooks = deterministic guarantees; prompt instructions = probabilistic compliance
Skills
  • Implement PostToolUse hooks to normalize heterogeneous data formats (Unix timestamps → ISO 8601)
  • Implement tool call interception hooks that block policy-violating actions and redirect to alternative workflows
  • Choose hooks over prompt-based enforcement when business rules require guaranteed compliance
TS 1.6

Design task decomposition strategies for complex workflows

Knowledge
  • Fixed sequential pipelines (prompt chaining) vs dynamic adaptive decomposition based on intermediate findings
  • Prompt chaining pattern: analyze each file individually → then run a cross-file integration pass
  • Adaptive investigation plans generate subtasks based on what is discovered at each step
Skills
  • Select prompt chaining for predictable multi-aspect reviews; dynamic decomposition for open-ended investigation tasks
  • Split large code reviews into per-file local analysis passes + separate cross-file integration pass
  • Decompose open-ended tasks by first mapping structure, identifying high-impact areas, then creating a prioritized adaptive plan
TS 1.7

Manage session state, resumption, and forking

Knowledge
  • Named session resumption using --resume <session-name> to continue a specific prior conversation
  • fork_session for creating independent branches from a shared analysis baseline
  • Must inform agent about changed files when resuming after code modifications
  • Starting fresh with structured summary is more reliable than resuming with stale tool results
Skills
  • Use --resume with session names to continue named investigation sessions across work sessions
  • Use fork_session to create parallel exploration branches
  • Choose session resumption when prior context is mostly valid; start fresh with injected summaries when tool results are stale
  • Inform resumed session about specific file changes for targeted re-analysis