---
name: agentflow
description: Expert guidance for building, debugging, and extending applications with AgentFlow (10xscale-agentflow). TRIGGER when: code imports from agentflow (e.g. `from agentflow import`, `StateGraph`, `Agent`, `ToolNode`, `AgentState`); user references `agentflow.json` or CLI commands (`agentflow init`, `agentflow api`, `agentflow play`, `agentflow build`, `agentflow skills`); user is building graph-based multi-agent workflows, tools, memory, checkpointing, or streaming with this framework. SKIP: generic Python or multi-agent questions not referencing agentflow; other frameworks (LangGraph, CrewAI, AutoGen) unless comparing.
metadata:
  resources:
    - references/architecture.md
    - references/agents-and-tools.md
    - references/state-graph.md
    - references/state-and-messages.md
    - references/checkpointing-and-threads.md
    - references/dependency-injection.md
    - references/media-and-files.md
    - references/memory-and-store.md
    - references/streaming.md
    - references/stream-emitter.md
    - references/production-runtime.md
    - references/api-client.md
    - references/remote-tools.md
    - references/callbacks-and-command.md
    - references/prebuilt-agents-and-tools.md
    - references/testing-and-evaluation.md
    - references/publishers-and-runtime-protocols.md
    - references/context-id-background.md
    - references/providers-and-adapters.md
    - references/security-and-validators.md
    - references/cli-commands.md
    - references/api-configuration.md
    - references/auth-and-authorization.md
    - references/api-settings-and-middleware.md
    - references/rate-limiting.md
    - references/rest-api-and-errors.md
    - references/id-and-thread-name-generators.md
    - references/client-auth-and-errors.md
    - references/client-messages-invoke-stream.md
    - references/client-threads-memory-files.md
  tags:
    - agentflow
    - agents
    - multi-agent
    - framework
  priority: 10
---

# Agentflow Project Skill

Use this skill when working in this Agentflow monorepo. Agentflow is a multi-agent framework that wraps official OpenAI and Google SDK capabilities behind a unified graph, agent, tool, state, storage, API, CLI, and TypeScript client interface.

Treat https://agentflow.10xscale.ai/ as the first source of truth for public package names, install commands, and user-facing behavior. Use implementation source after the docs establish the intended API.

## Workflow

1. Identify the published package or docs surface involved:
   - PyPI core Python SDK: `10xscale-agentflow` (`pip install 10xscale-agentflow`), source at https://github.com/10xHub/Agentflow/tree/main/agentflow/agentflow
   - PyPI API/CLI SDK: `10xscale-agentflow-cli` (`pip install 10xscale-agentflow-cli`), source at https://github.com/10xHub/Agentflow/tree/main/agentflow-api/agentflow_cli
   - npm TypeScript SDK: `@10xscale/agentflow-client` (`npm install @10xscale/agentflow-client`), source at https://github.com/10xHub/Agentflow/tree/main/agentflow-client/src
   - Main docs: https://agentflow.10xscale.ai/
   - Playground/UI: `agentflow play` command after installed cli

2. Read the matching reference file before changing behavior:
   - Architecture and package flow: `references/architecture.md`
   - Agent and tool behavior: `references/agents-and-tools.md`
   - Graph construction and execution: `references/state-graph.md`
   - State, messages, and content blocks: `references/state-and-messages.md`
   - Threads and persistence: `references/checkpointing-and-threads.md`
   - Dependency injection: `references/dependency-injection.md`
   - Multimodal files and media stores: `references/media-and-files.md`
   - Long-term memory stores: `references/memory-and-store.md`
   - Streaming, chunks, and SSE: `references/streaming.md`
   - Stream emitter for tool progress updates: `references/stream-emitter.md`
   - API server and deployment runtime: `references/production-runtime.md`
   - REST and TypeScript client surface: `references/api-client.md`
   - Browser/client-side tool execution: `references/remote-tools.md`
   - Observability hooks, validators, and runtime jumps: `references/callbacks-and-command.md`
   - Prebuilt agents/tools and handoff helpers: `references/prebuilt-agents-and-tools.md`
   - Testing helpers and evaluation framework: `references/testing-and-evaluation.md`
   - Event publishers and A2A/ACP runtime protocols: `references/publishers-and-runtime-protocols.md`
   - Context management, ID generation, and background tasks: `references/context-id-background.md`
   - Provider internals and adapters: `references/providers-and-adapters.md`
   - Prompt-injection and validation safety: `references/security-and-validators.md`
   - CLI commands and generated project files: `references/cli-commands.md`
   - `agentflow.json` and dependency loading: `references/api-configuration.md`
   - API auth and authorization: `references/auth-and-authorization.md`
   - API environment, settings, and middleware: `references/api-settings-and-middleware.md`
   - Rate limiting (config, backends, headers, custom backend): `references/rate-limiting.md`
   - REST routes and error behavior: `references/rest-api-and-errors.md`
   - API Snowflake IDs and thread naming: `references/id-and-thread-name-generators.md`
   - TypeScript auth helpers and structured errors: `references/client-auth-and-errors.md`
   - TypeScript messages, invoke, and stream details: `references/client-messages-invoke-stream.md`
   - TypeScript thread, memory, and file APIs: `references/client-threads-memory-files.md`
3. Prefer existing Agentflow abstractions over new custom wiring:
   - Build workflows with `StateGraph`, `Agent`, `ToolNode`, `AgentState`, and `Message`.
   - Persist conversation state with checkpointers; use stores only for cross-thread memory.
   - Put business services in `InjectQ` instead of global variables.
   - Keep API/CLI graph modules storage-agnostic and wire dependencies through `agentflow.json`.
4. Verify against source when implementation details matter. Public names and expected behavior should match https://agentflow.10xscale.ai/; source under https://github.com/10xHub/Agentflow (core), https://github.com/10xHub/agentflow-cli (API/CLI), and https://github.com/10xHub/agentflow-client (TypeScript) explains how that behavior is implemented.

## Local Conventions

- A compiled graph is normally loaded once by the API server and reused per request.
- Public package naming matters: use `10xscale-agentflow`, `10xscale-agentflow-cli`, and `@10xscale/agentflow-client` in user-facing docs and examples, not repository folder names.
- Every persisted interaction should include `config.thread_id`.
- Tools need docstrings and type annotations so model-facing schemas are useful.
- Injectable tool and node parameters such as `state`, `config`, and `tool_call_id` are hidden from the model schema.
- For production, avoid process-local storage for shared state; use durable checkpointer/store backends.
