|
| 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