zenflow CLAUDE.md

zenflow CLAUDE.md is an instructions file for coding agents from zendev-sh/zenflow. It costs 1,980 tokens per session, scanned A, a copy of zenflow AGENTS.md, Apache-2.0.

A set of contribution instructions for Zenflow, a Go toolkit that runs multi-step workflows described in YAML configuration files. It covers commands, project structure, architecture, and rules for working on the codebase.

In plain words
What is it for?
Contributing to Zenflow, including building its Go code, running tests and checks, understanding its workflow engine, and validating embedding examples.
Why use it?
It gives coding agents the project-specific context needed to build, test, lint, and change Zenflow consistently.

Instructions file

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/zendev-sh/zenflow/claude-md
Clone the repo
git clone --depth 1 https://github.com/zendev-sh/zenflow

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for zenflow CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/zendev-sh/zenflow/claude-md.svg)](https://agentmods.dev/instructions/zendev-sh/zenflow/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/zendev-sh/zenflow/claude-md"><img src="https://agentmods.dev/badge/instructions/zendev-sh/zenflow/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,980 This file is loaded in full into every session.
When invoked 1,980 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod 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.01980 $0.01980
Opus 5 $0.00990 $0.00990
Sonnet 5 $0.00396 $0.00396
Haiku 4.5 $0.00198 $0.00198

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

Security

Grade A, and why

zenflow CLAUDE.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 5d 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.

Origin

This is a copy

100% identical to zenflow AGENTS.md — 2 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 142 lines

How it starts

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

CLAUDE.md - zenflow

Instructions for AI contributors working on the zenflow codebase.

Commands

go build ./...                  # Build library
go build ./cmd/zenflow/         # Build CLI
go test ./...                   # Test all packages
go test -cover ./...            # Test with coverage
golangci-lint run               # Lint
./scripts/smoke-examples.sh     # Vet + build all 18 embedding examples
go test -tags e2e ./...         # Real-LLM integration tests (needs API keys)

Architecture

zenflow is a declarative multi-agent workflow engine for Go. Workflows are YAML; the engine is a DAG executor with an LLM coordinator that narrates progress and routes events through hub-and-spoke mailboxes. The Go SDK layer is goai - any provider goai supports works as a zenflow agent backend.

zenflow/
├── doc.go                      # Package zenflow doc.
├── interfaces.go               # Storage/Tracer/StepIsolation/ApprovalHandler aliases (root facade)
├── workflow.go                 # Workflow / Step / StepResult / WorkflowResult / Run aliases (root facade)
├── duration.go                 # Duration alias + FormatDuration / ParseDurationStrict re-exports
├── router_facade.go            # Re-exports for internal/router/ public API
├── transcript_facade.go        # Re-exports for internal/resume/ public API
├── coord_facade.go             # Re-exports for internal/coord/ tool factories
├── agent_facade.go             # Re-exports for internal/exec/ AgentRunner ecosystem (AgentRunner, AgentResult, 22 WithRunner*, AgentHandle, sentinels)
├── orchestrator_facade.go      # Re-exports for internal/exec/ Orchestrator + 49 With* + Executor + Storage backends + parsers + coord factory + JSON coordinator + ~60 utility symbols
├── internal/
│   ├── types/                  # Event, EventType, MessageKind, Output, ProgressSink, PermissionHandler/Request (leaf, no deps on root)
│   ├── spec/                   # Workflow / Step / Run / StepResult / AgentConfig / Duration types + Storage / Tracer / StepIsolation / ApprovalHandler / ModelResolver interface contracts + parser & validator helpers
│   ├── router/                 # MessageRouter, MailboxStore, deliveryEngine (race-safe send/wake)
│   ├── resume/                 # TranscriptStore, InMemoryTranscriptStore
│   ├── coord/                  # RunnerHandle interface + 4 coord goai.Tool factories (forward_to_agent, send_message, narrate, finalize)
│   └── exec/                   # AgentRunner + Executor + Orchestrator + JSON coordinator + RunFlow/RunGoal/RunAgent + ResumeFlow + 49 With* options + Storage backends (MemoryStorage, FileStorage) + SharedMemory + parsers + validators + scheduler + CEL evaluator + portability lints + isolation default + lifecycle + prompt assembly + 16 source files moved from root
├── cmd/zenflow/
│   ├── main.go                 # CLI entrypoint
│   ├── flags.go                # Shared flag parser
│   ├── cmd_*.go                # Subcommand handlers (flow, goal, agent, validate, plan)
│   ├── orchestrator_opts.go    # Build orchestrator from CLI flags
│   ├── provider.go             # Provider resolver
│   ├── thinking.go             # --thinking flag
│   ├── trace_otel.go           # --trace flag
│   ├── signals.go              # Signal handling
│   ├── workdir.go              # Working directory helper
│   ├── permission.go           # Interactive permission gate
│   ├── stdout_sink.go          # CLI human-readable sink
│   ├── color.go                # ANSI color helpers (auto-detect TTY)
│   ├── dag/                    # DAG plan helpers
│   └── tool/                   # CLI-only IO tools (bash/read/write/glob/grep)
├── sink/
│   ├── json.go                 # NDJSON event stream
│   ├── buffered.go             # ClosableProgressSink wrapping any sink with bounded queue
│   └── lifecycle.go            # Sink lifecycle helpers (graceful shutdown / Close())
├── examples/                   # 18 //go:build example mains
└── spec/v1/
    ├── schema.json             # JSON Schema (workflow validation)
    ├── spec.md                 # Authoritative YAML specification
    ├── examples/               # 20 reference workflows
    └── testcases/              # Conformance fixtures

Read the full file on GitHub · 142 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. 5d ago First seen · 142 lines · 1,980 tokens per session scan A c6859e94c01e

Subscribe to this mod's changes

zenflow CLAUDE.md is an instructions file published in the GitHub repository zendev-sh/zenflow (49 stars, last pushed today), licensed Apache-2.0. It adds 1,980 tokens to every session, about $0.0099 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to zenflow AGENTS.md, differing in 2 lines, and is treated as a copy.