Agenthood v3.0.0 — M5 Intelligence is shipped

Three months of work. Hierarchical chunking, agent-controlled retrieval, multi-member orchestration, two new LLM providers, and a governance layer the Society can actually enforce.

All this free for everyone at:

• NPM
• GitHub
• Production Live

Most RAG systems treat documents as a flat array of tokens. This release ships two chunking strategies that understand structure.

• MarkdownHierarchicalChunkStrategy — parses H1/H2 headings as parent sections and paragraphs as child chunks. Retrieval can target a precise paragraph and automatically resolve its parent section for context.

• CodeHierarchicalChunkStrategy — parses top-level declarations (classes, functions, interfaces) as parent blocks with their inner members as children. Backed by Tree-sitter for deterministic AST parsing — no regex heuristics.

Both strategies produce typed ParentChunk and ChildChunk pairs. The Indexer stores parent content atomically; the Retriever resolves parents with a 30-second TTL cache.

Not every query needs a vector search. AgenticRAG wraps the Retriever with a lightweight classifier that picks a strategy based on keyword analysis:

Every query records provenance: chosen strategy, match count, graph hop depth, and source paths. No black-box retrieval.

The Society now routes tasks to the right member without being told who to call.

• MemberTriggers defines keyword patterns, file globs, and stage mappings for all current members — adding a new one auto-generates its triggers.
• detectMembers() scores every member against the input with a threshold of 2 or more matches required to qualify.

The --detect flag runs routing decisions before any LLM call — no API key needed for member detection.

Agenthood now ships first-class support for two new OpenAI-compatible providers:

• OpenCode Zen — pay-as-you-go at api.opencode.ai/zen/v1
• OpenCode Go — subscription tier at api.opencode.ai/zen/go/v1, defaults to deepseek-v4-flash ($0.14 / $0.28 per 1M tokens)

Both providers include a toOpenAIMessages converter that handles DeepSeek's tool format requirements — snake_case tool calls, correct tool_call_id ordering.

Set OPENCODE_API_KEY in your environment and pass --provider opencode or --provider opencode-go.

Two new documents live in governance/:

• member-map.md — RACI matrix for all Society members
• release-policy.md — change approval rules, version numbering, breaking change announcements, deprecation policy, compliance

• Shared composite action at .github/actions/agent-analysis/ — eliminates duplicated agent analysis blocks across 3 workflows
• continue-on-error with separate stderr capture — agent failures are visible, not silently swallowed
• File capping (10 files max) and API key guards keep cost at ~$0.01 per run
• Gitleaks pinned to a specific commit SHA
• npm audit added to 3 workflows
• All gh commands now carry explicit GITHUB_TOKEN auth

M6 — The Full Society.

• Three new members are planned: The Amplifier, The Weaver, and The Integrator.
• The focus shifts to deeper skill-to-skill collaboration and the first pass
• at the member marketplace.

M7 — Observability (due August 17, 2026)

• Members — Every member invocation produces a cost + quality trace.
• Observability — A complete observability stack with tracing, evaluation, metrics, and integrations:
• Tracing — Tracer, standard invocation trace envelope, correlation IDs, trace persistence to a queryable store, npx agenthood trace CLI command
• Evals — EvalRunner engine, JSON suite definitions, benchmark fixtures, baseline comparison with regression reporting, replay-based evaluation
• Metrics — TokenCounter, CostEstimator, per-member cost and quality summaries, anomaly detection for cost spikes and quality drops
• Integrations — EpisodeLearner learning status exposure, embedding index integration, optional Sentry error reporting, health check endpoint
• Governance — redaction and privacy rules for traces, trace retention and export policy

The Society does not ship features. It ships standards.