Skip to content

docs(trackers): publish compact adapter profiles for github-project, linear, and file per spec §11.2 #674

Description

@moncher-dev

Epic: #651
리포트 항목: A16docs/reports/2026-08-28-upstream-spec-drift-research.md (PR #650)

문제

새 스펙 §11.2(MUST): 각 어댑터는 코드가 아닌 문서로 compact profile을 공개해야 한다. 현재 packages/tracker-github/README.md(3줄), packages/tracker-linear/README.md(7줄)에는 아래 항목이 없다.

프로필에 들어갈 항목 (§11.2)

  • 지원하는 tracker.kind
  • tracker.provider 키, 기본값, 시크릿 키/env 이름(secretEnvironmentNames 포함), 검증 오류
  • scope 선택(project/board/team/repository), pagination, provider 요청 제한(page size, timeout, rate-limit 정책 — 2026-07-19 리포트 참조)
  • idnative_ref 매핑 (GitHub: issue node ID vs project item ID; Linear: issue id)
  • state(합성 Archived 포함)·label·priority·timestamp·dispatchable·malformed-record·optional-field 정규화 규칙
  • provider-native 툴 요약 (S21 문서 링크)
  • language-native 오류 → tracker_request/tracker_status/tracker_response/tracker_pagination/tracker_rate_limited/invalid_tracker_config/missing_tracker_secret 매핑 표

할 일

  • docs/trackers/github-project.md, linear.md, file.md 신설(또는 패키지 README 확장) + docs/README.md living documents 등록
  • docs/architecture.md §5에서 링크

완료 기준

  • 세 프로필이 위 항목을 모두 포함하고 S17에서 확정된 provider 키와 일치

Blocked by: #669

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationintegrationTracker / external system integrationspec-gapSymphony spec compliance gap

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions