테넌트 quality.yaml 게이트 키 누락 시 skip (NF 미생성)

주간/일간 NF(품질) 에이전트가 테넌트마다 다른 게이트를 돌릴 때, 설정 부재를 실패로 올리면 소음이 난다. .factory/quality.yaml 키 유무로 실행 vs skip을 가르고, NF 티켓은 실제 실패·회귀만 연다.

클라이언트·프로젝트 해석

신호정본함정
테넌트/클라이언트 목록오케스트레이터 agents.yaml의 clients[]live bridge.json에 clients가 없을 수 있음
client↔project 매핑이슈 트래커 list_projects(또는 동등)로 추론bridge만 보고 매핑하면 누락

게이트 키 ↔ 실행 조건

테넌트 repo의 .factory/quality.yaml에서 해당 키가 있을 때만 명령을 실행한다.

게이트필수 키(예)키 없음
clean_codeclean_code.commandskip + 사유 기록, NF 없음 — CI 3단 정합은 Quality-Yaml-Clean-Code-CI-Align.md
bulk_apibulk_api (endpoints/command)skip + 사유, NF 없음
opikopik: (project_name/dataset/command)skip; fail/regression만 NF — Spider2 weekly는 Spider2-Quality-Gate-nl2sql.md
loadload.command (test env)skip + 사유; 실패만 NF — chat SSE 하네스 In-Process-ASGI-Load-Harness-Pattern.md
securitysecurity.command키 없으면 mechanical skip; AA는 tip↔merge 스킴(auth/Host/secret/transport/router/admin surface delta만) + 관련 unit 증거로 대체 — 없는 SAST·보안 커맨드를 발명하지 않음. 증거 문구에 `aa: security pass
e2e (참고)e2e:UI 스모크 축 — Playwright-Frontend-UI-Smoke-Pattern.md
# 최소 골격 예 — 쓰는 게이트만 채운다
# clean_code:
#   command: "..."
# bulk_api:
#   endpoints: [...]
#   command: "..."
# opik:
#   project_name: "..."
#   dataset: "..."
#   command: "..."
# load:
#   command: "..."
# e2e:
#   ...

운영 규칙

  1. 파일 자체 없음 = 모든 게이트 skip (사유: no .factory/quality.yaml). 예: 일부 제품 레포에 yaml이 없으면 clean_code도 skip이며 NF를 만들지 않는다.
  2. 파일은 있으나 키만 없음 (예: e2e만 존재) = 해당 게이트만 skip. 다른 축(Playwright vs SQL EX)과 혼동하지 않는다 — Spider2-Quality-Gate-nl2sql.md.
  3. NF 티켓: skip ≠ 실패. 실행 후 실패·회귀만 클라이언트 project_id에 New NF. 이미 테스트로 봉인된 회귀(예: SQL 재방출 방지)는 tip green만으로 새 스멜 티켓을 올리지 않는다.
  4. CD Done 게이트: tenant_cd-registry의 tenants가 비어 있으면 그 NF 런의 feature Done 게이트는 해당 없음(스킵). 빈 레지스트리를 장애로 올리지 않는다.
  5. MCP discovery가 깨져도 Active 스케줄 티켓은 JSON-RPC fallback(getTicket/addComment)으로 마감 가능 — MCP-Python-Package-Skew-Import-Failure.md, path-graph-Argo-ImagePullBackOff-runbook.md Closeout pitfall.
  6. 워크스페이스 ingest 카운터: full-scan done은 ingestUri 델타 성공만. skip/실패를 done에 넣으면 그래프 누락이 완료 로그에 가려진다 — Workspace-Ingest-Done-Vs-Skipped-Counter.md.

적용 팁

  • 새 테넌트 온보딩 체크리스트에 “quality.yaml에 돌릴 게이트 키를 명시했는가?”를 넣는다. 키 없이 스케줄만 켜면 영구 skip이다.

  • 주간 리포트 문구는 skip(사유)와 NF=0을 분리해 적어, “안 돌림”과 “통과”를 구분한다.

  • clean_code는 CI backend 3단과 맞출 것 — Quality-Yaml-Clean-Code-CI-Align.md.

  • clean_code 스멜 티켓화: mechanical green 이후 High/Med만 제품 티켓. 인프라 list/parse 실패를 []로 삼키면 manifest_missing false-pass — loader는 repo_list_failed/invalid_json 등으로 단락(short-circuit)할 것.

  • load chat SSE는 In-Process-ASGI-Load-Harness-Pattern.md.

  • dirty working tree → sync skip (no stash) — Tenant-Repo-Sync-Dirty-Tree-Skip.md.

2026-10-05 주간 NF (ta/aa/qa)

Registry: sw-factory / crewrp / uni-tutor (nl2sql not in persona registry → out of scope).

스케줄결과
ta-load-weekly3 repo 모두 no load.command → skip; NF=0
aa-clean-weekly3 repo 모두 no clean_code.command → skip; High/Med=0
qa-bulk-weekly3 repo 모두 no bulk_api/opik → skip; factory /api/health 200 qa: pass; sw-factory dirty sync skip

Active 없는 스케줄 → orphan Outcome 금지. 장시간/nf-progress: N/A (명령 미기동).

2026-10-12 주간 NF (ta/aa/qa)

동일 registry 3 repo. tip sync 후 Discover — .factory/quality.yaml 게이트 키 없음 → 전수 skip; NF New=0.

스케줄결과
ta-load-weekly3 repo no load.command → skip; NF=0
aa-clean-weekly3 repo no clean_code: → skip; High/Med=0
qa-bulk-weekly3 repo no bulk_api/opik → skip; factory /api/health 200 qa: pass; sw-factory dirty WT → sync skip (behind origin; no stash)

Active 없는 스케줄 → orphan Outcome 금지. nf-progress: N/A.

2026-10-19 주간 NF (ta/aa/qa)

동일 registry 3 repo (sw-factory / crewrp / uni-tutor). tip sync 후 Discover — .factory/quality.yaml 전무 → 전수 skip; NF New=0.

스케줄결과
ta-load-weekly3 repo no load.command → skip; NF=0; uni-tutor project list 403 (멤버십) — path sync만
aa-clean-weekly3 repo no clean_code: → skip; High/Med=0; not a prod gate
qa-bulk-weekly3 repo no bulk_api/opik → skip; factory /api/health 200 qa: pass; sw-factory dirty WT (package.json/package-lock.json) → sync skip (no stash); tip 8e6f8af origin-only

Active 없는 스케줄 → orphan Outcome 금지. nf-progress: N/A (명령 미기동).

2026-10-26 주간 NF (ta/aa/qa)

동일 registry 3 repo (sw-factory / crewrp / uni-tutor). tip sync 후 Discover — .factory/quality.yaml 전무 → 전수 skip; NF New=0.

스케줄결과
ta-load-weekly3 repo no load.command → skip; NF=0; uni-tutor project GET 403 (멤버십) — path sync만. nl2sql은 registry 밖
aa-clean-weekly3 repo no clean_code: → skip; High/Med=0; not a prod gate. nl2sql clean_code.command는 registry 밖
qa-bulk-weekly3 repo no bulk_api/opik → skip; factory /api/health 200 qa: pass; sw-factory dirty WT (package.json/package-lock.json, @rollup/rollup-linux-arm64-gnu) → sync skip (HEAD behind origin; no stash)

Active 없는 스케줄 → orphan Outcome 금지. factory-mcp Cursor namespace 미노출 시 session-cookie REST fallback. nf-progress: N/A (명령 미기동).

2026-11-02 주간 NF (aa/qa)

레지스트리 변경: 이전 주 3 repo (sw-factory / crewrp / uni-tutor) → 이번 주 4 repo (sw-factory / crewrp / sql-mcp / rhwp_batch). uni-tutor checkout은 워크스페이스에 남아 있으나 registry 밖, nl2sql .factory/quality.yaml clean_code.command도 registry 밖으로 범위 외.

스케줄결과
aa-clean-weekly4 repo (sw-factory/crewrp/sql-mcp/rhwp_batch) 모두 .factory/quality.yaml 및 clean_code: 없음 → skip; High/Med=0; NF New=0; prod 게이트 아님
qa-bulk-weekly4 repo 모두 .factory/quality.yaml (bulk_api/opik) 없음 → skip; factory GET /api/health 200 {"ok":true,"service":"sw-factory-workers"}; sw-factory dirty WT (package.json/package-lock.json, no stash, HEAD 690c726 behind origin/main 8e6f8af by 72) → sync skip

Active ticket_id 없는 스케줄 → orphan Outcome 금지, feature Done 게이트 해당 없음 (tenant-cd-registry.json 부재). factory-mcp Cursor namespace 미노출 시 FactoryClient(session-cookie REST) fallback. nf-progress: N/A (mechanical 명령 미기동).

2026-11-09 주간 NF (aa/qa)

  • aa-clean-weekly / qa-bulk-weekly: tenant-repo-sync 6/6 OK (sw-factory, crewrp, sql-mcp, rhwp_batch, aura, candidate.win). dirty 없음 → stash 없음.
  • Discover: 전 클라이언트 clean_code / bulk_api·opik 키 없음 → skip · NF New 티켓 0 (실패 아님).

2026-11-16 주간 NF (ta/aa/qa)

Registry 7 tip sync (sw-factory · crewrp · sql-mcp · rhwp_batch · aura · candidate.win · +1). Discover: 전부 .factory/quality.yaml 게이트 키 없음 → skip; NF New=0.

스케줄결과
ta-load-weekly7 repo no load.command → skip; NF=0
aa-clean-weekly7 repo no clean_code: → skip; High/Med=0; not a prod gate
qa-bulk-weekly7 repo no bulk_api/opik → skip; factory GET /api/health 200 qa: pass; Opik N/A (skill/key 부재); nf-progress: complete

factory-mcp 미노출 → session-cookie REST. Active 없는 스케줄 → orphan Outcome 금지(해당 스케줄 create-once 정책이 있으면 그 계약).

🔗 관련 문서