기존 코드베이스를 Taiga로 가져오기
완료Taiga가 저장소에서 도출한 내용을 검토하세요. 현재 동작과 의도한 동작을 구분하고 부정확한 문서에 적절히 대응하세요.
이해도 확인가져온 문서가 교체하려는 코드를 정확하게 설명합니다. 적절한 대응은 무엇일까요?실습하기
학습할 내용
- 가져올 제품에 연결된 저장소를 준비합니다.
- 코드 결함, 상시 지침, 분석 오류를 구분합니다.
- 제안된 이니셔티브를 실제 공백과 기존 기능에 비춰 검토합니다.
현재 시스템에서 시작하세요
가상의 장비 요청 서비스가 이미 있습니다. 팀은 정상 작동하는 연동을 유지하면서 Taiga로 유지보수하려 합니다.
제품을 만들 때 Import codebase를 선택하세요. 저장소를 연결하고 분석을 시작하세요. 이 경로는 새 제품의 대화 대신 저장소 분석을 사용합니다. 처음부터 만든 제품에는 나중에 이 가져오기 경로를 추가할 수 없습니다.
저장소 접근과 Taiga가 작업할 브랜치를 확인하세요. 적절한 맥락 수준에 상시 제약을 추가하세요. 이 예에서는 기존 직원 ID 연동을 계속 사용해야 한다고 명시하세요.
추론한 명세부터 검토하세요
Taiga는 코드에서 제품 문서를 도출하고 저장소 인용을 포함합니다. 인용은 해석을 확인하는 데 도움이 됩니다. 기존 패턴마다 그 뒤의 비즈니스 의도를 입증하지는 않습니다.
명세에서 세 가지를 살펴보세요.
- 목적: 설명된 목표가 서비스의 존재 이유와 일치하나요?
- 제약: 어떤 패턴이 의도적인 요구사항인가요?
- 알려진 결함: 어떤 현재 동작을 바꿔야 하나요?
장비 서비스에는 레거시 인가 모듈이 있습니다. 문서가 그 사용을 정확히 보고할 수 있습니다. 그렇다고 팀이 사용을 확대해야 한다는 뜻은 아닙니다.
인용된 파일을 열고 관련 동작을 주장과 비교하세요. 저장소 밖의 구성이나 운영 동작처럼 확보한 증거의 한계를 기록하세요.
올바른 수정 방법을 선택하세요
| 상황 | 대응 |
|---|---|
| 문서가 원치 않는 코드를 정확히 설명함 | 코드 변경을 계획하고 구현 |
| 팀에 향후 작업을 위한 상시 규칙이 있음 | 제품 지침에 규칙 추가 |
| 분석이 저장소를 잘못 해석함 | Refresh this document를 사용하고 결과 확인 |
가져온 문서는 코드를 따릅니다. 미래 시스템을 설명하는 수동 관리 문서로 다루지 마세요. 문서를 새로 고치면 그 문서가 의존하는 문서도 다시 도출합니다. 따라서 후속 문서를 새로 고치면 더 많은 작업이 필요할 수 있습니다.
레거시 모듈에 대한 지침은 다음과 같을 수 있습니다. ‘레거시 인가 모듈을 호출하는 새 코드를 추가하지 마세요. 새 작업에는 승인된 대체 인터페이스를 사용하세요.’ 인터페이스가 존재하는지 검증하고 실제 저장소 위치를 명시하세요.
첫 이니셔티브를 평가하세요
가져오기 작업 흐름은 저장소 검사, 게시된 정책에 대한 평가, 초기 이니셔티브 계획도 실행합니다. 전제 조건이 없는 단계는 설명과 함께 건너뛸 수 있습니다. 계획은 확보된 발견 사항과 정책 평가를 사용합니다.
제안된 공백을 저장소와 대조해 검토하세요. 초기 이니셔티브는 누락된 기능, 기반, 관련된 미해결 의존성 문제를 다룹니다. 아무도 요청하지 않은 새 기능 목록이 아닙니다.
유용한 기존 기능은 유지하세요. 불필요하게 다시 만들자는 제안은 거부하거나 수정하세요. 새로운 비즈니스 요구사항은 별도 이니셔티브로 추가하세요.
증거에 근거한 출발점을 유지하세요
Discovery를 마치고 이니셔티브 제안을 검토하세요. 상세 계획 전에 환경과 소프트웨어 제공 책임을 확인하세요. 작업이 진행되어도 가져온 내용, 코드 변경, 제품 지침을 일치시키세요.
결과는 이해한 출발점과 편집 가능한 백로그입니다. 모든 기존 동작이 올바르다는 선언이 아닙니다. 이니셔티브 계획에서 계속 학습하세요.
실습하기
가져온 가상 서비스가 레거시 인가 모듈을 사용합니다. 교체는 이미 계획되어 있습니다. 이 모듈에 대한 새 의존성을 막는 제품 지침을 작성하세요. 그런 다음 가져온 명세에서 살펴볼 저장소 인용 하나를 고르세요.
워크시트 다운로드(Markdown)이 선택을 해제하면 이 브라우저에 저장된 모든 진도가 삭제됩니다.
진도는 이 브라우저에만 저장됩니다. 계정과 추적은 없습니다.