테넌트 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_code | clean_code.command | skip + 사유 기록, NF 없음 — CI 3단 정합은 Quality-Yaml-Clean-Code-CI-Align.md |
| bulk_api | bulk_api (endpoints/command) | skip + 사유, NF 없음 |
| opik | opik: (project_name/dataset/command) | skip; fail/regression만 NF — Spider2 weekly는 Spider2-Quality-Gate-nl2sql.md |
| load | load.command (test env) | skip + 사유; 실패만 NF — chat SSE 하네스 In-Process-ASGI-Load-Harness-Pattern.md |
| security | security.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:
# ...운영 규칙
- 파일 자체 없음 = 모든 게이트 skip (사유: no
.factory/quality.yaml). 예: 일부 제품 레포에 yaml이 없으면clean_code도 skip이며 NF를 만들지 않는다. - 파일은 있으나 키만 없음 (예:
e2e만 존재) = 해당 게이트만 skip. 다른 축(Playwright vs SQL EX)과 혼동하지 않는다 — Spider2-Quality-Gate-nl2sql.md. - NF 티켓: skip ≠ 실패. 실행 후 실패·회귀만 클라이언트
project_id에 New NF. 이미 테스트로 봉인된 회귀(예: SQL 재방출 방지)는 tip green만으로 새 스멜 티켓을 올리지 않는다. - CD Done 게이트:
tenant_cd-registry의tenants가 비어 있으면 그 NF 런의 feature Done 게이트는 해당 없음(스킵). 빈 레지스트리를 장애로 올리지 않는다. - MCP discovery가 깨져도 Active 스케줄 티켓은 JSON-RPC fallback(
getTicket/addComment)으로 마감 가능 — MCP-Python-Package-Skew-Import-Failure.md, path-graph-Argo-ImagePullBackOff-runbook.md Closeout pitfall. - 워크스페이스 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_missingfalse-pass — loader는repo_list_failed/invalid_json등으로 단락(short-circuit)할 것. -
loadchat 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-weekly | 3 repo 모두 no load.command → skip; NF=0 |
| aa-clean-weekly | 3 repo 모두 no clean_code.command → skip; High/Med=0 |
| qa-bulk-weekly | 3 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-weekly | 3 repo no load.command → skip; NF=0 |
| aa-clean-weekly | 3 repo no clean_code: → skip; High/Med=0 |
| qa-bulk-weekly | 3 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-weekly | 3 repo no load.command → skip; NF=0; uni-tutor project list 403 (멤버십) — path sync만 |
| aa-clean-weekly | 3 repo no clean_code: → skip; High/Med=0; not a prod gate |
| qa-bulk-weekly | 3 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-weekly | 3 repo no load.command → skip; NF=0; uni-tutor project GET 403 (멤버십) — path sync만. nl2sql은 registry 밖 |
| aa-clean-weekly | 3 repo no clean_code: → skip; High/Med=0; not a prod gate. nl2sql clean_code.command는 registry 밖 |
| qa-bulk-weekly | 3 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-weekly | 4 repo (sw-factory/crewrp/sql-mcp/rhwp_batch) 모두 .factory/quality.yaml 및 clean_code: 없음 → skip; High/Med=0; NF New=0; prod 게이트 아님 |
| qa-bulk-weekly | 4 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-weekly | 7 repo no load.command → skip; NF=0 |
| aa-clean-weekly | 7 repo no clean_code: → skip; High/Med=0; not a prod gate |
| qa-bulk-weekly | 7 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 정책이 있으면 그 계약).
🔗 관련 문서
- Agentic-Software-Factory.md
- Tenant-Marketing-Yaml-Persona-Overlay-Pattern.md
- Playwright-Frontend-UI-Smoke-Pattern.md
- Quality-Yaml-Clean-Code-CI-Align.md
- Workspace-Ingest-Done-Vs-Skipped-Counter.md
- In-Process-ASGI-Load-Harness-Pattern.md
- Tenant-Repo-Sync-Dirty-Tree-Skip.md
- MCP-Python-Package-Skew-Import-Failure.md
- Wiki-Synthesis-Policy.md
- Spider2-Quality-Gate-nl2sql.md