<p align="center">
<img src="https://raw.githubusercontent.com/kingxiaozhe/cm-workflow/HEAD/assets/readme/hero.svg" width="100%" alt="CM은 Create More를 의미합니다: 요구사항을 사양, 테스트 및 검토 기록이 있는 코드 전달로 만듭니다">
</p>
CM Workflow
Codex 또는 Claude Code에 설치되는 사양 주도 개발 워크플로우입니다. 명확한 요구사항 정의, 수동 확인부터 구현, 독립 검토 및 테스트까지, 모든 결과물에 검증 가능한 근거를 제공합니다.
<p>
<a href="https://github.com/kingxiaozhe/cm-workflow/actions/workflows/ci.yml"><img src="https://github.com/kingxiaozhe/cm-workflow/actions/workflows/ci.yml/badge.svg" alt="CI status"></a>
<a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-151515" alt="MIT License"></a>
<img src="https://img.shields.io/badge/Codex-native-2E6655" alt="Codex native">
<img src="https://img.shields.io/badge/Claude%20Code-compatible-C44B32" alt="Claude Code compatible">
</p>
빠른 시작 · 이전 버전 업그레이드 · 명령 선택 · 지원 범위 · 사용 설명서 · 업데이트 기록
최근 업데이트
0.20.0
- 필수 검증 계약 (수동 활성화 필요): 작업, 관련 AC 또는 유스케이스에
必验:(필수 검증), 必跑测试:(필수 테스트 실행), 必跑检查:(필수 점검 실행) 등 명확한 태그를 작성하면, 새 실행은 이 필수 검증 목록을 동결합니다. 개발 보고서는 항목별로 답변해야 하며, 완료 전에 증거 자료를 확인해야 합니다. 태그가 없는 이전 사양은 기존대로 실행됩니다.
- 명령어는 명시된 내용만 인식: 본 줄, 상위 줄 또는 제목에
必跑检查:와 같이 명시된 명령만 실행을 요구받습니다. “실행 금지” 또는 예시에 있는 명령어는 영향을 받지 않습니다.
- 읽기 전용 조회: 승인 전 검수 미리보기(
cm-acceptance-preview.mjs), 계층별 완료 요약(작업, 기능, 프로젝트, 마무리 분리 표시), 차단 설명, 수동 인수 및 배포 선언(cm-delivery-evidence.mjs), 실행 시간 및 사용량 분석(cm-run-analysis.mjs)을 수행합니다.
- 업그레이드 주의사항 (상시 권한이 더 엄격해짐): tasks.md에서 기존 조항을 수정해도 자동으로 승인되지 않으며, 항목별로 검수가 약화되지 않았음을 증명해야 합니다. 설계 추가, 새 작업 소제목, 의존성 추가는 여전히 자동 승인이 가능합니다. 자세한 내용은 업데이트 기록을 참조하십시오.
0.19.0
- 작업별 테스트를 위험도에 따라 계층화:
/cm:prd로 작업을 분할할 때 단위 테스트는 모두 실행하고, 인터페이스 테스트는 본 작업에서 새로 작성된 것과 직접적으로 연관된 기존 테스트만 실행하며, 기능 마지막에 전체 회귀 테스트를 수행합니다. 공통 모듈을 수정했으나 연관 테스트가 실행되지 않은 경우, 개시 건강 검진(체크업) 시 알림이 발생합니다 (연관 관계는 프로젝트 TESTING.md의 「연관 테스트」 표에 기록됩니다).
- 개발 중 사양 변경은 한 번만 확인: 제안 카드는
⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.
- 업그레이드 주의사항 (개발 방식):
/cm-ai의 새 배치는 기본적으로 tasks.md를 따라 자동으로 그룹화되며, 조건에 맞는 작업들은 각각 worktree에서 개발되고 독립적인 작업은 병렬로 진행됩니다. 기능 종료 작업, 장치 사용 작업 및 일부 QA 시나리오는 여전히 메인 디렉토리에서 순차적으로 처리됩니다. 프로젝트 설정에 parallel: {enabled: false}를 작성하면 worktree가 전혀 생성되지 않으며, parallel: {worktree_all: false}를 작성하면 이전처럼 병렬 처리가 가능한 작업만 worktree로 진입하는 방식으로 복구됩니다. 업그레이드 전에 시작된 실행 및 배치는 원래 설정에 따라 복구됩니다.
- 업그레이드 주의사항 (설치): 설치 프로그램은 누락된 작성자 스킬을 기본적으로 설치하고, 스킬 알림 훅(skill hints hook)도 기본으로 연결합니다. TypeSafe 키가 있는 경우, 세 가지 자동 호출 스킬이 메시지의 처음 500자를 외부 서비스로 전송하여 판단하게 합니다. 원하지 않는 경우: 설치 시
--no-matt-skills, --no-skill-hints를 추가하고; 이미 연결된 훅은 로컬 파일에 `
⚠️ [IMG:N]
/cm:notify 추가 (Codex에서는 $cm-notify): 멈춤, 종료, 대기 상태의 휴대폰 알림을 Bark(iOS)와 pushplus(위챗) 사이에서 하나의 명령으로 전환할 수 있으며, 동시에 하나만 활성화됩니다. 두 채널에 키가 제대로 입력되었는지 확인할 수 있습니다 (내용은 표시하지 않고 입력 여부만 표시). 테스트 푸시를 보내 실제로 수신되는지 확인하거나, 알림의 제목과 본문을 미리 보고 사용자 정의할 수도 있습니다. 현재 Windows는 지원하지 않습니다. 사용 설명서 참조.
- 답변 누락, 무효, 지연 또는 프로세스 중단 시
cm-ai가 멈추지 않음: 외부 응답 공백을 1~4차례 보완합니다. 이러한 상황이 발생하면 재시도 방식으로 종료하거나, 직접 거부하고 다음 단계를 중국어로 알려줍니다. 예를 들어 문서 동기화 실패의 경우 문서 동기화만 다시 수행하며 개발 전체를 다시 할 필요가 없습니다. 검토 권한 거부 시에는 사용자가 명확하게 확인해야만 재권한 부여가 이루어지며, 자동으로 재시도하지 않습니다.
- 알림이 더 간편해짐: 기본 문안에서 '다음 단계'를 첫 줄에 배치하고, 시간을 로컬 기기 시간으로 변경했습니다. 실행 시 알림 설정을 읽는 것도 더 안전해졌습니다: 설정 파일이 심볼릭 링크나 이름 있는 파이프(named pipe) 등 일반 파일이 아닌 파일로 변경될 경우, 알림을 끄고 진단 로그를 한 줄 기록하며, 링크를 따라가거나 이름 있는 파이프의 쓰기 주기를 기다리지 않습니다. 읽기는 여전히 동기식 작업이며, 매우 느린 파일 시스템에서도 타임아웃 상한선이 없습니다.
- CI에서 테스트 속도 향상: 가장 느린 두 가지 테스트를 분리하여 병렬로 실행하며, CI 테스트 그룹 또한 실제 소요 시간에 따라 할당되어 어떤 사용 행위에도 영향을 주지 않습니다.
0.16.8
- 멈춤 상태에서 휴대폰으로 알림 전송:
~/.cm-workflow/notify.json에 로컬 명령을 설정한 후, 프로세스가 사람의 처리를 기다리거나, 전체 프로세스가 완료되거나, 호스트가 응답을 기다리는 시간이 초과될 때(검사 유형은 45분), 또는 호스트가 켜져 있어도 45분 동안 다음 단계를 받지 못하면 알림이 한 번 전송됩니다. 동일한 일에 대해서는 6시간 이내에 한 번만 전송되며, 속도 제한(rate limit)이 적용되고, 전송 실패는 프로세스에 영향을 주지 않습니다. 사용 설명서 참조.
- 알림 기능 명확화: 한 번만 전송하고 재전송하지 않으며, 전원이 꺼지거나 절전 모드일 때는 전송되지 않습니다. 또한 상시 감시 프로세스가 없습니다. 세션 자체적으로 보낸 백그라운드 명령은 범위에 포함되지 않습니다.
cm-ai 호스트 설명서의 '시작 전'에 배포 규율이 추가되었습니다: 백그라운드 명령에는 타임아웃이 적용되며, 별도의 대기 스크립트를 작성할 필요가 없고, 비대화형으로 Codex를 호출하려면 입력을 닫아야 하며, 최종 상태(terminal state)를 받은 후 검토하고 다시 실행해야 합니다.
- 토큰 절약:
cm-ai가 매번 시작 시 읽어야 하는 호스트 설명서의 크기가 75KB에서 25KB로 줄었으며, 예외 복구는 필요할 때만 읽습니다. 단일 작업, cm-prd, cm-fix 완료 시 다음 작업을 위해 새 세션을 시작하는 것이 권장됩니다. 읽기 전용 토큰 사용량 보고서 scripts/cm-token-report.mjs가 추가되었습니다.
- 품질 검사(QA) 실패로 인한 멈춤 방지: 실행 시간 초과, 범위 내 파일 변경, 브라우저 증거 위치 오류, 이미 폐기된 작업 사례, 독립적으로
cm-fix를 통해 수정된 작업 등 모든 경우에 명확한 종료 경로가 있습니다. cm-fix의 2차 진단 불합격 또는 원인 검토 결론 없음으로 인해 더 이상 unknown 상태에서 멈추지 않습니다.
- 보호 경로 및 배치 선택: 작업 범위(scope)에 AGENTS.md, CLAUDE.md와 같은 보호 파일이 포함된 경우 생성 실행 전에 가로채기합니다.
--feature N.slug를 사용하여 나중에 배치를 명시적으로 먼저 수행할 수 있습니다. 병렬 그룹의 '파일만 새로 만들기'는 런타임에서 강제됩니다. 현재 세션 개발 시 다른 도구의 검토(review)를 지정할 수 있습니다 (--review-runtime).
- 호스트 수동 확인:
node scripts/cm-patrol.mjs --report을 사용하여 어떤 호스트 프로세스가 종료되지 않았는지 확인할 수 있습니다.
0.16.7
- 최초 계획이 목표에 따라 작업을 구성: 관련 저위험 문안, 스타일 및 소규모 상호작용은 독립적으로 검증하고 롤백할 수 있는 작업으로 통합될 수 있습니다. 보호 기준선(baseline), 명확한 독립 경계 및 실제 계약 의존성은 계속 유지됩니다.
- 기존 실행의 호환성 유지: 역할 설정 변경, 기존 작업 목록 또는 각 작업별 N4 독립 검토는 이루어지지 않습니다. 진행 중인 계획 요청은 원래 지침을 계속 사용합니다.
- 이익은 여전히 검증 필요: 제한적 계획 비교는 2→2, 4→4로만 되어 있어 작업 수 감소를 보여주지 못했으며, 토큰이나 비용 절감도 증명하지 못했습니다. 고위험군은 원래 설계 게이트만 검증합니다.
0.16.6
- 런타임 설정 기본 유지:
cm-runtime을 열면 현재 설정과 출처를 먼저 확인하고, 능동적으로 수정할 때만 사전 설정 가이드를 진행합니다. 고급 모델 진입점은 설명과 검증 방법만을 제공합니다.
- 외부 모델은 provider에 따라 구성: 단일 작업, 배치 및 수정 시
cm-model-setup.mjs의 모델 및 선택적 강도를 명시적으로 활성화할 수 있습니다. 호스트는 현재 모델을 유지하고, 실행(run)은 파라미터를 고정하며, 알 수 없는 호출은 재전송 중단됩니다. 설정 및 복구 경계 참조.
- 확인 전 영향 확인: 목표, 필드 변경 및 프로젝트 커버리지 관계를 미리 보고, 최종
[y/N] 엔터는 저장하지 않습니다. 확인 기간 동안 설정이 변경되면 재미리보기가 요구됩니다. 설치 후의 설정은 건너뛸 수 있으며, 기존 사용자는 기본적으로 우선 유지됩니다.
- 모델 별칭 유지 및 호환성 안내: 사전 설정을 전환해도 기존 모델이나 실행 중인 작업은 변경되지 않습니다. 설정 검증이 새로운 어댑터가 반드시 해당 모델을 지원한다는 것을 의미하지는 않습니다.
0.16.5
이번 버전의 수정 사항들은 cm-ai를 사용하여 실제 프로젝트(AI 트렌드)를 실행할 때 발생했던 장애물들을 해결한 것입니다. 진행 도중 멈추거나(freeze), 이해하기 어려운 오류가 발생하거나, 수동으로 파일을 수정해야만 계속할 수 있었던 상황들이 대부분 명확한 처리 경로를 갖게 되었습니다.
- 중단 및 시간 초과로 인한 실행 중단 없음: 호스트가 검토 도중에 종료되거나 검토 프로세스에 오류가 발생해도, 이전 실행 기록을 남기고 포기한 후 재검토를 요청할 수 있습니다. 개발 또는 마무리 단계에서 종료되어도, 해당 단계를 포기하는 기록을 남기고 원본 실행을 공식적으로 종료한 뒤 새 실행을 만들어 다시 수행할 수 있습니다. QA 평가 시간 초과나 검사 시간 초과 모두 재시도가 가능하며, 환경적 문제로 인한 QA 장애물은 원본 코드를 대상으로 다시 실행할 수 있습니다.
- 재시도는 진정한 재수행: 검토가 반려된 후 두 번째 라운드에서는 두 번째 라운드의 답변을 사용합니다. 정리 후 재시도하면 실제로 개발이 재수행되며, 검사를 통과하지 못하면 검토 제출되지 않습니다. 재시도 횟수와 마무리 과정에서 더 이상 상한에 도달하여 스스로 잠기는 일이 없습니다.
- 사양 변경 중에도 계속 실행 가능: 작업 진행 중에 사양이 재승인되면, 변경 사항이 다른 작업을 포함하는 경우 명시적으로 새 사양으로 연결(bind)하여 계속할 수 있습니다. 배치 멤버들은 이동 가능한 출구 경로를 명시합니다.
- 오류 메시지를 사람이 이해하기 쉽게: 시작 파라미터가 잘못된 경우 어떤 파라미터인지, 그리고 생성 시점과 어디가 다른지 구체적으로 알려줍니다.
cm-prd 검토 게이트의 모든 거절 사유에는 고정 오류 코드와 이유가 포함되며, 더 이상 단순히 unavailable만 보고하지 않습니다. 코드 디렉토리를 스캔할 때 시스템 및 빌드 관련 잡파일은 건너뛰고, 오류 발생 시 경로를 명시합니다.
- 규칙 작업(일반적으로 T-002)을 단일 작업으로 구동하여 완료 가능: 세션 검증이 통과되지 않으면 재시도가 가능한 상태에서 멈춥니다. 수정 후 원본 실행에서 다시 생성 및 검증하며, 더 이상 복구 불가능한
unknown 상태로 떨어지지 않습니다.
- 재수행 작업에는 이전 검토 의견 포함: 검토 라운드를 모두 사용하고 새 실행을 만들어 재수행할 경우, 첫 번째 개발 및 검토 단계에서 이전 실행의 마지막 검토 문제 목록(참고용일 뿐, 검토를 건너뛰지는 않음)을 확인할 수 있습니다.
0.16.4
- 프로젝트 유형 알림이 더 이상 검토 실패를 유발하지 않음: Claude Code CLI 2.1.x는 Xcode와 같은 프로젝트 디렉토리에서 '프로젝트 유형' 알림을 추가로 전송하며, 이 알림은 초기화 메시지보다 먼저 올 수 있습니다. CM의 검토 파서는 이를 인식하지 못하여 실제 검토가
transport_incomplete으로 종료되곤 했습니다. 이제 검토자와 개발자 모두 이 알림을 수용할 수 있으며, 나머지 메시지는 기존 규칙에 따라 엄격하게 검증됩니다.
- 사양 승인 후에도 계속 수정 가능: 사양을 승인할 때
.cm-specs-status의 '최근 변경 기록' 번호가 사라졌고, 이후 모든 cm-prd --change는 검토 기록이 수정되었다고 보고되어 사양 승인 후에는 수정할 수 없었습니다. 이제 승인과 요약 게시 모두 이 기록을 보존합니다. 이미 손실된 사양은 skills/cm-prd/references/js-change-recovery.md에 따라 확인합니다: 어떤 변경 사항이 이번 승인 시점의 어느 아카이브와 일치하는지 증명할 수 있을 때만 수동으로 복구되며, 증거가 모호하면 중단하고 사람에게 재검토를 요청합니다.
- 대규모 작업에서 설치 파일 수동 수정 불필요: 개발 답변이 64 KiB(여러 소스 파일을 한 번에 작성)를 초과할 경우 호스트가 거부했습니다. 이제 단일 작업 및 배치 호스트 모두
--input-limit BYTES(최대 4 MiB)를 지원하며, 이는 전송에만 영향을 미치고 복구 시에도 변경 가능합니다.
cm-prd 자체 진단 명령의 출력으로 인한 오판 실패 없음: 운전자는 자체 진단 명령을 실행할 때, 명령이 무언가를 출력하는 것만으로도 실패로 간주되었습니다. 이는 수정되었습니다.
/cm-check가 실제 실행 시간에 따라 태그 지정: Claude Code를 사용하여 자체 진단을 실행할 때, 독립 검토 채널이 '선언되지 않은 배포'로 오인되어 태그 지정되는 문제가 있었습니다. --runtime codex|claude 옵션이 추가되었으며, 우선순위는 --runtime > 환경 변수 CM_RUNTIME입니다. 둘 다 없는 경우 '미판단(undetermined)'으로 표시되며 임의로 결론을 내리지 않습니다.
0.16.3
- 검토된 작업은 명시적으로 재실행 가능: 독립 검토에 사용된 인계 문서(handoff document)는 덮어쓸 수 없습니다. QA가 호스트 또는 환경 증거 부족으로 인해 BLOCKED되었고, 재실행 조건이 충족되면 원래 실행에서
--rerun-blocked-qa를 사용하여 QA를 다시 수행할 수 있습니다. 하지만 반드시 개발을 새로 하거나 새로운 런타임을 구축해야 하는 경우, 계속해서 handoff_exists 오류가 발생하여 작업을 진행할 수 없습니다. 이제는 오류 메시지가 세 가지 해결책을 직접 제시합니다: 원본 실행에서 수정된 QA 설정, 원본 실행에서 환경 문제로 막힌 QA, 또는 작업을 - [ ]로 되돌린 후 새 실행과 --supersede-reviewed-evidence --supersede-reason를 사용하여 재실행하는 것입니다. 이전 인계 및 검토 승인 기록은 내용 요약에 따라 .reviews/.superseded/ 폴더에 보관되며 삭제되지 않습니다.
- 다른 채팅 세션으로도 계속 진행 가능: cm-ai의 단일 작업 실행(및 QA 수정 하위 실행)과 cm-fix 모두 새 세션에서 이전 실행을 이어받을 수 있습니다. 배치 실행 및 구 보호 호환 진입점은 여기에 포함되지 않습니다. 새 세션은 검토 승인 권한에 서명하기 전 아카이브에 기록되며, 검토자 목록에서는 제외되고 읽기 전용으로 열립니다. 0.16.1~0.16.2 기간 동안 세션을 변경하여 승인을 한 이전 cm-fix 실행은 여전히 당시 승인을 한 세션에서만 계속 진행할 수 있습니다.
- 프로세스가 스스로를 잠그지 않음: cm-prd의 분할 검토는 요구사항 및 설계를 수정할 수 있으며, 자체 검사 실패 시 사람의 판단을 받을 수 있고, 원자재가 도중에 변경되면 이전 배치(batch)를 공식적으로 종료하고 새 배치를 시작할 수 있습니다. cm-fix에서 로컬 단계 결과가 손실된 경우 명시적으로 포기하고 재수행할 수 있으며,
design_change로 진단된 실행은 업그레이드 마무리까지 진행될 수 있고, 최종 검토에서 추가 테스트를 요구하는 두 번째 라운드에서도 계속 진행될 수 있습니다. cm-refactor의 검토가 판사 테스트(judge test)를 요구할 경우, 두 번째 라운드는 제어된 수정이 가능합니다.
- 아홉 개의 워크플로우 호스트 모두 단일 단계 드라이버 기능 탑재:
scripts/cm-*-drive.mjs는 한 번의 진행마다 먼저 '이 단계에서 무엇을 물어볼지'를 확인하여 답변 파일을 취합한 후 명령을 전송합니다. 부족한 부분이 있다면 시작 전에 명확히 알려주므로, 알고 있는 누락된 부분 때문에 실행이 중간에 unknown 상태로 멈추는 일이 없습니다. 호스트가 사전 검사에서 커버되지 않은 문제를 질문할 경우, 드라이버는 이 단계가 unknown 상태에서 멈출 것임을 명확하게 밝힙니다. 수동 파일은 판단과 내용만 제공하며, 실행 증거는 실제 실행 명령에서만 나옵니다.
- 검토 사전 검사에서 잘못된 모델 이름을 인식: 로컬 Claude CLI가 알지 못하는 검토 모델 ID(예: CLI 2.1.x의
claude-opus-5-5, claude-opus-5로 작성해야 함)는 이제 사전 검사 단계에서 실패 판정을 내리며, 실제 검토까지 끌고 가서 transport_incomplete으로 마무리되지 않습니다.
0.16.2 버전 업데이트
- 중복 이름 즉시 차단 및 오류 위치 파악 가능: 작업 ID가 중복되면 생성 중에 바로 오류를 발생시키므로, 더 이상 빨간불 테스트(red light test)로 한 라운드를 무효화할 때까지 기다릴 필요가 없습니다. 실패 진단에는 어느 줄의 코드가 막았는지 정보가 포함됩니다. CI는 모든 검사를 자동으로 수집하도록 변경되었으며, Codex 사상자(sandbox)가 필요한 7가지 테스트만 고정적으로 제외하고, 이 7개 테스트는 배포 스모크 테스트 시 보충 실행됩니다. 이전 버전의 METRICS 구형 헤더도 계속 인식할 수 있습니다.
0.16.1 버전 업데이트
- cm-fix가 마무리 단계까지 진행 가능: 마무리(completion)가 더 이상
delivery: diff만 인식하지 않습니다. 세션을 변경해도 이전 실행을 열 수 있으며, pod install을 수행한 iOS 프로젝트에서도 기준 스냅샷(baseline snapshot)을 찍을 수 있습니다.
0.16.0 버전 업데이트
- cm-ai가 '진행 불가'에서 '완료 가능'으로: 인계 문서의 이름 충돌로 작업이 멈추는 일이 없습니다. 독립 검토 및 QA 사용 사례에 대한 대기 시간을 개별적으로 늘릴 수 있습니다. 선택적 배포 전 검증 게이트
--verification-precheck가 추가되어, 막기만 하고 진행은 허용합니다.
0.15.5 버전 업데이트
- 설치 시 새 버전 알림 활성화 여부를 묻습니다. 이전에는 설치 후 '자동 업데이트기가 자동으로 활성화되지 않았음'이라는 모호한 문구 하나만 있었고, 이미 활성화된 사람도 이 문구를 보게 되었으며(이는 오류), 비활성화된 사람은 대수롭지 않게 여겨져 결과적으로 아무도 이 기능을 사용하지 않았습니다. 이제 설치기는 먼저 실제 설정 여부를 확인한 후 무엇을 말할지 결정합니다. 설정이 되어 있지 않고 수동으로 설치하는 경우, 한 번 물어보고 'y'라고 답해야만 기록됩니다.
--yes를 사용하여 조용히(silently) 설치하는 사용자에게는 아무런 구성도 변경되지 않으며, 추가되어야 할 내용만 출력됩니다.
- 이 기능은 단지 '새 버전이 있으면 알려준다'는 알림만 추가할 뿐이며, 백그라운드 자동 업그레이드를 임의로 시작하지 않습니다. 그것은 별개의 문제이며, 여전히 사용자가 직접 결정해야 합니다.
settings.json에 원래 있던 내용(예: 사용자 정의 상태 표시줄)은 건드려지지 않습니다.
0.15.4 버전 업데이트
/cm-check에 빠른 모드가 추가: 평소에 단지 '설치가 제대로 되었는지, 버전이 맞는지'만 확인하고 싶을 때는 약 12초 만에 결과를 얻는 빠른 검사를 실행할 수 있으며, 더 이상 십여 분을 기다릴 필요가 없습니다. 전체 검사 시간은 거의 모든 파일의 참조 관계를 하나하나 대조하는 데 사용되었는데, 빠른 모드는 이 부분을 건너뜁니다. 결론은 '통과'가 아닌 '기계적 검사만 수행됨'으로 명확하게 표시됩니다. 건너뛴 부분은 검사된 것으로 간주되지 않습니다. 기계적 검사 자체에서 발견한 문제는 평소처럼 오류를 발생시키며, 무시되지 않습니다.
0.15.3 버전 업데이트
/cm-check가 Claude 버전 설치 환경에서 더 이상 가짜로 BLOCKED을 보고하지 않습니다: 두 가지 검사는 Codex 플러그인 전용 파일을 확인하는데, Claude 버전 설치에는 애초에 존재하지 않기 때문에 이전에는 '확인 불가'로 처리할 수밖에 없었고, 그 결과 정상적인 설치도 영원히 PASSED를 받을 수 없었습니다. 이제는 설치 방식별로 구분합니다: 본 설치 방식에 속하지 않는 산출물은 '해당 없음(Not Applicable)'으로 기록하고, 실제로 증거가 부족한 경우만 평소처럼 차단됩니다. 이는 임시방편적인 통과가 아닙니다.
- 부가적으로,
cm-check 보고서에서 Claude 버전 설치 시 항상 비어있던 버전 번호 문제를 수정했습니다.
0.15.2
- 동일 기능(feature) 동시 개발 이제 가능: 의존성이 없고 변경 파일이 겹치지 않는 작업들을 그룹화할 수 있으며, 각 작업은 독립적인 Git 워크트리에서 개발한 후 메인 브랜치로 순차적으로 병합됩니다. 멤버별 QA는 해당 기능의 마지막 작업에 이르러서야 일괄 실행됩니다. 이전에는 이 기능이 코드 내부에만 존재하고 문서화되어 있지 않아 일반 진입점에서는 사용할 수 없었습니다. 주의할 점은 현재 세션 모드에서 코드를 작성하는 것은 여전히 개별적으로 진행되며, 병렬로 처리되는 것은 검토 및 프로세스 오버헤드입니다. 배수만큼 속도가 빨라질 것이라고 예상하지 마십시오.
- 업그레이드 주의사항: 병렬 멤버 브랜치 이름이
cm/{배치접두사}/{기능}(feature)/{작업번호}로 변경되었습니다. 이전에 차단되었던 멤버들은 배치 접두사가 없는 브랜치를 남겨 영구적으로 이름을 점유하여, 동일한 작업에서 더 이상 배치가 실행되지 못하는 문제가 발생했습니다. 업그레이드 전에 생성되어 아직 완료하지 못한 병렬 배치는 이전 버전을 사용하여 마무리해 주십시오.
- QA 환경 지원 범위 확대: 이전에는 웹(Web) / 앱(App) / 미니 프로그램만 입력할 수 있어, 순수 백엔드나 명령줄 인터페이스(CLI) 프로젝트의 QA를 진행하려면 거짓으로 웹페이지라고 기재해야 했습니다. 이제는 실제 유형을 정확하게 명시할 수 있습니다.
- METRICS에 '실행 방식' 열 추가: 작업이 순차적으로 실행되었는지 아니면 병렬 멤버로 구성되었는지를 구분하여, 병렬 처리가 실제로 얼마나 많은 시간을 절약했는지 파악할 수 있게 되었습니다.
0.15.1
- cm-security가 이제 실행 로그를 기록합니다: 보안 스캔 시작과 종료 시 각각 하나의 실행 로그(범위, 결론어, 발견 개수, 커버리지, 보고서 경로)를 작성하며, 이는 다른 주요 프로세스 명령들과 일치합니다. 스캔 로직, 보고 게이트(report gate), 읽기 전용 경계는 변경되지 않았습니다. 이전에는
cm-security만이 실행 로그 규약에 연결되지 않은 유일한 주요 프로세스 명령이었기 때문에, cm-check가 이로 인해 단절된 링크를 보고했습니다.
- Claude 설치 환경에서의 버전 번호 오판 수정:
~/.claude는 Claude Code 자체의 메인 디렉토리입니다. 이곳에 CM과 무관한 VERSION 파일이 존재할 경우, cm-check가 이를 CM 버전으로 간주했습니다. 이로 인해 가벼운 버전 번호 오류를 일으키거나, 해당 파일의 버전 번호가 더 높을 경우 cm-check는 즉시 blocked를 반환하며 실행되지 못하게 했습니다. 이제 설치 모드에 따라 버전 플래그를 읽습니다. Claude 설치는 templates/cm-VERSION을 인식하고, 소스 코드 저장소는 여전히 루트의 VERSION을 인식합니다.
0.15.0
⚠️ 호환성 변경 사항 (업그레이드 전 필수 확인)
기존 레이아웃이 스토리지 복구를 실행할 경우 store_layout_legacy를 반환합니다. 이전 버전으로 종료하거나 해당 runId를 폐기해야 합니다. 기존 파일은 자동으로 마이그레이션되지 않습니다. 명시적으로 roles.browser_qa.adapter를 browser가 아닌 값으로 설정했으나, 여전히 browser를 포함하는 기본 테스트 전략을 사용하려 하면 거부됩니다. 브라우저 QA가 필요한 경우, 값을 browser로 변경해야 합니다 (모델: none, 소스: local 유지). 또는 역할 오버라이드를 삭제하여 기본값을 상속받거나, 필요하지 않은 경우 policies.tests를 명시적으로 예: [logic, commands]로 설정하십시오. 브라우저 사용 사례가 차단되는 것은 별도로 수용 범위 처리 및 재승인이 필요합니다. 새로운 필드가 포함된 실행 로그는 이전 버전에서 알 수 없는 키(unknown key)로 거부될 수 있으므로, 반드시 0.15.0 또는 해당 필드를 호환하는 후속 버전을 사용하여 실행해야 하며, 이전 버전으로 이러한 로그를 재생하지 마십시오.
동일 기능의 병렬 개발
종속성이 없는 작업은 각자의 워크트리에서 병렬로 개발할 수 있으며, 이후 메인 브랜치에 순차적으로 병합됩니다. 멤버 QA는 마지막 단계에서 통합 실행됩니다. 배치(Batch)는 자동으로 커밋 및 병합되며, 최초 진행 전에 Git 메인 작업 공간을 깨끗하게 유지해야 합니다 (추적되지 않은 파일 포함). 차단된 멤버의 WIP(Work In Progress)와 원인은 보존됩니다.
사양 승인 위치 통합 작성
cm-prd와 cm-ai는 .cm-specs-status라는 원자적 쓰기 진입점을 공유합니다. 이제 모델이 수동으로 승인 파일을 조합할 필요가 없습니다. cm-ai에 새로 추가된 --approve --approval-response 플래그를 사용하여 승인 후 재검증을 기록하며, --yes는 승인을 대체할 수 없습니다.
cm-security 보고 게이트키핑
새로 추가된 --finalize --scan ... --review ... 명령어를 통해 코드 검증이 경로별로 재확인되고, 누락된 보고가 보완되며, 최종 보고 결론이 판정됩니다. 모델은 더 이상 자체적으로 최종 상태를 진술하지 않습니다. 발견된 문제가 없고 스캔 범위가 FULL일지라도 REVIEWED_PARTIAL로 처리됩니다. 보고서에는 검증을 통과한 분석 및 수정 제안이 보존됩니다.
브라우저 QA 능력 사전 선언
QA 기능을 활성화하고 사양이 브라우저 QA를 필요로 하는 경우, 단일 작업(Single Task) 및 배치 진입점은 시작 또는 복구 시 --browser-qa available|unavailable 플래그를 명시적으로 전달해야 합니다. 더 이상 마지막 단계가 될 때까지 능력 부족이 노출되지 않습니다. 사용 불가능한 경우 브라우저 능력을 갖춘 세션으로 전환하거나, 수용 범위를 조정하고 사양을 재승인해야 합니다. 이는 능력 선언이며 자동 탐지 기능이 아닙니다.
개발 차단 원인 추적 가능
개발 결과가 blocked일 때 선택 가능한 reason은 이제 CLI 구조화 출력에서 blockedReason으로 디스크에 기록될 수 있으며, 병렬 멤버 로그와 WIP 커밋 본문에 보존됩니다. 복구 조사 시 구체적인 원인을 확인할 수 있습니다.
0.14.0
- 실행 정의 수동 작성 폐지:
cm-ai 진입점에 읽기 전용 --print-run-definition이 추가되었습니다. 이는 해석된 specs/코드 루트, 기능(feature), 작업을 유효한 실행 정의로 직접 생성합니다 (scope 필수 지정,
⚠️ [IMG:N] 형식 토큰은 이미지 placeholder 입니다. 번역하지 말고 원래 위치에 그대로 유지하세요.
- 제2차 실제 프로젝트 dogfood 수정: 사양(specs)과 코드(code)가 분리된 실제 프로젝트에서
cm-init → cm-prd → cm-ai를 다시 실행합니다 (Codex가 코드를 작성하고, Claude CLI가 독립적으로 검토하며, 기능(feature)을 최종 QA합니다). 이 과정에서 노출된 3가지 런타임 결함을 수정했습니다. 이제 cm-init은 구성 초안이 선택한 런타임 프리셋과 일치하는지 기계적으로 확인하고, 프로젝트 사실에 맞춰 delivery/tests용 새 구성을 생성합니다. cm-ai의 N6는 기능(feature)이 미완성일 경우 완료된 작업 케이스만 실행하며 나머지는 deferred_cases로 기록합니다. five_tasks_without_qa는 더 이상 이미 마무리된 기능을 백로그로 계산하지 않습니다. QA가 호스트/환경 증거 문제로 전체적으로 BLOCKED 상태일 때는 --rerun-blocked-qa를 사용하여 명시적으로 한 라운드를 재실행할 수 있으며, QA 종료 후 상태 이미지를 동기화하여 기록합니다. 자세한 내용은 업데이트 로그를 참조하세요.
0.13.3
cm-runtime 직접 실행 시 가이드 작동: 매개변수 없이 cm-runtime을 실행하면 번호 순서대로 세 가지 질문이 나옵니다 (어떤 계층을 수정할지? (현재 프로젝트 / 사용자 기본값) → 어떤 AI를 사용할지? (Codex만 / Claude만 / 둘 다 사용 가능) → 누가 코드를 작성할지? 개발자가 미리 보고 확인한 후에 기록되며, 유효한 구성이 반환됩니다. 터미널 환경이 아닌 경우 사용법만 출력하고 2로 종료합니다. 스크립트화는 여전히 show / set / unset --user를 사용해야 합니다.
- 중국어/영어 프롬프트가 시스템 언어를 따름: 설치기, 가이드 및 사람이 읽을 수 있는 진단 메시지는
CM_WORKFLOW_LANG > LC_ALL > LC_MESSAGES > LANG > Node Intl 순서로 중국어 또는 영어(Windows 설치기는 Get-Culture 사용)를 판별합니다. 프리셋 이름, 머신 필드 및 종료 코드는 변경되지 않았습니다.
0.13.2
- 설치 시 단일/이중 AI 및 코드 작성자 지정:
install.sh / install.ps1 / install-codex.sh를 설치하면