Complementary convention: `agentaccess.txt` — whether agents may access a directory (vs. how to work in it)

オープン
#232 コメント 7 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
25/100
issue の種類
機能追加
明瞭さ
説明が足りない
活発さ
活発
領域
documentation

調査の方向性

Start by reading the linked agentaccess.txt draft and SPEC §11, then review issues #33 and #228 for the related access-policy concerns. This proposal is discussion-only, with no implementation or settled answers; done would require agreement on scope, governance, and the open descendant-policy question.

索引モデルが issue の本文から書いたものです。

説明

AGENTS.md tells agents how to work in a project. I've drafted the complement for the question that comes before it: whether a given agent may operate in a directory at all. agentaccess.txt is a robots.txt-style access policy: per-agent groups, Allow/Disallow paths, evaluated by the harness before anything in the tree is read — including AGENTS.md itself. The files are deliberately disjoint: yours is instructions for the model, so it belongs in context; this one is instructions for the harness, so it must never enter model context — it gates the reading.

Two open issues here already name this gap from opposite sides. #33 asks which paths an otherwise-permitted tool must skip — agentaccess.txt is designed to compose with an ignore file, not replace it: access policy first, path exclusion within granted access second. And #228 lists the properties that make AGENTS.md unsafe as a policy file: chat prompts override it, a nested file displaces the root's rules, and a model reads it. This draft inverts the first and third by construction — enforcement sits in the harness, not the model. The second is genuinely open: whether a descendant file may loosen an ancestor's policy is one of the proposal's open questions, and #228's vendored-code scenario is the sharpest version of that risk.

My proposal presents AGENTS.md as its complement and I want that framing to be fair from your side; and one of its open questions is governance — standalone, or attached to an existing community such as this one (SPEC §11, Q8).

Draft 00, one author, no implementations. If this is out of scope for the tracker, close freely.

主要言語
TypeScript
スター
24.8k
フォーク
1.9k
PR マージ指標
30日以内にマージされた PR はありません

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

agentsmd/agents.md のほかの issue

agentsmd/agents.md の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。