cargo extension

Cargo 확장 명령은 이름, PATH, 출력 계약을 함께 운영한다

cargo-something 실행 파일이 PATH에 있으면 Cargo 하위 명령처럼 호출할 수 있다. 그래서 작은 편의 도구라도 팀 자동화 기준으로 봐야 한다.

핵심 판정 개인 단축키인지, 작업공간 표준 도구인지 먼저 정하고 인자·종료 코드·출력 형식을 문서화한다.

Cargo 확장 명령 운영표
검사 축	운영 기준	확인 방법	흔한 실패
명령 이름	`cargo-foo` 형식으로 실행 파일 이름을 둔다.	`cargo foo` 호출 여부	이름이 길거나 모호해 팀에서 기억하지 못한다.
PATH	설치 위치가 셸과 CI 환경 모두에서 보인다.	`cargo --list`	로컬에서는 되지만 CI에서 명령을 못 찾는다.
인자 계약	필수 인자, 기본값, 실패 메시지를 고정한다.	`--help` 출력	자동화가 옵션 변경에 바로 깨진다.
출력 계약	사람용 설명과 기계용 결과를 분리한다.	stdout, stderr, 종료 코드	CI가 자연어 로그를 억지로 파싱한다.
버전 정책	도구도 의존성이므로 설치 버전을 기록한다.	README와 설치 스크립트	개발자마다 다른 결과가 나온다.

Personal 개인 생산성 도구는 문서 부담을 낮추고 빠르게 바꾼다.

Team standard 팀 표준 도구는 설치법, 버전, 실패 기준을 같이 고정한다.

CI 자동화에 들어가면 출력 형식과 종료 코드가 API가 된다.

Review 새 버전은 최소 프로젝트에서 성공과 실패 경로를 확인한다.