Addy Osmani

운영 환경의 동작과 장애 원인을 추적하도록 로그, 지표, 서비스 간 처리 경로와 알림을 설계합니다. 실제 출력과 알림까지 검증합니다.

• 운영 기능의 모니터링 정보 구성
• 서비스 간 로그 연결
• 알림과 대응 절차 검토

모호한 아이디어를 목표, 작업 범위, 검증 가능한 완료 조건이 담긴 명세로 정리합니다. 기능과 의존 관계를 나누고 사람의 승인을 거쳐 계획, 작업 분할, 구현으로 진행합니다.

• 구현 전에 아이디어를 구체화할 때
• 완료 조건을 포함한 요구사항 작성
• 큰 요구사항을 독립 기능으로 나누기

운영 환경에 공개하기 전 품질, 보안, 성능, 사용성을 점검하고 모니터링과 롤백을 준비합니다. 공개 후 확인과 지표에 따른 단계적 배포도 다룹니다.

• 첫 운영 환경 공개 전 준비 확인
• 주요 기능의 단계적 공개 계획
• 모니터링과 공개 후 확인 절차 정리

모호한 요청을 한 번에 하나씩 질문하며 구체화합니다. 에이전트의 추측을 함께 제시하고 대상, 목적, 성공 기준, 제약, 제외 범위를 정리해 사용자가 확인한 의도문을 만듭니다.

• 모호한 요청의 목적 명확히 하기
• 대상과 성공 기준 정리하기
• 양립하기 어려운 요구의 우선순위 확인하기

동작을 바꾸지 않고 깊은 조건 분기, 긴 함수, 중복, 모호한 이름을 정리합니다. 기존 규칙과 테스트를 확인하고 가독성을 기준으로 작은 변경을 이어 갑니다.

• 작동하는 기능의 코드 가독성을 높입니다
• 리뷰에서 지적된 복잡성을 정리합니다
• 깊은 조건 분기와 긴 함수를 정리합니다

혼합된 코드 변경을 목적별 커밋으로 나누고 브랜치와 PR 준비를 돕습니다. 호환성에 맞는 버전 번호와 변경 기록을 정리하고 커밋 전 점검도 다룹니다.

• 혼합된 변경을 목적별 커밋으로 나눕니다
• 검토할 브랜치와 PR을 준비합니다
• git worktree로 병렬 작업을 분리합니다

개발 과제에 맞는 스킬과 사용 순서를 선택하고 명세 작성부터 구현, 테스트, 배포까지의 흐름을 정리합니다. 전제 명시, 작업 범위 준수, 결과 검증의 공통 규칙도 안내합니다.

• 개발을 시작할 때 사용할 스킬을 고릅니다
• 새 기능의 작업 순서를 정리합니다
• 오류 수정과 검토 절차를 선택합니다

기존 API와 기능의 폐기 판단부터 대체 구현으로의 단계적 이전, 사용 확인, 삭제까지 정리합니다. 운영 데이터베이스의 열 변경도 신구 코드가 공존하는 절차로 진행합니다.

• 기존 API에서 대체 API로 이전합니다
• 불필요한 기능의 종료를 계획합니다
• 운영 데이터베이스 열 이름을 단계적으로 바꿉니다

병합 전에 코드 변경을 정확성, 가독성, 설계, 보안, 성능의 다섯 기준으로 검토합니다. 필수 수정과 선택 제안을 구분하고 구체적인 개선 방법을 제시합니다.

• 병합 전 풀 리퀘스트 검토
• 인공지능이 작성한 코드 확인
• 리팩터링의 개선 효과 확인

테스트 실패, 빌드 오류, 예상 밖의 동작을 재현하고 원인을 좁힌 뒤 최소 재현 사례를 만듭니다. 근본 원인을 수정하고 재발 방지 테스트까지 진행합니다.

• 코드 변경 후 테스트 실패 조사
• 빌드 오류 원인 조사
• 작동을 멈춘 기능의 원인 확인

명세나 요구사항을 완료 기준과 검증 방법이 있는 작은 구현 작업으로 나눕니다. 의존 관계, 작업 순서, 확인 지점을 정리해 계획서와 작업 목록에 남깁니다.

• 큰 기능을 구현 작업으로 분할
• 의존 관계에 맞춘 작업 순서 정리
• 완료 기준과 검증 방법 명문화

프로젝트의 프레임워크와 라이브러리 버전을 확인하고 공식 문서에 따라 구현합니다. 판단의 출처를 제시하고 사용이 권장되지 않는 API와 확인하지 못한 방법도 표시합니다.

• 사용 버전의 공식 문서로 구현 확인
• 출처가 있는 기본 코드 작성
• 사용 중단이 권고된 API 점검

API와 모듈 사이의 입출력을 정의하고 이름, 오류 형식, 입력 검증을 통일합니다. 기존 호출 측과의 호환성과 재시도로 인한 중복 처리도 고려합니다.

• 새 REST API를 설계합니다
• 화면과 서버 사이의 데이터 규격을 정합니다
• 호환성을 유지하며 API를 확장합니다

새 기능과 버그 수정 전에 실패하는 테스트를 작성합니다. 최소 구현과 코드 정리를 반복하며 기대 동작과 기존 기능에 미치는 영향을 확인합니다.

• 테스트를 먼저 작성한 뒤 구현
• 보고된 버그 재현과 수정
• 코드 변경 시 기존 동작 확인

화면 표시, API, 데이터베이스의 지연을 측정해 원인을 좁히고 개선 전후 수치로 효과를 확인합니다. 효과 없는 변경의 되돌리기와 성능 저하를 막는 감시까지 안내합니다.

• 페이지 표시와 조작 지연의 원인을 조사합니다
• API 지연과 반복 쿼리를 줄입니다
• 변경 후 성능 저하를 확인합니다

기존 디자인 체계에 따라 스마트폰부터 큰 화면까지 대응하는 UI를 구현합니다. 컴포넌트 구조와 상태 관리, 키보드 조작, 로딩 중·빈 데이터·오류 표시를 정리합니다.

• 새 페이지와 UI 컴포넌트를 만듭니다
• 스마트폰과 컴퓨터 화면을 조정합니다
• 키보드와 화면 읽기 지원을 개선합니다

설계 결정의 이유와 비교한 대안을 기록하고 README, API 문서, 변경 이력을 정리합니다. 새 담당자와 AI 에이전트가 구현 배경을 이해하도록 돕습니다.

• 설계 결정과 채택하지 않은 대안 기록
• 공개 API 변경 문서화
• README의 시작 절차 정리

웹 앱의 입력 처리, 인증, 외부 연동을 점검하고 취약점 대응을 정리합니다. 의존 패키지, 개인정보, LLM 출력 처리 방식까지 확인합니다.

• 로그인과 접근 권한 점검
• 파일 업로드와 외부 API 연동 확인
• 출시 전 의존 패키지 감사

여러 파일에 걸친 기능 추가와 수정을 검증 가능한 작은 단위로 나눕니다. 구현, 테스트, 검증, 커밋을 반복하며 각 단계에서 작동하는 상태를 유지합니다.

• 여러 파일에 걸친 기능을 추가합니다
• 계획의 다음 작업을 구현합니다
• 기능 플래그로 미완성 기능을 숨겨 통합합니다

작업에 맞춰 AI 에이전트에 제공할 규칙, 명세, 관련 코드를 선택합니다. 긴 대화의 정보를 정리하고 결정 사항과 검증 결과를 다음 세션에 인계합니다.

• AI 개발에 필요한 규칙 정리
• 작업에 필요한 파일 선택
• 긴 대화의 정보 정리

실제 브라우저에서 화면과 동작을 검증하고 오류, 통신, 로딩 속도를 조사합니다. 수정 전후의 스크린샷 비교와 접근성 확인도 지원합니다.

• 레이아웃과 스타일 문제 조사
• 브라우저 오류와 API 통신 확인
• 수정 전후 화면 비교

프로젝트 품질 기준을 수치와 확인 방법으로 문서화합니다. 변경 내역에서 테스트 생략, 경고 억제, 기준 하향을 점검해 에이전트 개발의 품질을 유지합니다.

• 에이전트 개발의 품질 기준 설정
• 커버리지와 성능 목표 선택
• 테스트 생략과 경고 억제 발견

설계와 구현의 중요한 결정을 작업 이력을 공유하지 않는 별도 검토자에게 검증받습니다. 숨은 전제와 실패 조건을 찾아 수정하거나 결정을 재검토합니다.

• 설계안의 전제 검증
• 익숙하지 않은 코드의 판단 확인
• 인증과 민감한 처리 로직 검증

코드 변경 시 테스트, 타입 검사, 빌드를 자동 실행해 배포 전 품질 확인 절차를 마련합니다. GitHub Actions 설정부터 단계적 배포와 롤백 절차까지 다룹니다.

• 새 프로젝트에 CI 도입하기
• 테스트와 품질 검사 자동화하기
• 단계적 배포와 롤백 설계하기