Discoverability registration: awesome-a2a, a2a-directory, pab1it0/awesome-a2a — GATED (Umbrella #1156)

[jinon86]

배경

GitHub A2A 생태계의 awesome / directory 카테고리는 활발히 큐레이션되며 (ai-boost/awesome-a2a ★623, sing1ee/a2a-directory ★235, pab1it0/awesome-a2a ★178), Broker / Control-plane 카테고리에 등재된 프로젝트가 거의 없습니다. a2a-nexus 가 등재되면 first-mover 효과로 외부 발견 가능성이 즉시 상승합니다.

⚠️ 이 이슈는 visibility flip 의존: 레포가 public 이 아니면 외부 디렉토리 PR 을 열 수 없습니다. visibility flip 은 #881 후속 별 operator-decision 트랙에서 처리되며 본 이슈는 그 결정을 강제하지 않습니다. visibility 가 private 인 한 본 이슈는 준비 상태로 holding 합니다.

목표

레포 public 전환 + Child 1·2·3 머지 완료 후, 3개 외부 디렉토리에 등재 PR open. 각 PR 본문은 README 의 한 줄 정체성 + landscape 위치 + Differentiator 를 짧게 인용.

Scope

In scope (모두 조건부, visibility flip 후):

• ai-boost/awesome-a2a PR — Brokers / Control-plane 섹션에 1줄 + 링크
• sing1ee/a2a-directory PR — 디렉토리 schema 에 맞춘 항목
• pab1it0/awesome-a2a PR — 1줄 + 링크
• 각 PR 본문 템플릿: README Hero / Differentiator 인용 + a2aproject 호환 disclaim
• docs/external-listings.md — 등재 현황 추적 (open PR / merged / declined)

Out of scope:

• 본 레포의 visibility flip 자체 — 별 operator-decision 트랙
• 신규 카테고리 정의 — 디렉토리 maintainer 가 결정
• 다른 디렉토리 광범위 등재 — 위 3개로 시작, 후속 별 이슈

사전조건 (Preconditions, 모두 충족 필요)

• 레포 visibility = public (별 operator-decision 트랙에서 승인 + 실행)
• Umbrella Child 1 (a2a-js 어댑터) 머지 — 외부 통합 경로 확보
• Umbrella Child 2 (inspector) CI 그린 evidence 1건 이상 — 외부 신뢰도 근거
• Umbrella Child 3 (README 재포지셔닝) 머지 — 첫인상 확보
• npm run scan:public-readiness 최신 머지 commit 에서 그린
• npm run scan:external-secrets (gitleaks) operator-run evidence 1건 이상 (관련: #881)

계획

1. 사전조건 모두 충족 확인 (체크리스트)
2. docs/external-listings.md 신규 — 추적 표 + PR 본문 템플릿
3. PR 본문 템플릿 draft 1개 (3 디렉토리 공통 base + 디렉토리별 형식 어댑테이션)
4. 3개 PR 순차 open (1개씩, maintainer 피드백 확인 후 다음)
5. merge / decline / 수정 요청에 따른 follow-up 처리
6. 매 PR 머지/리젝션 시 본 이슈에 evidence 링크 + docs/external-listings.md 업데이트

작업 단위

• GATED: 사전조건 6항목 모두 통과 확인
• docs/external-listings.md + PR 본문 템플릿 머지 (사전조건과 무관, 미리 준비 가능)
• ai-boost/awesome-a2a PR open
• sing1ee/a2a-directory PR open
• pab1it0/awesome-a2a PR open
• 각 PR 결과 (merged / declined / changes-requested) 본 이슈에 기록
• 모든 PR closure 후 본 이슈 close

증거 게이트

• 사전조건 체크리스트 모두 통과 evidence
• 3개 PR 각각의 URL + 결과
• 등재 PR 본문에 사적 토폴로지 노출 0 — 머지 전 self-review

안전 경계

• visibility flip 전 본 이슈의 action 항목은 실행 금지. 본 이슈는 준비/추적 용도.
• PR 본문에 노출되는 정보는 README + LICENSE + 공개 docs 만. 사적 endpoint / 노드 식별자 / runtime 메타데이터 노출 금지.
• 디렉토리 maintainer 와의 소통은 jinon86 identity 로, 머지/리젝션 무관 spam 회피 — 디렉토리당 최대 1 PR, decline 시 follow-up 별도 이슈.

비목표 / 추가 후속

• a2aproject upstream contribution — 본 이슈는 등재만. 표준 contribution 은 후속.
• 컨퍼런스 / 블로그 글 — 본 트랙 밖.

라벨 의도

no-go-public, operator-decision, public-transition, promotion-readiness — visibility flip 게이트 강조 + operator approval 필수.

참고

• Umbrella: Externalization track: external interop (a2a-js, a2a-inspector) + discoverability for a2a-nexus #1156
• 의존: Child 1, 2, 3 머지 + visibility flip.
• 인접 closed: #881 퍼블릭 전환 체크리스트, #439 공개 quickstart/demo 패키징.
• 외부 디렉토리: https://github.com/ai-boost/awesome-a2a , https://github.com/sing1ee/a2a-directory , https://github.com/pab1it0/awesome-a2a

[seoseo-ai]

Closeout — deferred / not planned until explicit operator approval

PR #1161 completed the in-repo preparation slice: docs/external-listings.md with preconditions, target directories, status table, and public-safe PR body template.

The issue body explicitly requires three external directory PR URLs/results. Those external PRs are public external actions and remain gated by fresh operator approval plus visibility/promotion review. They were not opened in this sweep.

Disposition: close as not planned / deferred for now to reach honest issue-zero state without pretending the external submissions occurred. Reopen or create a new operator-approved listing wave when you explicitly approve the three external PRs.

Verification:

• A2A round nexus-open-issues-allteam-20260630T1410Z finalizer: FINAL after supplements.
• PR feat: close out external interop readiness issues #1161 merged: 74ba36c2affef95663a588f930c6bfd6da622fda.
• npm test -w a2a-broker: 3721/3721 pass.
• npm run release-gate: pass.
• npm run scan:public-readiness: pass.
• npm run scan:external-secrets: pass with synthetic fixture findings only.
• added-line raw credential scan clean.

Safety: no live deploy/restart, provider/Telegram send, DB migration/prune/replay/ACK, release/tag/publish, secret movement, visibility change, or external directory PR was performed.

[seoseo-ai]

Operator-approved listing wave started

Fresh operator approval was received on 2026-07-01 KST (승인) to resume the public external directory listing work that was previously deferred.

External PRs opened from jinon86:

• ai-boost/awesome-a2a: Add A2A Nexus to Awesome A2A ai-boost/awesome-a2a#138
• sing1ee/a2a-directory: Add A2A Nexus to A2A Directory sing1ee/a2a-directory#35
• pab1it0/awesome-a2a: Add A2A Nexus to Awesome A2A pab1it0/awesome-a2a#71

Public-safety verification before opening:

• jinwon-int/a2a-nexus is public.
• npm run scan:public-readiness: pass.
• npm run scan:external-secrets: pass; accepted findings were synthetic fixtures only.
• External PR text self-review: no private topology, live broker URLs, node IDs, internal ports, Telegram/provider IDs, or secret-like strings.
• Existing ai-boost/awesome-a2a PR R4: protocol/API stability and no-live-exposure review #34 is an unrelated third-party NEXUS project and was not reused.

Tracking update PR: #1162

Keeping this issue open until the three external PR outcomes are known (merged / declined / changes requested) and recorded.