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 --check | CI에 없고 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로 올리지 않는다.