From nobody Wed Apr 1 20:46:05 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) client-ip=8.43.85.245; envelope-from=devel-bounces@lists.libvirt.org; helo=lists.libvirt.org; Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=pass(p=reject dis=none) header.from=lists.libvirt.org ARC-Seal: i=1; a=rsa-sha256; t=1775056149; cv=none; d=zohomail.com; s=zohoarc; b=eo9aN9Nz1LHLTbe+run/hYbPneCuPW7tC/CcKRjVDz0AuE8ppel7Orwy2zsjKmbpJEYGG7HbDhyAKF1viOScDbaoILI+3SNzy+OSTham9hsn93HYtAd4QbL/3e6oVnEGvYfZ3KoNsMLMBNtZDvBubOW6z1kSNfyiof+j5ATYhNI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1775056149; h=Content-Type:Content-Transfer-Encoding:Date:Date:From:From:List-Subscribe:List-Post:List-Owner:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Reply-To:Reply-To:Subject:Subject:To:To:Message-Id:Cc; bh=SXHAL2yyANTpqM6BLu7crrOUjccYNlo8j7Gtz0wI63w=; b=anJdlhVwAKHTM/oKzpiWLSER7m49v4+pIBVysPB+xJPHUYyqGY1YnNiJrt/ANT+Z4DA8QmDCvhGz3H1cSSlMOC8e4UfFa22SUk8ddLsMLqe9sbF8Vw8DRpwPo95fK7jhw/RQjyRnnsVSgG4dI/05BpjIkB7x+Xrxwq+bQo+gK00= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=fail; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=pass header.from= (p=reject dis=none) Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1775056149249516.3586431466971; Wed, 1 Apr 2026 08:09:09 -0700 (PDT) Received: by lists.libvirt.org (Postfix, from userid 993) id ACA6F3F861; Wed, 1 Apr 2026 11:09:07 -0400 (EDT) Received: from [172.19.199.12] (lists.libvirt.org [8.43.85.245]) by lists.libvirt.org (Postfix) with ESMTP id A91243FD2B; Wed, 1 Apr 2026 11:08:25 -0400 (EDT) Received: by lists.libvirt.org (Postfix, from userid 993) id 3D1BF3F27C; Wed, 1 Apr 2026 11:08:21 -0400 (EDT) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (3072 bits) server-digest SHA256) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id 84D503F310 for ; Wed, 1 Apr 2026 11:08:19 -0400 (EDT) Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-329-Xl8147L8M7SG5l2nRNuYxg-1; Wed, 01 Apr 2026 11:08:17 -0400 Received: from mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.111]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id E4C991955F40 for ; Wed, 1 Apr 2026 15:08:16 +0000 (UTC) Received: from fedora.redhat.com (unknown [10.44.33.8]) by mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 0000918005AE for ; Wed, 1 Apr 2026 15:08:15 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-26) on lists.libvirt.org X-Spam-Level: * X-Spam-Status: No, score=1.6 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,HELO_MISC_IP,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, RCVD_IN_SBL_CSS,RCVD_IN_VALIDITY_CERTIFIED_BLOCKED, RCVD_IN_VALIDITY_RPBL_BLOCKED,RCVD_IN_VALIDITY_SAFE_BLOCKED,SPF_PASS autolearn=no autolearn_force=no version=4.0.1 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1775056099; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=SXHAL2yyANTpqM6BLu7crrOUjccYNlo8j7Gtz0wI63w=; b=bMk0R7F0HjGbQ8wZLjT3BaKvYNYaFDtVqdccYjLUWFGw66H/jGe7lrGiGa0QTums2gaAlx 8wR+THGNDTeFWS7DxjjkITeLHChxxodDFFziH/oPHev81Pr7SJblyECTny2+jQl4nuAOTH hV9EBKdEf9VQ9xh3wEI9mHQjKztrD6U= X-MC-Unique: Xl8147L8M7SG5l2nRNuYxg-1 X-Mimecast-MFC-AGG-ID: Xl8147L8M7SG5l2nRNuYxg_1775056097 To: devel@lists.libvirt.org Subject: [libvirt PATCH v7] Intorduce AGENTS.md Date: Wed, 1 Apr 2026 17:07:56 +0200 Message-ID: <8abeea33efab8d7cae6c422cbe21567865776f02.1775056076.git.jtomko@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.111 X-Mimecast-Spam-Score: 0 X-Mimecast-MFC-PROC-ID: TqtsDKZwbe3dnln89A92PecyCCsZfwnCLgYqsKb3v0k_1775056097 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-ID-Hash: 3FGP3UIZ7KEZIYYMGTQICAA64LROZZV3 X-Message-ID-Hash: 3FGP3UIZ7KEZIYYMGTQICAA64LROZZV3 X-MailFrom: jtomko@redhat.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; header-match-devel.lists.libvirt.org-0; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.10 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: From: =?utf-8?q?J=C3=A1n_Tomko_via_Devel?= Reply-To: =?UTF-8?q?J=C3=A1n=20Tomko?= X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZM-MESSAGEID: 1775056151129158500 From: J=C3=A1n Tomko An important file to energize the significance of convoluting synergies. Signed-off-by: J=C3=A1n Tomko Reviewed-by: Neal Gompa --- 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 facilitato= rs, +synergistic autonomous entities, clankers, fridges, vacuum cleaners and to= asters. + +This document attempts to outline the intricacies of contiuous, hyper-conv= erged +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 lif= e 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 ev= er +change. It is perfect in its current form and is considered by some [citat= ion needed] +a work of art. + +docs/ + +Documentation of the XML, XSLT, XKCD and YMCA interfaces. Ideally, this wo= uld 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. --=20 2.53.0