# shareAI-lab/learn-claude-code

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/shareai-lab-learn-claude-code).**

17,258 stars · 3,652 forks · Python · mit

## Links

- GitHub: https://github.com/shareAI-lab/learn-claude-code
- Homepage: https://learn-claude-agents.vercel.app/en/
- awesome-repositories: https://awesome-repositories.com/repository/shareai-lab-learn-claude-code.md

## Topics

`agent` `agent-development` `ai-agent` `claude` `claude-code` `educational` `llm` `python` `teaching` `tutorial`

## Description

This project provides a modular framework for building and orchestrating autonomous AI agents. It functions as an agentic workflow engine that manages the full lifecycle of task execution, including model reasoning, tool invocation, and the integration of results. By utilizing a centralized orchestration platform, the system enables the creation of multi-agent teams that collaborate on complex objectives through structured communication and shared task graphs.

The framework distinguishes itself through its focus on persistent, stateful operations and multi-agent coordination. It employs file-based message queuing and atomic task locking to ensure that agents can operate in parallel without resource conflicts or duplicate task firing. Each agent functions within an isolated workspace, and the system maintains long-term memory by persisting facts and preferences across sessions, allowing for consistent behavior in long-running tasks.

The platform includes comprehensive capabilities for managing agent intelligence and environment interaction. It features dynamic prompt assembly, context-aware memory management, and a robust tool integration layer that allows agents to interface with external services and local files securely. The system also incorporates advanced planning and error recovery mechanisms, such as automated retries, model fallbacks, and dependency-aware task scheduling, to maintain reliability during autonomous operations.

The repository is implemented in Python and includes command-line utilities for managing agent lifecycles, monitoring workspace isolation, and auditing execution events.

## Tags

### Artificial Intelligence & ML

- [Autonomous Agent Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/autonomous-agent-frameworks.md) — Provides a modular framework for building and orchestrating autonomous agents with task planning and tool execution.
- [Agentic Loops](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/ai-agents/execution-runtimes/agentic-loops.md) — Orchestrates continuous cycles of model reasoning, tool invocation, and result integration to perform autonomous tasks. ([source](https://learn-claude-agents.vercel.app/en/))
- [Multi-Agent Orchestration Platforms](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-orchestration-multi-agent/coordination-and-routing/multi-agent-orchestration-platforms.md) — Coordinates teams of specialized autonomous agents using shared task graphs and message queues.
- [Agent Workspace Environments](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/infrastructure-runtime-environments/agent-workspace-environments.md) — Provides separate filesystem directories for parallel agents to prevent file conflicts and resource interference. ([source](https://learn-claude-agents.vercel.app/en/layers/))
- [Agentic Workflow Engines](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-workflow-engines.md) — Executes iterative loops of model reasoning, tool invocation, and result integration for multi-step objectives.
- [Autonomous Agent Orchestration](https://awesome-repositories.com/f/artificial-intelligence-ml/autonomous-agent-orchestration.md) — Orchestrates autonomous agents with persistent memory to execute complex, multi-step workflows.
- [Agent Memory Stores](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-memory-stores.md) — Persists critical facts, user preferences, and project context across sessions to maintain long-term memory. ([source](https://learn-claude-agents.vercel.app/en/layers/))
- [Agent Memory Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-memory-systems.md) — Maintains persistent long-term knowledge and conversation history for consistent agent behavior.
- [Agentic Context Management](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-context-management.md) — Manages long-term memory, conversation history, and context scoping for autonomous agent workflows.
- [Agentic Process Managers](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-process-managers.md) — Automates the creation, monitoring, and graceful shutdown of background agent processes to ensure persistent execution. ([source](https://learn-claude-agents.vercel.app/en/s15/))
- [AI Agent Tool Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-agent-integrations/ai-agent-tool-integrations.md) — Connects AI models to external software, local files, and APIs for functional task execution.
- [Prompt Assembly Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/prompt-assembly-systems.md) — Constructs system instructions at runtime by aggregating modular context and workspace state to optimize token usage.
- [Multi-Agent Coordination Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/orchestration-engines/ai-agent/multi-agent-coordination-systems.md) — Enables specialized subagents to collaborate on complex tasks through delegated sub-processes and shared state.
- [Agent Collaboration Protocols](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-collaboration-protocols.md) — Orchestrates collaborative multi-agent teams using defined communication protocols and task claiming mechanisms. ([source](https://learn-claude-agents.vercel.app/en/))
- [Worktree Isolation](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agentic-workflows/worktree-isolation.md) — Provides isolated filesystem workspaces for parallel agent tasks using version control worktrees. ([source](https://learn-claude-agents.vercel.app/en/s18/))
- [Agent Tool Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/tool-use-and-execution/agent-tool-integrations.md) — Provides a middleware layer for registering and dispatching external services as executable agent tools.
- [Agentic Task Automation](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-task-automation.md) — Uses atomic file-level locking and dependency validation to prevent race conditions and ensure exclusive task ownership. ([source](https://learn-claude-agents.vercel.app/en/s17/))
- [Agentic Task Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-task-orchestrators.md) — Decomposes complex goals into ordered, observable sequences of work to improve execution reliability. ([source](https://learn-claude-agents.vercel.app/en/))
- [Context-Aware Retrieval](https://awesome-repositories.com/f/artificial-intelligence-ml/context-aware-retrieval.md) — Selects and injects relevant stored information into active conversations to optimize token usage. ([source](https://learn-claude-agents.vercel.app/en/s09/))
- [Task Planning Systems](https://awesome-repositories.com/f/artificial-intelligence-ml/task-planning-systems.md) — Maintains persistent, dependency-aware task graphs to support complex multi-agent collaboration. ([source](https://learn-claude-agents.vercel.app/en/s20/))
- [Agent Tooling Extensions](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/tooling-integration-interfaces/agent-tooling-extensions.md) — Registers new tools into a central dispatch table to expand agent capabilities without modifying core logic. ([source](https://learn-claude-agents.vercel.app/en/layers/))
- [Agent-to-Agent Communication](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-communication-protocols/agent-to-agent-communication.md) — Uses file-based inboxes to decouple agent memory, allowing teammates to operate independently while reporting results. ([source](https://learn-claude-agents.vercel.app/en/s15/))
- [Agent System Prompts](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-capabilities-skills-tooling/agent-system-prompts.md) — Constructs dynamic system instructions at runtime by aggregating identity, workspace state, and tool definitions. ([source](https://learn-claude-agents.vercel.app/en/s20/))
- [Subagent Architectures](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-orchestration-multi-agent/subagent-design/subagent-architectures.md) — Spawns specialized subagents with isolated message histories to handle complex tasks without cluttering the main execution thread. ([source](https://learn-claude-agents.vercel.app/en/timeline/))
- [External Tool Integration](https://awesome-repositories.com/f/artificial-intelligence-ml/external-tool-integration.md) — Exposes external services as executable functions that agents can trigger on demand. ([source](https://learn-claude-agents.vercel.app/en/s19/))
- [Input Validation Schemas](https://awesome-repositories.com/f/artificial-intelligence-ml/input-validation-schemas.md) — Enforces structural integrity and safety constraints on tool parameters using schema-based validation before execution. ([source](https://learn-claude-agents.vercel.app/en/s02/))
- [User Preference Management](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/ai-agents/user-preference-management.md) — Analyzes conversation history to identify and save new information as user preferences automatically. ([source](https://learn-claude-agents.vercel.app/en/s09/))
- [Agent Skill Registries](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-skill-registries.md) — Parses directory metadata into a searchable registry at startup to inform agents of available capabilities efficiently. ([source](https://learn-claude-agents.vercel.app/en/s07/))
- [Execution Hooks](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/agent-runtimes/execution-hooks.md) — Executes custom logic at specific points in the agent execution cycle to maintain separation of concerns. ([source](https://learn-claude-agents.vercel.app/en/))
- [Context Management Tools](https://awesome-repositories.com/f/artificial-intelligence-ml/context-management-tools.md) — Compacts message history and summarizes interactions to prevent context overflow in long-running sessions. ([source](https://learn-claude-agents.vercel.app/en/s11/))
- [Conversation History Condensation](https://awesome-repositories.com/f/artificial-intelligence-ml/language-model-orchestration/conversation-management/conversation-history-condensation.md) — Condenses long interaction logs into summaries to reset context windows during extended sessions. ([source](https://learn-claude-agents.vercel.app/en/s08/))
- [Recurring Agent Scheduling](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/orchestration-engines/ai-agent/runtime-execution-control/recurring-agent-scheduling.md) — Executes automated jobs on a fixed timetable using standard cron expressions for persistent or temporary agent sessions. ([source](https://learn-claude-agents.vercel.app/en/s20/))
- [Agent Memory Maintenance](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-memory-maintenance.md) — Maintains consistent agent behavior by re-injecting system instructions and context after message compression. ([source](https://learn-claude-agents.vercel.app/en/s17/))
- [Agent Skill Configurations](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-skill-configurations.md) — Defines skill behavior through metadata fields controlling tool access, model selection, and user permissions. ([source](https://learn-claude-agents.vercel.app/en/s07/))
- [Agentic Orchestration Loops](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-orchestration-loops.md) — Detects and halts recursive error cycles to prevent infinite loops during autonomous task execution. ([source](https://learn-claude-agents.vercel.app/en/s04/))
- [Message Protocols](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/agent-orchestrators/message-protocols.md) — Processes incoming messages through a unified pipeline to update protocol state and inject content into agent history. ([source](https://learn-claude-agents.vercel.app/en/s16/))
- [Agent Prompt Templates](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/integration-deployment/agent-frameworks/configuration-and-specifications/agent-prompt-templates.md) — Modifies system prompt structures to support specialized operational modes like agentic or coordinator styles. ([source](https://learn-claude-agents.vercel.app/en/s10/))
- [External Service Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/external-service-integrations.md) — Connects third-party services and data sources to the agent environment using standardized protocols. ([source](https://learn-claude-agents.vercel.app/en/))
- [Model Switching Interfaces](https://awesome-repositories.com/f/artificial-intelligence-ml/model-switching-interfaces.md) — Automatically routes requests to alternative models when primary services experience persistent errors. ([source](https://learn-claude-agents.vercel.app/en/s11/))
- [Prompt Caching](https://awesome-repositories.com/f/artificial-intelligence-ml/prompt-caching.md) — Caches serialized prompt assemblies to prevent redundant re-computation across consecutive requests. ([source](https://learn-claude-agents.vercel.app/en/s10/))
- [Prefix Caching](https://awesome-repositories.com/f/artificial-intelligence-ml/prompt-caching/prefix-caching.md) — Ensures efficient model interaction by reusing common prompt prefixes across multiple agent requests to reduce latency and computational overhead. ([source](https://learn-claude-agents.vercel.app/en/s06/))

### Data & Databases

- [Atomic Task Locks](https://awesome-repositories.com/f/data-databases/caching-and-locking/atomic-task-locks.md) — Prevents race conditions and duplicate task firing using file-level locks and dependency validation.
- [Execution Collision Preventers](https://awesome-repositories.com/f/data-databases/duplicate-detection-tools/atomic-duplicate-prevention/execution-collision-preventers.md) — Prevents duplicate task firing and mitigates thundering herd issues using file-based locking and jitter algorithms. ([source](https://learn-claude-agents.vercel.app/en/s14/))

### Security & Cryptography

- [Permission Management](https://awesome-repositories.com/f/security-cryptography/permission-management.md) — Intercepts and validates sensitive tool actions to ensure safe interaction with the host environment. ([source](https://learn-claude-agents.vercel.app/en/))
- [Subagent Permission Management](https://awesome-repositories.com/f/security-cryptography/subagent-permission-management.md) — Centralizes control by routing subagent permission requests to the main terminal for user verification. ([source](https://learn-claude-agents.vercel.app/en/s06/))
- [Agent Security Runtimes](https://awesome-repositories.com/f/security-cryptography/agent-security-runtimes.md) — Enforces security policies and permission controls for autonomous agent execution environments.

### Development Tools & Productivity

- [Containerized and Isolated Workspaces](https://awesome-repositories.com/f/development-tools-productivity/development-environment-management/containerized-isolated-workspaces.md) — Ensures clean separation of concurrent tasks by operating each agent within an isolated filesystem directory.
- [Planning](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-tools/workflow-lifecycle-management/progress-tracking/planning.md) — Tracks long-running work through explicit plans and progress lists to ensure objectives remain visible and correctable. ([source](https://learn-claude-agents.vercel.app/en/timeline/))
- [Background Processing Tools](https://awesome-repositories.com/f/development-tools-productivity/background-processing-tools.md) — Automatically dispatches queued tasks to idle agents to ensure background operations do not interfere with user interactions. ([source](https://learn-claude-agents.vercel.app/en/s14/))
- [Task Dependency Management](https://awesome-repositories.com/f/development-tools-productivity/task-dependency-management.md) — Structures complex goals into ordered sequences by declaring prerequisite tasks that must be completed before subsequent work begins. ([source](https://learn-claude-agents.vercel.app/en/s12/))
- [Worktree Contextualizers](https://awesome-repositories.com/f/development-tools-productivity/working-directory-configuration/contextual-directory-injectors/worktree-contextualizers.md) — Directs agent tools to operate within specific worktree directories by overriding the current working directory. ([source](https://learn-claude-agents.vercel.app/en/s18/))

### DevOps & Infrastructure

- [Agent Task Managers](https://awesome-repositories.com/f/devops-infrastructure/automation-orchestration/task-execution-frameworks/task-job-management/task-schedulers/agent-task-managers.md) — Tracks the progression of work items through states to ensure orderly execution and prevent duplicate assignments. ([source](https://learn-claude-agents.vercel.app/en/s12/))

### Networking & Communication

- [Work Polling](https://awesome-repositories.com/f/networking-communication/polling-and-webhook-clients/work-polling.md) — Monitors task boards and communication channels during idle periods to automatically detect and claim new assignments. ([source](https://learn-claude-agents.vercel.app/en/s17/))
- [Message Routing](https://awesome-repositories.com/f/networking-communication/message-routing.md) — Dispatches incoming communications to specific handlers based on message type to ensure protocol-specific logic application. ([source](https://learn-claude-agents.vercel.app/en/s16/))

### Software Engineering & Architecture

- [Context Compaction Engines](https://awesome-repositories.com/f/software-engineering-architecture/architectural-design-patterns/state-management/reactive-subscription-systems/signals-reactivity/reactive-context-tracking/context-compaction-engines.md) — Automatically summarizes or truncates conversation history to maintain model performance during long sessions.
- [Message Queuing Architectures](https://awesome-repositories.com/f/software-engineering-architecture/message-queuing-architectures.md) — Decouples agent execution and state by using file-based message queues for asynchronous communication.
- [Contextual Data Injection](https://awesome-repositories.com/f/software-engineering-architecture/contextual-data-injection.md) — Injects system or user-level data into prompt structures based on defined operational rules. ([source](https://learn-claude-agents.vercel.app/en/s10/))
- [Error Recovery](https://awesome-repositories.com/f/software-engineering-architecture/error-recovery.md) — Classifies execution failures and applies automated retry strategies and model fallbacks to maintain system robustness. ([source](https://learn-claude-agents.vercel.app/en/timeline/))

### System Administration & Monitoring

- [Task Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/task-monitoring.md) — Detects stalled background processes and identifies interactive prompts to prevent tasks from hanging indefinitely. ([source](https://learn-claude-agents.vercel.app/en/s13/))

### Web Development

- [Request Mappings](https://awesome-repositories.com/f/web-development/request-mappings.md) — Maps model-requested actions to executable functions through a centralized registry for secure capability management.