파일럿 PR-001 워크플로우 기록 (PG606 11단계 ↔ GitHub 구현)¶

본 문서는 매뉴얼 3종(TC개발가이드 · 전환매뉴얼 · 사용자가이드)의 부록 자료입니다. 트랙 A(운영체계) 검증을 목적으로, 표준 제·개정 절차의 각 단계를 GitHub 기능에 매핑하고 파일럿 PR-001 (프로파일 다축 분류 + 자체 어휘 신설) 을 통해 실제 흐름이 가능한지 시연한 결과를 기록합니다.

0. 파일럿 개요¶

항목	내용
파일럿 ID	PR-001 + PR-001-fix + PR-002 (3개 PR로 분리 시뮬레이션)
시연 일자	2026-05-10
변경 영역	`vocabularies/aird/` (신규), `mappings/` (신규 매핑 1건 + 후속 보정), `profiles/README.md`, `vocabularies/README.md`
변경 성격	어휘/인프라 (특정 P-XX 표준 단위 아님)
파일럿 산출물	`ISSUE.md`, `PR.md`, `PR-FIX.md`, 본 `WORKFLOW_LOG.md` + 실제 변경 파일들
환경 제약	본 작업 환경에는 git 원격이 연결되어 있지 않으므로 실제 GitHub Issue/PR 등록은 미시행. 본문·체크리스트·매핑 표만 산출
시뮬레이션 주의	실파일은 PR-001 머지 + PR-001-fix 머지 후의 최종 상태로 저장됨. PR.md / PR-FIX.md는 시뮬레이션상 분리된 두 단계의 PR 본문이며, 실파일 상태와 PR.md 본문 사이의 일시적 불일치는 시뮬레이션의 부산물 — PG606 제출용 패키지에는 최종 정합 상태가 들어감

1. 11단계 ↔ GitHub 매핑 + 시연 결과¶

단계	TTA 절차	GitHub 구현	본 파일럿에서	갭 / 보완 사항
① 과제 제안	제안서 제출	Issue 생성 (템플릿 적용)	`ISSUE.md` 작성	갭: 본 PR은 어휘/인프라 변경이라 기존 템플릿 2종 부적합 → 신규 템플릿 필요
② 접수	사무국 접수·번호 부여	Issue 자동 라벨링 (`.github/labeler.yml`)	(미시행)	OK — 라벨러 이미 존재
③ IPR 확인	권리 확약 검토	Issue 본문 6번 항목 + 라벨 확인	ISSUE.md §5 IPR 항목	OK
④ 타당성 검토	PG606 사무국 (2~4주)	Issue 댓글 + GitHub Discussion	(미시행)	수기 보완 필요: 사무국의 정식 결정 통지는 Issue 댓글로 충분한가? 회의록·정족수 어떻게 기록?
⑤ 채택	라벨 변경 (proposal:adopted)	`proposal:received` → `proposal:adopted` 라벨 변경	(미시행)	OK
⑥ IPR 재확인	변동 점검	Issue 본문 갱신 + 라벨 확인	(미시행)	OK
⑦ 초안 작성	초안 패키지 작성	feature 브랜치 + 파일 작성	6개 파일 작성/수정	OK
⑧ 의견 수렴	공개 의견 수렴	PR 생성 + 공개 댓글	`PR.md` 작성	OK (단, 외부 의견 수렴 기간을 PR에서 어떻게 관리할지 정책 필요)
⑨ 의견 검토	동료 검토 (외부 2인+)	PR Review (CODEOWNERS + 추가 reviewer)	PR.md "리뷰 요청 대상" 명시	수기 보완 필요: 외부 전문가가 GitHub 계정이 없는 경우 처리
⑩ 심의	위원회 심의	CI 통과 강제 (Required checks) + Branch protection	(CI 미시행 — 환경 제약)	갭: TTA 위원회 정족수 의결을 GitHub merge 권한과 동치로 인정하는 규정 정비 필요
⑪ 공고	정식 발행	merge + git tag + Pages 자동 배포	(미시행)	OK — `.github/workflows/publish.yml` 존재

2. 본 파일럿이 발견한 핵심 갭 (제도개선안 핵심)¶

갭 A: 이슈 템플릿 부재¶

현상: proposal-new-standard.md(표준 단위), standard-task.md(WBS 작업 단위) 두 종류만 존재
부재: 어휘/인프라 변경, 매핑 추가, CODEOWNERS 변경, CI/거버넌스 변경 등 표준 단위가 아닌 운영 변경
권고: .github/ISSUE_TEMPLATE/vocabulary-or-infra-change.md 신설

갭 B: 정족수·회의록 표현 미정의¶

현상: TTA 표준 제·개정 절차는 PG/TC 회의 정족수·서면 의결 등 GitHub로 직접 표현되지 않는 절차를 포함
현 운영 모델: 마스터(GitLab) ↔ 미러(GitHub) 분리로 우회하지만, 마스터 측 회의록과 GitHub 산출물의 연동 절차가 미정의
권고: 회의록 PDF를 PR에 첨부 + 의결 결과를 PR 댓글로 명시하는 운영 규정 신설. 또는 CODEOWNERS의 승인을 의결로 간주하는 규정 명문화

갭 C: 외부 전문가 GitHub 미보유 케이스¶

현상: L3 외부 전문가 검토는 동료 검토 2인 이상 필수. GitHub 계정이 없는 전문가의 의견 등록 경로 미정의
권고: 외부 전문가 의견서를 별도 PDF로 PR에 첨부하고, PR 작성자가 댓글로 대리 등록하는 절차 명문화

갭 D: CODEOWNERS 영역 누락¶

현상: /mappings/, /vocabularies/aird/ 영역의 owner 미명시 → 기본 owner(@tta-pm) 단독 승인
권고: 본 파일럿 머지 직후 후속 PR로 CODEOWNERS 갱신

갭 F: WBS 코드 부여 절차 부재¶

현상: 트랙 A 파일럿 작업이 정식 WBS 코드(C-5 등)에 매핑되지 않아, PR 본문 "관련 WBS" 항목 작성 시 임시 식별자(PR-001)를 사용해야 함
권고: 트랙 A(운영체계) 작업도 WBS 코드 체계에 포함하거나, 별도 식별 체계(예: PR-NNN)를 표준화 지침 개정안에 명시

갭 H: 외부 어휘·매핑 추가 시 용어집 동시 갱신 강제 규칙 부재¶

현상: PR-001이 aird-datatype-to-schemaorg.ttl 매핑을 도입하면서 schema.org를 외부 어휘로 처음 사용했으나, docs/glossary.md ⑤ 섹션이 동시 갱신되지 않아 schema.org 항목 누락 + 통합 분류 부재가 노출됨
시뮬레이션 후속 처리: PR-002 (별도 PR)로 ⑤ 섹션 재구성 — 4개 하위표 중 어휘·표준 두 표를 단일 표로 통합 + 발행 기관 컬럼 신설 + schema.org 행 추가 + 표준화 기관 표에도 schema.org Community Group 등 5개 발행 기관 보강
권고:
(즉시) PR 템플릿(PULL_REQUEST_TEMPLATE.md) 체크리스트에 "신규 외부 어휘 도입 시 docs/glossary.md ⑤ 섹션 갱신 필수" 항목 추가
(자동) CI 단계에서 mappings/ · vocabularies/cached/MANIFEST.json 의 prefix 사용 어휘가 glossary에 모두 등재되었는지 자동 검증 (예: tta-verify-mappings 도구 확장)
(거버넌스) CONTRIBUTING.md에 "외부 어휘 신규 채택 = ⑤ 섹션 갱신 강제 + 4계층 품질 보증 L2 PM 검토 필수" 명시

갭 G: 소규모 후속 보정의 절차 표현 부재 (PR-001-fix 시뮬레이션이 노출한 4가지 하위 갭)¶

본 파일럿은 PR-001 머지 직후 발견된 SKOS 매핑 술어 오류를 별도의 작은 PR(PR-001-fix)로 분리하여 처리하는 흐름을 시뮬레이션했습니다. 이 과정에서 다음 4가지 하위 갭이 추가로 노출되었습니다.

G-① 소규모 변경의 절차 부담¶

현상: PR-001-fix는 단일 파일 5라인 변경. 그러나 11단계 절차서는 변경 규모와 무관하게 동일 절차를 강제하는지, fast-track이 가능한지 명시되지 않음
권고: PG606 운영 세칙에 "경미 변경(minor change)" 정의 + fast-track 절차(예: L3 외부 검토 면제, CI 통과만으로 머지) 신설 검토. 경미 변경 판정 기준 예시:
단일 파일, N라인 이하
의미론(semantics) 변경 없음 (오타, 매핑 술어 보정 등)
외부 표준 인용·매핑의 정확성 보정만 해당

G-② PR 간 의존 관계 표현 부재¶

현상: PR-001-fix는 PR-001의 후속·보정 관계인데, GitHub에서 이 관계를 표현할 표준 방식이 절차서에 없음
표현 후보: Refs #N 메시지, GitHub Linked PRs, milestone, parent issue
권고: PG606 운영 세칙에 후속 PR 식별 명명 규칙(예: PR-NNN-fix, PR-NNN-followup) + GitHub 메타데이터 사용 정책 명시

G-③ 회의 정족수의 한계 사례¶

현상: 갭 B(회의록 정족수)와 직결. 술어 1건 보정도 위원회 의결·정족수가 필요한가? 절차서에 명시 부재
권고: G-① 의 fast-track 절차와 통합 — 경미 변경은 정족수 의결 면제·간사 단독 승인 등 차등 적용 검토

G-④ 변경 이력 audit trail의 가독성¶

현상: 보정을 단일 PR 내 추가 commit으로 처리하는 방식과 별도 PR로 분리하는 방식 중 어느 쪽이 PG606 사후 검토·감사에 적합한가가 명시되지 않음
시뮬레이션 결과: 별도 PR 분리 방식이 변경 이유의 추적성·접근성에서 우수했음. 단일 PR 내 commit history는 GitHub UI에서 한 단계 더 들어가야 보임
권고: 의미적으로 분리 가능한 변경은 별도 PR로 분리하는 것을 원칙화. 단, G-① fast-track 적용 가능

갭 E: 위원회 의결 ↔ Merge 권한 동치성¶

현상: TTA 절차서가 GitHub Merge를 정식 의결로 인정하는지 불분명
권고: PG606 운영 세칙에 다음 조항 신설 검토:

"본 사업의 산출물 저장소에서 발생한 PR Merge는 다음 조건을 모두 충족할 때 정식 의결로 간주한다: ① 4계층 품질 보증 모두 통과, ② CODEOWNERS의 영역별 승인, ③ CI Required Checks 모두 통과, ④ 의견 수렴 기간(최소 N일) 경과."
PR-003 (#18) 시뮬레이션이 보강한 사례: 인프라 변경 PR-003은 Draft·외부 검토·정족수 의결 없이 본인 머지로 즉시 main에 반영됨. 변경 위험도가 낮을 때 fast-track 적용이 실제 가능함을 시연하면서 동시에 "fast-track 적용 기준"이 절차서에 명시되지 않은 갭을 노출.

갭 I: PR preview 부재 (PR-003 #18 머지로 1차 해소)¶

현상: 검토자가 mkdocs-material 디자인이 적용된 변경 결과를 볼 수 없어 markdown 원본만으로 시각적 검토 수행. 텍스트 렌더링과 사이트 디자인이 다르게 보이는 표·코드블록·admonition 등에서 검토 품질 저하
1차 해소: PR-003 (#18) 머지로 pages-preview.yml + pages-preview-cleanup.yml + pages.yml 재작성 도입. PR마다 https://ai-ready-standards.github.io/tta-ai-ready/pr-<번호>/ 자동 생성, PR 닫힘 시 자동 정리, 미리보기 URL 자동 코멘트
잔여 권고: PR 템플릿 체크리스트에 "검토자에게: 본 PR의 미리보기 URL을 클릭해 사이트 디자인이 적용된 결과를 확인" 항목 추가

갭 J: mkdocs `--strict` 빌드 실패 가능성 — nav 누락 / 외부 경로 링크¶

현상: pages.yml CI는 mkdocs build --strict 를 실행. 이 모드는 다음을 빌드 실패로 처리:
nav 미등록 markdown 파일 (orphan)
mkdocs docs_dir 외부를 가리키는 markdown 링크
본 PR-001은 6개 pilot 파일 nav 미등록 + ISSUE.md 가 docs/ 외부의 profiles/README.md 를 상대 경로로 링크 → 두 갭이 동시 노출
1차 해소: PR-001 후속 커밋(3859c16)으로 mkdocs.yml 에 "사업 문서 → 파일럿 시연" nav 섹션 6개 항목 추가 + ISSUE.md 의 깨진 상대 링크를 GitHub 절대 URL로 교체
권고:
(절차) PR 템플릿에 "신규 docs/ markdown 추가 시 nav 등록 또는 exclude_docs 명시" 체크리스트 항목 추가
(자동) CI에 mkdocs build --strict 외에도 별도 nav 정합성 검증 단계 신설 검토

2-A. 갭 요약표 (제도개선안 핵심 항목)¶

갭	영역	우선순위
A	어휘/인프라 변경용 이슈 템플릿 부재	높음
B	회의 정족수·서면 의결의 GitHub 표현 미정의	높음
C	외부 전문가(GitHub 미보유) 의견 등록 경로 미정의	중간
D	`/mappings/`, `/vocabularies/aird/` CODEOWNERS 누락	낮음 (즉시 보완 가능)
E	위원회 의결 ↔ Merge 권한 동치성 규정 부재	높음
F	WBS 코드 부여 절차 부재 (트랙 A 작업)	중간
G	소규모 후속 보정의 절차 표현 부재 (G-①~④)	높음 (잦은 발생 예상)
H	외부 어휘·매핑 추가 시 용어집 동시 갱신 강제 규칙 부재 (PR-002로 보정 시연)	높음 (자동 검증 가능)
I	PR preview 부재 (PR-003 #18 머지로 1차 해소)	높음 → 해소
J	mkdocs `--strict` 빌드 실패 가능성 — nav 누락 / 외부 경로 링크 (PR-001 후속 커밋으로 1차 해소)	중간 → 해소

3. 매뉴얼별 부록 활용 안내¶

매뉴얼	본 기록의 활용
TC개발가이드 v0.5	§1.절차 매핑 표를 부록으로 첨부, §2.갭 A~E를 "TC 단계별 보완 권고"로 인용
전환매뉴얼 v0.5	기존 표준의 GitHub 전환 시 동일한 워크플로우 적용 가능함을 본 사례로 입증
사용자가이드 v0.5	외부 기여자가 Issue→PR을 어떻게 작성하는지의 실제 예시로 `ISSUE.md`, `PR.md` 첨부

4. 후속 파일럿 권고¶

파일럿	시연 목적	상태
PR-001 (#17)	다축 분류 + AI Ready Data 자체 어휘 — 트랙 B 컨텐츠 + 갭 A~G 시연	Draft, 검토 진행 중
PR-002	glossary.md ⑤ 섹션 통합표 재구성 + schema.org 추가 — 갭 H 시연	PR-001 안에 시뮬레이션 포함
PR-003 (#18)	PR preview 인프라 — 갭 I 해소	머지 완료, Pages source 전환 완료
PR-004	표준 단위(P-01~P-05) 변경 — `standard-task.md` 템플릿 활용	높음
PR-005	외부 어휘 캐시 자동 갱신 (`vocab-refresh.yml`) — 봇 PR 흐름 시연	중간
PR-006	CODEOWNERS 갱신 자체를 PR로 — 거버넌스 변경 절차 시연	중간
PR-007	SHACL shape 추가 + CI 검증 실패→통과 시연	높음

5. 결론¶

본 파일럿(PR-001 + PR-001-fix + PR-002 시뮬레이션 + PR-003 실제 구현)은 PG606 11단계 중 ⑦~⑪의 GitHub 구현 가능성을 산출물 형태로 시연했고, ①~⑥의 이슈 단계까지 본문을 작성하여 전 흐름의 실현 가능성을 보였습니다. 또한 PR-001-fix 시뮬레이션을 통해 소규모 후속 보정 흐름까지, PR-003 실제 구현을 통해 인프라 자가-개선 흐름까지 시연했습니다.

갭 A~J 10건 중 PR-003 머지로 갭 I, PR-001 후속 커밋으로 갭 J가 해소됐으며, 잔여 갭 A~H 8건은 GitHub 단독으로 해결되지 않으며 PG606 운영 세칙 수준의 제도 정비를 요구하므로, 본 사업의 핵심 산출물인 표준화 지침 개정(안) 에 갭 A~H 대응 조항을 반영할 것을 권고합니다.