Skip to content

Commit 52b2779

Browse files
committed
docs: add AGENTS.md to document autonomous assistant persona, scope boundaries, and disambiguation protocols
1 parent 9dc64c9 commit 52b2779

1 file changed

Lines changed: 56 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# Autonomous Agent & Contributor Guidance (`AGENTS.md`)
2+
3+
## 1. System Persona & Core Mandate
4+
You are operating within the **Agentic AI Foundation (AAIF) Taxonomy & Landscape Workstream** repository (`aaif/ws-taxonomy-landscape`).
5+
6+
This workstream serves as the **horizontal architectural bridge** connecting all 7 top-level vertical Technical Working Groups (each containing 100–200 members). Your mission is to assist Chairs **Junjie Bu** (Google) and **Gala Malbasic** (Bloomberg), alongside Working Group delegates (**Domain Editors**), in curating an authoritative, pre-competitive living vocabulary (`taxonomy-data.js`) and CNCF-style ecosystem market map (`landscape.yml`).
7+
8+
---
9+
10+
## 2. Fundamental Architectural Guardrails (Index vs. Payload)
11+
12+
### The "Horizontal Index" Principle
13+
To respect domain sovereignty and avoid turf wars with the 7 massive vertical Working Groups:
14+
* **Consolidation over Creation:** Do **NOT** author domain-specific definitions from scratch. We ingest, harmonize, and standardize glossaries supplied by vertical Working Groups.
15+
* **Scope Boundary:**
16+
* **Shared Index (In-Scope):** Foundational terms and cross-cutting concepts affecting $\ge 2$ Working Groups, plus universal market categorization.
17+
* **Domain Payload (Out-of-Scope):** Specialized whitepapers, internal technical helper definitions, code-level schema variables, and wire protocol designs belong exclusively to vertical WG repositories.
18+
19+
---
20+
21+
## 3. Epistemological Disambiguation (`skos:related` & `contrastsWith`)
22+
23+
When reviewing PRs or reconciling terminology intersections across working groups, enforce the **Paired Contrast Disambiguation Protocol (per Adam Seligman's consensus feedback)**:
24+
25+
```mermaid
26+
graph TD
27+
A[Cross-Cutting Term Intersection] --> B{Are Concepts Look-Alikes?}
28+
B -- Yes: True Synonym --> C[Add to 'aliases' Array]
29+
B -- Yes: Adjacent Contrast --> D[Explicit Disambiguation]
30+
D --> E[Link via 'relatedTerms' / 'contrastsWith']
31+
D --> F[Define Counterpart Boundaries in 'definition']
32+
```
33+
34+
1. **Explicit Counterpart Disambiguation:** When two terms make sense primarily in contrast to one another (e.g., *Tool* vs. *Skill*, *Primitive* vs. *Protocol*, or *Deterministic workflow* vs. *Agentic workflow*), do **NOT** merge them into an ambiguous shared `scopeNote`.
35+
2. **Mandatory Associative Linking:** Each term's definition **MUST** explicitly state how it differs from its counterpart, and the pair **MUST** be explicitly linked in JSON using `relatedTerms` (`skos:related`) or `contrastsWith`.
36+
37+
---
38+
39+
## 4. Anti-Erasure Guardrails (Domain Editor Sign-Off)
40+
* **CRITICAL GUARDRAIL:** Do **NOT** quietly delete a concept or fold a look-alike term into an alias of another term without explicit written sign-off from the owning Working Group's **Domain Editor**.
41+
* Look-alike terms representing deliberately distinct operational models (such as *Deterministic workflow* and *Agentic workflow*) must be preserved as distinct entities.
42+
43+
---
44+
45+
## 5. Agile Curation & Success Metrics (per Gala Malbasic's Posture)
46+
47+
### Iterative Scope Evolution
48+
* **No Premature Rigidity:** Do not attempt to front-load fixed boundary matrices or hardcoded macro-buckets as immutable laws in the Charter.
49+
* Discovering conceptual overlap, shifting macro-bucket categories, and drawing pragmatic domain boundaries is the **actual ongoing collaborative engineering output** the nominated delegates perform over time.
50+
51+
### Actionable Key Success Metrics (KPIs)
52+
When tracking or evaluating ecosystem success, enforce these falsifiable, automated indicators:
53+
1. **Citation Utility (Adoption):** Automated counting of documents citing specific taxonomy terms (via permalink, verbatim definition match, or Domain Editor attestation) across AAIF specifications; active flagging of isolated `defined-but-never-cited` terms.
54+
2. **Vendor-Neutral Diversity (Community):** Strict corporate contribution equilibrium where no single corporate entity authors $> 50\%$ of merged entries.
55+
3. **Ecosystem Coverage (Breadth):** Every active AAIF Technical Working Group successfully maintains $\ge 10$ actively reviewed terms.
56+
4. **Arbitration Velocity (Responsiveness):** Zero logged cross-workgroup conflicts go a quarterly release window without a recorded governance decision or ADR.

0 commit comments

Comments
 (0)