From b21da3cdf59519b6de0361290258c70b5077134e Mon Sep 17 00:00:00 2001
From: Barney Wohl <barney@buildnexio.xyz>
Date: Wed, 13 May 2026 14:24:11 -0500
Subject: [PATCH] Add agents.txt v1.0 (lineage cross-link)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Adds a single `agents.txt` file at the repo root, in the v1.0 INI
format from https://github.com/barneywohl/agentpress.

The agents.txt v1.0 spec explicitly cites llms.txt as its lineage
parent (robots.txt → sitemap.xml → llms.txt → agents.txt), so this
PR is a courtesy cross-link rather than an ask. No CI changes,
no doc changes, no upstream coupling.

Content is tuned for this repo's actual shape (spec + docs + small
Python helper); allowed_actions cover read/PR/issue-comment;
prohibited_actions cover the obvious (no merging, no PyPI pushes,
no force-pushes); spec text and the nbs/ source require human
approval; entry_points point at nbs/index.qmd (source of truth)
and llmstxt.org (rendered site).
---
 agents.txt | 57 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 agents.txt

diff --git a/agents.txt b/agents.txt
new file mode 100644
index 0000000..920558d
--- /dev/null
+++ b/agents.txt
@@ -0,0 +1,57 @@
+# agents.txt - guidance for AI agents interacting with this repository
+# Spec: https://github.com/barneywohl/agentpress (agents.txt v1.0)
+
+[meta]
+spec_version = 1.0
+project = llms-txt
+maintainer = github@jhoward.fastmail.fm
+contact_for_agents = github@jhoward.fastmail.fm
+last_updated = 2026-05-13
+license = Apache-2.0
+ai_disclosure_required = true
+
+[allowed_actions]
+read_documentation
+read_source_code
+run_tests_in_ci
+file_pull_request
+comment_on_issue
+propose_spec_clarification
+suggest_example
+
+[prohibited_actions]
+merge_to_main
+publish_to_pypi
+modify_secrets
+force_push
+rewrite_history
+impersonate_maintainer
+mass_open_issues
+spam
+
+[requires_human_approval]
+changes_to_spec_text
+changes_touching = nbs/**, llms_txt/**, pyproject.toml
+new_dependencies
+release_tagging
+
+[entry_points]
+agent_guide = agents.txt
+contributing = README.md
+architecture = nbs/index.qmd
+test_command = nbtest
+
+[disclosure]
+pr_label = agent-authored
+commit_trailer = Co-Authored-By
+require_attribution_in_pr_body = true
+
+[scope]
+max_files_per_pr = 10
+max_lines_per_pr = 300
+prefer_single_concern_prs = true
+
+[fyi]
+repo_is_primarily_spec_and_docs = true
+source_of_truth = nbs/index.qmd
+rendered_site = https://llmstxt.org/