개인 프로젝트
이 규칙은 personal@tj-agents를 명시적으로 채택한 프로젝트에 적용됩니다. 채택은 프로젝트의 개인적 범위를 기록하며, 홈 디렉토리, 작성자 이름, 또는 고용주 연관성으로는 채택이 성립되지 않습니다. 고용주 프로젝트는 Tommy가 명시적으로 범위를 변경하지 않는 한 이 프로필에 포함되지 않습니다.
하나의 현재 지원 솔루션만 유지하세요. 동작을 대체할 때는 대체된 이름, 별칭, 폴백 구현, 어댑터, 설정 형식 및 호환성 브랜치를 제거하세요. 알려진 모든 호출자, 프로젝트 선언, 설치된 등록 정보, 생성된 아티팩트 및 라이브 런타임 진입점을 동일한 전환 시점에 조정하고 마이그레이션하세요. 가상의 외부 사용자를 위해 구버전 동작을 유지하지 마세요; 실제 협력 중인 개발자와 함께 업그레이드를 조정하세요.
사용자가 실제로 사용하는 진입점을 모든 지원 플랫폼에서 검증하세요. 여기에는 Windows 및 Linux 실행 경로가 포함됩니다. 소스 수정, 성공적인 생성, 통과하는 단위 테스트 및 버전 명령만으로는 마이그레이션이 완료되었다고 증명할 수 없습니다. 설치된 바인딩과 새로운 런타임 동작을 확인하세요. 검증되지 않은 진입점은 해당 해결사(resolver)와 관찰 가능한 수락 조건과 함께 '불완전'으로 기록하세요.
예를 들어, old-launch를 launch로 대체한다는 것은 등록된 셸 명령, 프로젝트 설정 및 실제 호출자를 마이그레이션하고, 이전 진입점을 삭제한 후, 각 지원 OS에서 새로운 세션으로 launch를 호출하는 것을 의미합니다. launch --version만 실행하는 것은 전환이 검증되지 않은 상태로 남습니다.
old-launch를 launch로 대체:
1. 등록된 셸 명령, 설정 및 실제 호출자를 마이그레이션합니다.
2. 이전 진입점을 삭제하고 설치된 설정을 재생성합니다.
3. 지원되는 Windows/Linux의 새로운 세션에서 launch를 호출하고 실제 동작을 확인합니다.
결과: launch --version만으로는 이 마이그레이션이 불완전합니다.
독립적으로 하위 호환성 예외를 추가하지 마세요. 명시적인 반대 사용자 요구 사항을 의도적인 정책 결정으로 표면화하고, 영향을 받는 지원 동작을 식별한 후 구현하기 전에 이 프로필의 범위를 조정하세요. 예외를 폴백이나 어댑터에 숨기지 마세요.
입증된 문제를 가장 작은 적절한 구현으로 해결하세요. 추상화, 의존성, 설정 스위치, 중복 경로 또는 프로세스 메커니즘은 구체적인 현재 필요가 있을 때만 추가하세요. 프로젝트가 이미 선택한 기능을 우선 사용하세요. 동작과 의미 있는 실패 경로를 변경에 비례하여 검증하세요; 단순히 구현을 반복하거나 구체적인 이점이 없는 체크리스트를 위한 테스트는 추가하지 마세요.
이 정책은 여기서 한 번만 작성됩니다. 개인 채택은 이 본문에서 표시된 네이티브 명령 블록을 생성하고 드리프트(차이)를 확인합니다. 선택된 플러그인이나 always 티어만으로는 로딩이 증명되지 않습니다.