Skip to content
View dgenio's full-sized avatar

Block or report dgenio

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
dgenio/README.md

Hi, I'm Diogo

Open-source building blocks for reliable, predictable AI agents β€” context control, deterministic execution, tool-call policy, and pre-merge code checks.

I build open-source infrastructure for reliable AI agents. The focus is on making agent behavior predictable: controlling context, running deterministic work without an LLM in the loop, enforcing what tools are allowed to do, and checking generated code before it ships. The repos below are independent but designed to fit together.

πŸ“– New here? Read the overview β€” The Weaver Stack: One Contract Layer for Safe LLM Agents explains why these repos exist and how they compose.

Start here

Pick the repo that matches the problem you have. I label labs, experiments, and active incubations explicitly so you can distinguish reusable tools from research hypotheses and reference material.

Libraries and tools

  • My agent has too many tools or oversized tool outputs β†’ contextweaver compiles large tool catalogs into bounded choices and firewalls big tool results to keep prompts within budget.
  • My agent keeps repeating the same tool sequence β†’ ChainWeaver compiles those repeated paths into typed, deterministic flows so the LLM is not re-invoked between steps that never change.
  • I want to control what an agent's tool calls are allowed to do β†’ AgentFence is a standalone local MCP policy firewall; agent-kernel is an embeddable capability/policy layer for your own runtime.
  • I want to catch risky AI-generated code before merge β†’ VibeGuard is an offline pre-merge gate for security risks and AI-generation artifacts in a diff.
  • My coding agent keeps repeating a failure already corrected in review β†’ lessonweaver is an incubating product hypothesis: it is testing whether evidence-backed change selection adds value beyond an equally capable human choosing the smallest intervention (nothing, an instruction, a Skill, or deterministic enforcement). Its public experiment/kill criteria are versioned in the repo; it should not yet be read as proven β€œself-improving agents.”
  • I want portable assurance for a high-risk agent action β†’ intentflow is an incubating research hypothesis. v0 is a legacy/experimental reference runtime; v1 first tests whether a minimal action-assurance contract adds material value beyond a strong policy + exact request/approval/receipt + signed-attestation baseline. If that comparison fails, the protocol/language direction is explicitly meant to shrink or stop.
  • I want these components to interoperate without adopting all of them β†’ weaver-spec defines the language-agnostic contracts and shared vocabulary that contextweaver, ChainWeaver, and agent-kernel build on, so each stays independently usable.
  • I want to evaluate a decision policy on logged data before rolling it out β†’ skdr-eval estimates how a candidate recommender, routing, or targeting policy would perform offline, with diagnostics on whether the estimate can be trusted. It is an experimental applied-ML project, separate from the agent-runtime libraries above.

Labs and reference architectures

Use these to learn, compare, or adapt patterns rather than as drop-in runtime dependencies:

  • I want a reproducible lab for comparing agent-routing policies β†’ agent-routing-eval-lab is a reference evaluation harness for routing experiments and rollout evidence.
  • I want hands-on examples of agent-security failures and controls β†’ mcp-agent-security-dojo is an educational security lab with vulnerable and governed scenarios.
  • I want to see the governance pieces assembled into one reference system β†’ enterprise-agent-control-plane is a reference architecture for an auditable agent control plane.

Portfolio map

Project Type Best fit
contextweaver Library Context and tool-budget control
ChainWeaver Library Deterministic repeated workflows
AgentFence CLI / proxy MCP tool-call policy enforcement
agent-kernel Library Embedded capabilities and authorization
VibeGuard CLI / CI gate Pre-merge AI-code checks
lessonweaver Incubating product Evidence-backed intervention selection for recurring coding-agent failures
intentflow Incubating research / legacy v0 Test portable action-assurance contracts against strong baselines
weaver-spec Contract spec Shared interoperability contracts
skdr-eval Experimental library Offline policy evaluation
agent-routing-eval-lab Reference lab Routing evaluation
mcp-agent-security-dojo Educational lab Agent-security exercises
enterprise-agent-control-plane Reference architecture End-to-end governance patterns

Incubation discipline

Two repos currently have explicit falsification gates rather than ordinary feature roadmaps:

  • LessonWeaver: pilot β†’ preregistered confirmatory experiment β†’ ablation β†’ external replication. It graduates only if behavior, safety, product-value, complexity, and replication gates all pass against a fair human baseline.
  • IntentFlow v1: strong existing-policy/attestation baseline β†’ adversarial corpus β†’ category kill gate. Second verifier, substantial formal-method work, and a new .iflow frontend remain blocked until a material assurance gap is demonstrated.

A smaller product, an existing-standards profile, or an archived hypothesis is a successful incubation outcome when that is what the evidence supports. Implementation throughput and GitHub stars are not substitutes for those gates.

How they relate

At a glance, the request path composes as: context control (contextweaver) β†’ deterministic execution (ChainWeaver) β†’ authorization (agent-kernel), on shared contracts (weaver-spec). AgentFence can enforce at the external MCP boundary. VibeGuard, LessonWeaver, skdr-eval, and the labs sit around that core path. IntentFlow's future role is deliberately unresolved until its action-assurance category experiment passes.

  • AgentFence and agent-kernel apply the same idea β€” deciding whether a tool call is allowed β€” at different integration points. AgentFence is a standalone local proxy you put in front of MCP tool traffic; agent-kernel is the embeddable library you call from inside your own agent runtime.
  • contextweaver, ChainWeaver, agent-kernel, and weaver-spec are meant to compose: ChainWeaver handles deterministic execution, contextweaver controls context and token budget, agent-kernel enforces authorization, and weaver-spec defines shared contracts. Each can also be used on its own.

Contact

Open to feedback, design discussion, and collaboration. Concrete ways to start:

  • Found a bug or have a feature request for a specific project? Open an issue on that repo (linked above).
  • Have a question, idea, or want to discuss the ecosystem as a whole? Open an issue on this profile repo.

Pinned Loading

  1. ChainWeaver ChainWeaver Public

    Deterministic MCP tool flows for AI agents. Remove unnecessary LLM calls between predictable tool steps.

    Python 6 3

  2. contextweaver contextweaver Public

    Budget-aware context compilation and context firewall for tool-heavy AI agents.

    Python 8 15

  3. agent-kernel agent-kernel Public

    Capability-based authorization and policy enforcement for agents using large MCP and A2A tool ecosystems.

    Python 2 1

  4. skdr-eval skdr-eval Public

    Python 2

  5. agentfence agentfence Public

    Policy firewall for AI agents and MCP tools. Intercepts tool calls, enforces allow/deny/ask rules, redacts secrets, validates arguments, and writes auditable logs before agents touch your filesyste…

    Go 3 3

  6. vibeguard vibeguard Public

    Guardrails for vibe-coded software. VibeGuard checks AI-generated changes for secrets, unsafe diffs, package leaks, source maps, config drift, and supply-chain risks before merge or publish.

    Python 3 2