# loknathbaskar/cca-f-study-guide architecture

> Architecture diagram of the GitHub repository loknathbaskar/cca-f-study-guide, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/loknathbaskar/cca-f-study-guide
- Repository: https://github.com/loknathbaskar/cca-f-study-guide

## Overview

This repository is a hands-on CCA-F study guide, not one integrated application. Its principal workflow is an engineer running a self-contained exercise to observe a Claude architecture or reliability technique; most exercises can use mock mode or the Claude API. The graph preserves the five exam domains and major exercise branches. The source index shows the multi-agent coordinator calling subagents and several prompt exercises using a shared backend. Other exercise links are omitted where the excerpts do not show their runtime relationships.

Main entry points: [`domain-3-prompt-engineering/exercise-2-few_shot/backend.py`](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-2-few_shot/backend.py) (Few-shot backend), [`domain-3-prompt-engineering/exercise-2-few_shot/step2_few_shot.py`](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-2-few_shot/step2_few_shot.py) (Few-shot prompting), [`domain-3-prompt-engineering/exercise-5-validation_retry/step5_validation_retry.py`](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-5-validation_retry/step5_validation_retry.py) (Validation retry), [`domain-3-prompt-engineering/exercise-7-multipass-review/exercise7.1_multipass_review.py`](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-7-multipass-review/exercise7.1_multipass_review.py) (Multi-pass review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agentic["Agent orchestration"]
  node_research["Research backend<br/>[backend.py]"]
  node_coordinator["Research coordinator<br/>[coordinator.py]"]
  node_subagents["Research subagents<br/>[subagents.py]"]
  node_parallel["Parallel orchestration"]
  node_breaker["Circuit breaker"]
end

subgraph group_config["Claude Code config"]
  node_hierarchy["CLAUDE hierarchy<br/>[checkout.ts]"]
  node_hooks["Subagents and hooks<br/>[checkout.ts]"]
end

subgraph group_prompts["Prompt engineering"]
  node_extract["Structured extraction<br/>[backend.py]"]
  node_fewshot["Few-shot backend<br/>[backend.py]"]
  node_fewstep["Few-shot prompting<br/>[step2_few_shot.py]"]
  node_schema["Schema tool use<br/>[backend.py]"]
  node_toolchoice["Tool choice<br/>[backend.py]"]
  node_validation["Validation retry"]
  node_batch["Batch API<br/>[step6_batch_api.py]"]
  node_reviewa["Multi-pass review"]
  node_reviewb["Multi-pass review variant"]
end

subgraph group_tools["Tool design and MCP"]
  node_routing["Tool description routing"]
  node_errors["Error handling"]
  node_distribution["Tool distribution"]
  node_mcpfund["MCP fundamentals<br/>[mcp_client_demo.py]"]
  node_multiserver["Multi-server MCP"]
  node_transport["HTTP transport"]
  node_security["MCP security"]
end

subgraph group_context["Context reliability"]
  node_compaction["Context compaction"]
  node_caching["Prompt caching"]
  node_scratchpad["Durable scratchpad"]
  node_nonobvious["Non-obvious rules"]
  node_escalation["Confidence escalation"]
end

node_learner(("Engineer"))

node_learner -->|"runs exercise"| node_research
node_learner -->|"runs exercise"| node_parallel
node_learner -->|"runs exercise"| node_breaker
node_learner -->|"runs exercise"| node_hierarchy
node_learner -->|"runs exercise"| node_hooks
node_learner -->|"runs exercise"| node_extract
node_learner -->|"runs exercise"| node_fewstep
node_learner -->|"runs exercise"| node_schema
node_learner -->|"runs exercise"| node_toolchoice
node_learner -->|"runs exercise"| node_validation
node_learner -->|"runs exercise"| node_batch
node_learner -->|"runs exercise"| node_reviewa
node_learner -->|"runs exercise"| node_reviewb
node_learner -->|"runs exercise"| node_routing
node_learner -->|"runs exercise"| node_errors
node_learner -->|"runs exercise"| node_distribution
node_learner -->|"runs exercise"| node_mcpfund
node_learner -->|"runs exercise"| node_multiserver
node_learner -->|"runs exercise"| node_transport
node_learner -->|"runs exercise"| node_security
node_learner -->|"runs exercise"| node_compaction
node_learner -->|"runs exercise"| node_caching
node_learner -->|"runs exercise"| node_scratchpad
node_learner -->|"runs exercise"| node_nonobvious
node_learner -->|"runs exercise"| node_escalation
node_coordinator -->|"delegates to"| node_subagents
node_fewstep -->|"calls backend"| node_fewshot
node_validation -->|"calls backend"| node_fewshot
node_reviewa -->|"calls backend"| node_fewshot
node_reviewb -->|"calls backend"| node_fewshot
node_routing -->|"calls backend"| node_fewshot
node_errors -->|"calls backend"| node_fewshot
node_distribution -->|"calls backend"| node_fewshot
node_compaction -->|"calls backend"| node_fewshot

click node_research "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-1-agentic-architecture/exercise-1-multi-agent-research/backend.py"
click node_coordinator "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-1-agentic-architecture/exercise-1-multi-agent-research/coordinator.py"
click node_subagents "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-1-agentic-architecture/exercise-1-multi-agent-research/subagents.py"
click node_parallel "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-1-agentic-architecture/exercise-2-parallel-orchestration/exercise2_parallel_orchestration.py"
click node_breaker "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-1-agentic-architecture/exercise-3-circuit-breaker/exercise3_circuit_breaker.py"
click node_hierarchy "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-2-claude-code-config/exercise-1-claude-md-hierarchy/acme-shop/api/src/routes/checkout.ts"
click node_hooks "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-2-claude-code-config/exercise-2-subagents-hooks/acme-shop/api/checkout.ts"
click node_extract "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-1-structured-extraction/backend.py"
click node_fewshot "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-2-few_shot/backend.py"
click node_fewstep "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-2-few_shot/step2_few_shot.py"
click node_schema "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-3-tool_use_jsonSchema/backend.py"
click node_toolchoice "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-4-tool_choice/backend.py"
click node_validation "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-5-validation_retry/step5_validation_retry.py"
click node_batch "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-6-batch_api/step6_batch_api.py"
click node_reviewa "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-7-multipass-review/exercise7.1_multipass_review.py"
click node_reviewb "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-7-multipass-review/exercise7_multipass_review.py"
click node_routing "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-1-tool-description-routing/exercise1_tool_description_routing.py"
click node_errors "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-2-error-handling-idempotency/exercise2_error_idempotency.py"
click node_distribution "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-3-tool-distribution/exercise3_tool_distribution.py"
click node_mcpfund "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-4-mcp-fundamentals/mcp_client_demo.py"
click node_multiserver "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-5-mcp-clients-multiserver/multi_server_client.py"
click node_transport "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-6-transports/http_client_demo.py"
click node_security "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-7-mcp-security/access_scoping_client.py"
click node_compaction "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-5-context-reliability/exercise-1-compaction-strategies/exercise1_compaction_strategies.py"
click node_caching "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-5-context-reliability/exercise-2-prompt-caching/exercise2_prompt_caching.py"
click node_scratchpad "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-5-context-reliability/exercise-3-durable-state-scratchpad/exercise3_durable_state.py"
click node_nonobvious "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-5-context-reliability/exercise-3-durable-state-scratchpad/exercise3b_nonobvious_rule.py"
click node_escalation "https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-5-context-reliability/exercise-4-escalation-confidence/exercise4_escalation_confidence.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_research,node_coordinator,node_subagents,node_parallel,node_breaker toneBlue
class node_hierarchy,node_hooks toneAmber
class node_extract,node_fewshot,node_fewstep,node_schema,node_toolchoice,node_validation,node_batch,node_reviewa,node_reviewb toneMint
class node_routing,node_errors,node_distribution,node_mcpfund,node_multiserver,node_transport,node_security toneRose
class node_compaction,node_caching,node_scratchpad,node_nonobvious,node_escalation,node_learner toneIndigo
```

## Components

### Agent orchestration

- [Research backend](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-1-agentic-architecture/exercise-1-multi-agent-research/backend.py): `domain-1-agentic-architecture/exercise-1-multi-agent-research/backend.py`
- [Research coordinator](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-1-agentic-architecture/exercise-1-multi-agent-research/coordinator.py): `domain-1-agentic-architecture/exercise-1-multi-agent-research/coordinator.py`
- [Research subagents](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-1-agentic-architecture/exercise-1-multi-agent-research/subagents.py): `domain-1-agentic-architecture/exercise-1-multi-agent-research/subagents.py`
- [Parallel orchestration](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-1-agentic-architecture/exercise-2-parallel-orchestration/exercise2_parallel_orchestration.py): `domain-1-agentic-architecture/exercise-2-parallel-orchestration/exercise2_parallel_orchestration.py`
- [Circuit breaker](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-1-agentic-architecture/exercise-3-circuit-breaker/exercise3_circuit_breaker.py): `domain-1-agentic-architecture/exercise-3-circuit-breaker/exercise3_circuit_breaker.py`

### Claude Code config

- [CLAUDE hierarchy](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-2-claude-code-config/exercise-1-claude-md-hierarchy/acme-shop/api/src/routes/checkout.ts): `domain-2-claude-code-config/exercise-1-claude-md-hierarchy/acme-shop/api/src/routes/checkout.ts`
- [Subagents and hooks](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-2-claude-code-config/exercise-2-subagents-hooks/acme-shop/api/checkout.ts): `domain-2-claude-code-config/exercise-2-subagents-hooks/acme-shop/api/checkout.ts`

### Prompt engineering

- [Structured extraction](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-1-structured-extraction/backend.py): `domain-3-prompt-engineering/exercise-1-structured-extraction/backend.py`
- [Few-shot backend](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-2-few_shot/backend.py): `domain-3-prompt-engineering/exercise-2-few_shot/backend.py`
- [Few-shot prompting](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-2-few_shot/step2_few_shot.py): `domain-3-prompt-engineering/exercise-2-few_shot/step2_few_shot.py`
- [Schema tool use](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-3-tool_use_jsonSchema/backend.py): `domain-3-prompt-engineering/exercise-3-tool_use_jsonSchema/backend.py`
- [Tool choice](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-4-tool_choice/backend.py): `domain-3-prompt-engineering/exercise-4-tool_choice/backend.py`
- [Validation retry](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-5-validation_retry/step5_validation_retry.py): `domain-3-prompt-engineering/exercise-5-validation_retry/step5_validation_retry.py`
- [Batch API](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-6-batch_api/step6_batch_api.py): `domain-3-prompt-engineering/exercise-6-batch_api/step6_batch_api.py`
- [Multi-pass review](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-7-multipass-review/exercise7.1_multipass_review.py): `domain-3-prompt-engineering/exercise-7-multipass-review/exercise7.1_multipass_review.py`
- [Multi-pass review variant](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-3-prompt-engineering/exercise-7-multipass-review/exercise7_multipass_review.py): `domain-3-prompt-engineering/exercise-7-multipass-review/exercise7_multipass_review.py`

### Tool design and MCP

- [Tool description routing](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-1-tool-description-routing/exercise1_tool_description_routing.py): `domain-4-tool-design-mcp/exercise-1-tool-description-routing/exercise1_tool_description_routing.py`
- [Error handling](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-2-error-handling-idempotency/exercise2_error_idempotency.py): `domain-4-tool-design-mcp/exercise-2-error-handling-idempotency/exercise2_error_idempotency.py`
- [Tool distribution](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-3-tool-distribution/exercise3_tool_distribution.py): `domain-4-tool-design-mcp/exercise-3-tool-distribution/exercise3_tool_distribution.py`
- [MCP fundamentals](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-4-mcp-fundamentals/mcp_client_demo.py): `domain-4-tool-design-mcp/exercise-4-mcp-fundamentals/mcp_client_demo.py`
- [Multi-server MCP](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-5-mcp-clients-multiserver/multi_server_client.py): `domain-4-tool-design-mcp/exercise-5-mcp-clients-multiserver/multi_server_client.py`
- [HTTP transport](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-6-transports/http_client_demo.py): `domain-4-tool-design-mcp/exercise-6-transports/http_client_demo.py`
- [MCP security](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-4-tool-design-mcp/exercise-7-mcp-security/access_scoping_client.py): `domain-4-tool-design-mcp/exercise-7-mcp-security/access_scoping_client.py`

### Context reliability

- [Context compaction](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-5-context-reliability/exercise-1-compaction-strategies/exercise1_compaction_strategies.py): `domain-5-context-reliability/exercise-1-compaction-strategies/exercise1_compaction_strategies.py`
- [Prompt caching](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-5-context-reliability/exercise-2-prompt-caching/exercise2_prompt_caching.py): `domain-5-context-reliability/exercise-2-prompt-caching/exercise2_prompt_caching.py`
- [Durable scratchpad](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-5-context-reliability/exercise-3-durable-state-scratchpad/exercise3_durable_state.py): `domain-5-context-reliability/exercise-3-durable-state-scratchpad/exercise3_durable_state.py`
- [Non-obvious rules](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-5-context-reliability/exercise-3-durable-state-scratchpad/exercise3b_nonobvious_rule.py): `domain-5-context-reliability/exercise-3-durable-state-scratchpad/exercise3b_nonobvious_rule.py`
- [Confidence escalation](https://github.com/loknathbaskar/cca-f-study-guide/blob/main/domain-5-context-reliability/exercise-4-escalation-confidence/exercise4_escalation_confidence.py): `domain-5-context-reliability/exercise-4-escalation-confidence/exercise4_escalation_confidence.py`

### Other components

- **Engineer**

## Connections

- Engineer → Research backend: runs exercise (evidence: `README.md`)
- Engineer → Parallel orchestration: runs exercise (evidence: `README.md`)
- Engineer → Circuit breaker: runs exercise (evidence: `README.md`)
- Engineer → CLAUDE hierarchy: runs exercise (evidence: `README.md`)
- Engineer → Subagents and hooks: runs exercise (evidence: `README.md`)
- Engineer → Structured extraction: runs exercise (evidence: `README.md`)
- Engineer → Few-shot prompting: runs exercise (evidence: `README.md`)
- Engineer → Schema tool use: runs exercise (evidence: `README.md`)
- Engineer → Tool choice: runs exercise (evidence: `README.md`)
- Engineer → Validation retry: runs exercise (evidence: `README.md`)
- Engineer → Batch API: runs exercise (evidence: `README.md`)
- Engineer → Multi-pass review: runs exercise (evidence: `README.md`)
- Engineer → Multi-pass review variant: runs exercise (evidence: `README.md`)
- Engineer → Tool description routing: runs exercise (evidence: `README.md`)
- Engineer → Error handling: runs exercise (evidence: `README.md`)
- Engineer → Tool distribution: runs exercise (evidence: `README.md`)
- Engineer → MCP fundamentals: runs exercise (evidence: `README.md`)
- Engineer → Multi-server MCP: runs exercise (evidence: `README.md`)
- Engineer → HTTP transport: runs exercise (evidence: `README.md`)
- Engineer → MCP security: runs exercise (evidence: `README.md`)
- Engineer → Context compaction: runs exercise (evidence: `README.md`)
- Engineer → Prompt caching: runs exercise (evidence: `README.md`)
- Engineer → Durable scratchpad: runs exercise (evidence: `README.md`)
- Engineer → Non-obvious rules: runs exercise (evidence: `README.md`)
- Engineer → Confidence escalation: runs exercise (evidence: `README.md`)
- Research coordinator → Research subagents: delegates to (evidence: `domain-1-agentic-architecture/exercise-1-multi-agent-research/coordinator.py`)
- Few-shot prompting → Few-shot backend: calls backend (evidence: `domain-3-prompt-engineering/exercise-2-few_shot/step2_few_shot.py`)
- Validation retry → Few-shot backend: calls backend (evidence: `domain-3-prompt-engineering/exercise-5-validation_retry/step5_validation_retry.py`)
- Multi-pass review → Few-shot backend: calls backend (evidence: `domain-3-prompt-engineering/exercise-7-multipass-review/exercise7.1_multipass_review.py`)
- Multi-pass review variant → Few-shot backend: calls backend (evidence: `domain-3-prompt-engineering/exercise-7-multipass-review/exercise7_multipass_review.py`)
- Tool description routing → Few-shot backend: calls backend (evidence: `domain-4-tool-design-mcp/exercise-1-tool-description-routing/exercise1_tool_description_routing.py`)
- Error handling → Few-shot backend: calls backend (evidence: `domain-4-tool-design-mcp/exercise-2-error-handling-idempotency/exercise2_error_idempotency.py`)
- Tool distribution → Few-shot backend: calls backend (evidence: `domain-4-tool-design-mcp/exercise-3-tool-distribution/exercise3_tool_distribution.py`)
- Context compaction → Few-shot backend: calls backend (evidence: `domain-5-context-reliability/exercise-1-compaction-strategies/exercise1_compaction_strategies.py`)
