quality.yaml clean_code = CI backend 3단 정합

주간 AA clean_code가 ruff-only면 CI backend job과 어긋나 주간에만 통과하는 드리프트가 난다. 게이트 커맨드를 CI와 동일 3단으로 맞춘다.

패턴

# .factory/quality.yaml (개념)
clean_code:
  command: >-
    cd backend && uv sync --extra dev --locked
    && uv run ruff check .
    && uv run mypy src
    && uv run pytest

스키마 테스트로 “세 단계 존재”를 assert한다 (예: test_quality_yaml_*.py).

주간에서 빼는 것

항목이유
ruff format --checkCI에 없고 drift 많으면 상시 red
frontend lint별도 CI job·시간
언어별 sidecar (예: mcp cargo)주간 AA 스코프 밖

키 자체가 없으면 skip — Tenant-Quality-Yaml-Gate-Skip-Pattern.md. stub echo를 examples에서 복사하지 않는다.

머지 충돌 시 ci 스크립트 보존 및 워크스페이스 컴파일 순서

충돌 해소로 package.json의 "ci": "npm test && …" 같은 게이트 포인터가 빠지면 clean_code/AA가 깨진다. 리팩터 PR을 합칠 때 기존 ci/test:vscode 키를 한쪽 브랜치에서만 갖고 있으면 양쪽을 유지한 뒤 CI를 다시 돌린다.

  • npm workspaces topo-sort 부재: npm workspaces는 패키지 간 의존 관계에 따라 스크립트를 위상 정렬(topo-sort)하여 실행하지 않는다. 또한 ts-jest는 프로젝트 레퍼런스를 자동으로 빌드하지 않는다.
  • 컴파일 선행 필수: 호스트 단위 테스트(Jest)가 내부 패키지의 빌드 산출물(dist/의 main 및 types)을 참조하는 구조라면, ci 스크립트는 반드시 컴파일이 테스트보다 앞서야 한다:
    "ci": "npm run compile && npm test && npm run test:vscode"
  • 순서 가드: scripts/packageScripts.test.cjs 등 정적 스크립트 테스트에서 ci 정의 문자열 내 npm run compile이 npm test보다 먼저 등장하는지 assert하여 스크립트 드리프트를 방지한다.
  • 헤드리스 soft-skip: npm --prefix extension run ci는 compile 선행 후 exit 0이 정본. xvfb가 없으면 test:vscode는 의도적 soft-skip(실패 아님). 주간 AA는 soft-skip을 NF로 올리지 않는다.

🔗 관련 문서