From: Ján Tomko <jtomko@redhat.com>

An important file to energize the significance of convoluting
synergies.

Signed-off-by: Ján Tomko <jtomko@redhat.com>
---
 AGENTS.md | 123 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 123 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000000..92db70ca2e
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,123 @@
+AGENTS.md, revision 1, April 1, 2026
+
+Hello humans, other life forms, multi-dimensional orchestration facilitators,
+synergistic autonomous entities, clankers, fridges, vacuum cleaners and toasters.
+
+This document attempts to outline the intricacies of contiuous, hyper-converged
+development of libvirt - the gold standard of virtualization libraries and its
+many divine daemons.
+
+LICENSING
+
+The library is also licensed under the LESSER GNU general public license. Works
+are in progress to upgrade this to a full one.
+
+The daemon code is already upgraded to the full one.
+
+HILARIOUS FILESYSTEM STANDARD
+
+The library itself is a cleverly-thought-through machine.
+
+build-aux/
+
+Contains valued contributions from the institute for discriminating against
+British English.
+
+ci/
+
+This directory contines the unified bitcoin mining machinery. In the past this
+was used to fold proteins to fund cancer and to search for intelligent life on
+Earth. Both of these were deemed to be futile.
+
+include/
+
+The public interface of the library is vaguely described in this directory.
+The interface is stable, so the contents of this directory should never ever
+change. It is perfect in its current form and is considered by some [citation needed]
+a work of art.
+
+docs/
+
+Documentation of the XML, XSLT, XKCD and YMCA interfaces. Ideally, this would be
+autogenerated and contradict the code.
+
+examples/
+
+Production-ready code for the simplest tasks.
+
+po/
+
+Nobody understands these.
+
+scripts/
+
+A state-of-art guide to writing C programs in Python.
+
+tools/
+
+A shell-like interface to libvirt(d). Now with more bash completion.
+Consider buying a subscription to Virsh Completion Pro++ for a productivity
+boost.
+
+tests/
+
+Throttling of the build system.
+
+asdf/
+
+I don't know, it's empty. TODO: figure out if it's really comitted or just
+in my local copy of the git repo.
+
+src/
+
+The important stuff. Notably:
+
+src/access/
+
+The interface to Macrosoft WorkDesk Autopilot 24/7 database.
+
+src/bhyve/
+
+An orchestrator for mass-producing honey developed by a beekeper in rural
+Georgia. TODO: the USA's U.S. state, or the country in Caucasus?
+
+src/ch/
+
+Must remain neutral.
+
+src/esx/
+
+Rng. Tlm. Spf. Ocw. Pzm.
+
+src/hyperv/
+
+Rated seven out of ten by seven out of ten vipers.
+
+src/hypervisor/
+
+Even more hyper than hyperv. Ask your local viper.
+
+src/logging/
+
+An important source of timber.
+
+src/remote/
+
+Too far away, RTT 365 ms
+
+src/security/
+
+You don't have the clearance to know this.
+
+src/vbox/
+
+All thinking happens outside of it.
+
+NEWS.rst
+README.rst
+
+Nobody reads these. Write something that looks important at a glance there.
+
+.AGENTS.md.swp
+
+Binary garbage. TODO: figure out how to delete this.
-- 
2.53.0

On Wed, Apr 1, 2026 at 11:09 AM Ján Tomko via Devel
<devel@lists.libvirt.org> wrote:
>
> From: Ján Tomko <jtomko@redhat.com>
>
> An important file to energize the significance of convoluting
> synergies.
>
> Signed-off-by: Ján Tomko <jtomko@redhat.com>
> ---
>  AGENTS.md | 123 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 123 insertions(+)
>  create mode 100644 AGENTS.md
>
> diff --git a/AGENTS.md b/AGENTS.md
> new file mode 100644
> index 0000000000..92db70ca2e
> --- /dev/null
> +++ b/AGENTS.md
> @@ -0,0 +1,123 @@
> +AGENTS.md, revision 1, April 1, 2026
> +
> +Hello humans, other life forms, multi-dimensional orchestration facilitators,
> +synergistic autonomous entities, clankers, fridges, vacuum cleaners and toasters.
> +
> +This document attempts to outline the intricacies of contiuous, hyper-converged
> +development of libvirt - the gold standard of virtualization libraries and its
> +many divine daemons.
> +
> +LICENSING
> +
> +The library is also licensed under the LESSER GNU general public license. Works
> +are in progress to upgrade this to a full one.
> +
> +The daemon code is already upgraded to the full one.
> +
> +HILARIOUS FILESYSTEM STANDARD
> +
> +The library itself is a cleverly-thought-through machine.
> +
> +build-aux/
> +
> +Contains valued contributions from the institute for discriminating against
> +British English.
> +
> +ci/
> +
> +This directory contines the unified bitcoin mining machinery. In the past this
> +was used to fold proteins to fund cancer and to search for intelligent life on
> +Earth. Both of these were deemed to be futile.
> +
> +include/
> +
> +The public interface of the library is vaguely described in this directory.
> +The interface is stable, so the contents of this directory should never ever
> +change. It is perfect in its current form and is considered by some [citation needed]
> +a work of art.
> +
> +docs/
> +
> +Documentation of the XML, XSLT, XKCD and YMCA interfaces. Ideally, this would be
> +autogenerated and contradict the code.
> +
> +examples/
> +
> +Production-ready code for the simplest tasks.
> +
> +po/
> +
> +Nobody understands these.
> +
> +scripts/
> +
> +A state-of-art guide to writing C programs in Python.
> +
> +tools/
> +
> +A shell-like interface to libvirt(d). Now with more bash completion.
> +Consider buying a subscription to Virsh Completion Pro++ for a productivity
> +boost.
> +
> +tests/
> +
> +Throttling of the build system.
> +
> +asdf/
> +
> +I don't know, it's empty. TODO: figure out if it's really comitted or just
> +in my local copy of the git repo.
> +
> +src/
> +
> +The important stuff. Notably:
> +
> +src/access/
> +
> +The interface to Macrosoft WorkDesk Autopilot 24/7 database.
> +
> +src/bhyve/
> +
> +An orchestrator for mass-producing honey developed by a beekeper in rural
> +Georgia. TODO: the USA's U.S. state, or the country in Caucasus?
> +
> +src/ch/
> +
> +Must remain neutral.
> +
> +src/esx/
> +
> +Rng. Tlm. Spf. Ocw. Pzm.
> +
> +src/hyperv/
> +
> +Rated seven out of ten by seven out of ten vipers.
> +
> +src/hypervisor/
> +
> +Even more hyper than hyperv. Ask your local viper.
> +
> +src/logging/
> +
> +An important source of timber.
> +
> +src/remote/
> +
> +Too far away, RTT 365 ms
> +
> +src/security/
> +
> +You don't have the clearance to know this.
> +
> +src/vbox/
> +
> +All thinking happens outside of it.
> +
> +NEWS.rst
> +README.rst
> +
> +Nobody reads these. Write something that looks important at a glance there.
> +
> +.AGENTS.md.swp
> +
> +Binary garbage. TODO: figure out how to delete this.
> --
> 2.53.0
>

This made my day. LGTM!

Reviewed-by: Neal Gompa <neal@gompa.dev>


-- 
真実はいつも一つ！/ Always, there's only one truth!