Agentflow copilot-instructions.md

Repository-specific instructions for Agentflow, a Python framework for building workflows where multiple language-model agents perform connected steps. It documents the framework's graphs, state, messages, tools, and execution flow.

In plain words
What is it for?
Use it when developing or maintaining Agentflow components such as workflow graphs, nodes, conditional routes, state models, and tool integrations.
Why use it?
It gives a coding agent the project's expected architecture and naming conventions before it changes or adds code.

Instructions file for GitHub Copilot

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/10xhub/agentflow/copilot-instructions
Clone the repo
git clone --depth 1 https://github.com/10xHub/Agentflow

Made for: GitHub Copilot.

Per session 1,520 This file is loaded in full into every session.
When invoked 1,520 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01520 $0.01520
Opus 5 $0.00760 $0.00760
Sonnet 5 $0.00304 $0.00304
Haiku 4.5 $0.00152 $0.00152

Measured 2d ago against content hash 4a5f3ae51914, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

Agentflow copilot-instructions.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.github/copilot-instructions.md · 78 lines

How it starts

The opening of the file, as written. The whole thing — 78 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Copilot instructions for 10xScale Agentflow

Use these repo-specific notes to be productive quickly when generating code, docs, or tests.

Big picture

  • 10xScale Agentflow is a lightweight Python framework for building multi-agent workflows with LLM-agnostic orchestration.
  • Core primitives live in agentflow/graph/: StateGraph, Node, Edge, ToolNode, CompiledGraph.
  • State is a Pydantic model (state/agent_state.py); messages are state/message.py::Message with multimodal content blocks (state/message_block.py).
  • Flow: build a StateGraph → add nodes/edges (incl. conditional) → set_entry_pointcompile() → use CompiledGraph.invoke() or CompiledGraph.stream().
  • START/END constants come from utils/constants.py (START="__start__", END="__end__"). Always reference these.

Architecture essentials

  • Graph API (see graph/state_graph.py, graph/compiled_graph.py, graph/node.py):
    • add_node(name, func|ToolNode), add_edge(from, to), add_conditional_edges(from, condition, path_map).
    • compile(checkpointer, interrupt_before, interrupt_after) wires DI (InjectQ), checkpointer, callbacks, publisher; default checkpointer is in-memory.
  • Node contracts (graph/node.py):
    • Functions accept (state: AgentState, config: dict, …deps) and return updated state, list[Message], or ModelResponseConverter.
    • Streaming supported by .stream(...) and EventModel chunks.
  • Tools via ToolNode (graph/tool_node/base.py):
    • Register plain callables or integrate MCP, Composio, LangChain. Get tool specs via await tool_node.all_tools().
    • Tool functions may declare injectable params like tool_call_id and state (see examples).
    • Supports parallel tool execution.
  • Persistence & events:
    • Checkpointers: InMemoryCheckpointer (default) and PgCheckpointer (Postgres+Redis, extras required).
    • Publishers emit execution events (ConsolePublisher for dev). Events are publisher/events.py::EventModel.
  • State management:
    • AgentState has context (list of messages with add_messages reducer), context_summary, and execution_meta (internal execution state).
    • Subclass AgentState to add custom fields while maintaining framework compatibility.
    • Use BaseContextManager for custom context trimming logic.

Read the full file on GitHub · 78 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 78 lines · 1,520 tokens per session scan A 4a5f3ae51914

Subscribe to this mod's changes

Agentflow copilot-instructions.md is an instructions file published in the GitHub repository 10xHub/Agentflow (20 stars, last pushed 17d ago), licensed MIT. It adds 1,520 tokens to every session, about $0.0076 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

ai-agents-for-beginners AGENTS.md

Instructions for microsoft/ai-agents-for-beginners, covering agents.md, project overview, setup commands, prerequisites and initial setup.

microsoft/ai-agents-for-beginners · 2,488 tokens

agent-framework python.instructions.md

Instructions for microsoft/agent-framework: See AGENTS.md for project structure and package documentation. Detailed conventions are in the agent skills under .github/skills/.

microsoft/agent-framework · 110 tokens

openacme CLAUDE.md

Instructions for sandydasari/openacme, covering openacme — claude code guide, workspace layout, the agent loop — request path, why sse-only and custom data parts.

sandydasari/openacme · 13,009 tokens

agentfootprint AGENTS.md

Instructions for footprintjs/agentfootprint, covering agentfootprint — agent instructions (openai codex), core thesis, the mental model — three slots, six flavors, mock-first development (recommended workflow) and public api.

footprintjs/agentfootprint · 7,987 tokens

Framework_Development_Guide

Instructions for rezaho/MARSYS, covering 0. golden principle, 1. layered architecture (mental model), 2. core classes & responsibilities, 2.1 module overview & logical flow and src/agents/ - agent architecture & communication.

rezaho/MARSYS · 2,483 tokens

best-of-Agent-Harnesses CLAUDE.md

Claude Code instructions for RyanAlberts/best-of-Agent-Harnesses, covering repo notes for ai coding agents, commit identity (required), branching and pushing (required), verifying contribution credit (required) and how the list is generated.

RyanAlberts/best-of-Agent-Harnesses · 1,177 tokens