실전 바이브코딩 #3: AGENTS.md와 Android Skills 준비하기

Android Skills와 AGENTS.md 버전 Git 규칙으로 Markdown Viewer 구현 기준을 준비하는 흐름

바로 앞의 2편에서 DEVELOPMENT_ENVIRONMENT.md, MVP.md, ROADMAP.md를 준비했습니다. 구현 순서와 완료 조건은 정해졌지만, AI가 매 작업에서 따라야 할 공통 규칙과 작업별 지침은 아직 없습니다.

3편에서는 프로젝트 공통 규칙을 AGENTS.md에 먼저 기록하고 버전과 Git 운영 기준을 구체화합니다. 이어 Android Skills를 Markdown Viewer의 ROADMAP에 맞게 선별·설치하고, Architecture Guardian으로 구현 전 구조를 검토합니다. 앱 코드는 4편에서 키스토어 준비를 마친 뒤 작성합니다.

Android Skills와 AGENTS.md 버전 Git 규칙으로 Markdown Viewer 구현 기준을 준비하는 흐름
ROADMAP에 프로젝트 공통 규칙과 필요한 Android Skills를 연결해 구현 기준을 고정합니다.

3편에서 준비할 파일과 디렉터리

3편을 마치면 프로젝트에는 아래 파일이 남고, 프로젝트 밖의 ../keystores는 4편에서 생성합니다. Architecture Guardian 검토에서 승인한 내용은 새 문서를 만들지 않고 기존 ROADMAP.md에 반영합니다.

workspace/
├── keystores/                 # 4편에서 debug/release 서명 파일 생성
└── markdown-viewer/
    ├── .agents/
    │   └── skills/            # 선별한 프로젝트용 스킬
    ├── AGENTS.md              # Codex가 따를 프로젝트 공통 규칙
    ├── DEVELOPMENT_ENVIRONMENT.md
    ├── MVP.md
    └── ROADMAP.md             # 승인한 구조 리뷰 결과 반영

../keystores는 4편에서 debug·release 키스토어와 properties 파일 네 개를 만들 위치입니다. 3편에서는 이 경로를 사용할 것과 서명 파일을 Git 저장소 안으로 옮기지 않는다는 원칙만 정합니다.

AGENTS.md와 Android Skills의 역할을 나눈다

AGENTS.md에는 앱의 목표, 구현 범위, 민감정보 처리, 검증 명령처럼 매 작업에서 반복할 기준을 적습니다. Codex는 실행을 시작할 때 프로젝트 루트부터 현재 작업 디렉터리까지 지침 체인을 구성하며, 더 가까운 디렉터리의 지침을 나중에 적용합니다. 자세한 탐색 순서는 OpenAI AGENTS.md 공식 문서에서 확인할 수 있습니다.

스킬은 특정 작업에서만 필요한 절차입니다. Codex는 먼저 스킬의 이름과 설명을 보고, 요청과 관련이 있을 때 전체 SKILL.md를 읽습니다. 참고자료는 SKILL.md에서 요구하는 항목만 추가로 확인합니다. Navigation 3 구현, Intent 보안 점검, 테스트 환경 구성처럼 범위가 뚜렷한 절차를 AGENTS.md에 복사하지 않는 이유입니다.

  • AGENTS.md: 제품 범위, 안전 규칙, 기술 근거, 검증, 버전과 Git 운영 기준
  • 스킬: Navigation 3, Intent 보안, 테스트 구성, 아키텍처 리뷰 등 작업별 절차

AGENTS.md에는 “Navigation 3 작업에서는 설치한 공식 스킬을 사용한다” 정도의 연결 규칙만 둡니다. 같은 절차를 두 곳에 복사하면 한쪽만 갱신되어 서로 다른 지시가 남을 수 있습니다.

AGENTS.md는 프로젝트 전체 규칙에 연결되고 SKILL.md는 Navigation Intent 보안 테스트 작업에 선택적으로 연결되는 구조
AGENTS.md는 모든 작업에 적용할 기준을 담고, 각 SKILL.md는 관련 작업에서만 불러옵니다.

AGENTS.md에 프로젝트 공통 규칙을 기록한다

먼저 앱의 정체성과 제품 경계를 고정합니다. 사용자에게 보일 이름은 Markdown Viewer, Application ID와 초기 namespace/package는 com.siamakerlab.markdownviewer입니다. 앱은 Markdown 파일을 빠르고 정확하게 읽는 Viewer이며 편집 기능은 제공하지 않습니다.

판단 근거도 함께 지정합니다. 제품 범위는 MVP.md, 구현 순서와 완료 조건은 ROADMAP.md, 실제 도구와 호환 조합은 DEVELOPMENT_ENVIRONMENT.md를 우선합니다. Android API와 라이브러리의 현재 동작은 추측하지 않고 공식 문서와 원본 저장소에서 확인하게 합니다.

안전 규칙에는 ../keystores와 서명 설정, 비밀번호, 토큰, 개인 절대경로를 Git에 넣지 않는 조건을 포함합니다. 파일 대량 삭제나 원격 저장소 변경처럼 복구 비용이 큰 작업은 범위를 먼저 확인하고, 코드 변경 뒤에는 범위에 맞는 Build, Test, Lint 결과를 보고하도록 정합니다.

1단계: 작성 또는 갱신 요청

다음 프롬프트는 현재 존재하는 문서만 근거로 사용하고 앱 코드는 작성하지 않도록 범위를 제한합니다.

현재 프로젝트 루트의 파일과 디렉터리 구조를 확인해.
프로젝트 루트의 AGENTS.md를 작성하거나 갱신해.
DEVELOPMENT_ENVIRONMENT.md, MVP.md, ROADMAP.md만 근거로 사용하고,
아직 존재하지 않는 관리문서나 스킬이 있다고 가정하지 마.
앱 코드는 작성하지 마.

AGENTS.md가 없으면 새로 작성해.
이미 있다면 유효한 기존 지침은 보존하고,
현재 프로젝트 자료와 달라졌거나 빠진 내용만 고쳐.

반드시 포함할 내용:
- App Name: Markdown Viewer
- Application ID: com.siamakerlab.markdownviewer
- 초기 namespace/package: com.siamakerlab.markdownviewer
- 편집 기능 없이 Markdown 파일을 빠르고 정확하게 읽는 Viewer 범위
- Kotlin(Jetpack Compose), Navigation 3, Android 공식 문서 우선 원칙
- 관련 공식 Android 스킬이 설치된 뒤에는 Navigation 3, adaptive UI,
  edge-to-edge, Intent 보안, 테스트 구성, R8 분석 작업에서
  해당 스킬을 사용하는 규칙
- Architecture Guardian이 설치된 뒤에는 구조 변경 전에
  영향 범위와 회귀위험을 검토하는 규칙
- 키스토어와 서명 설정 파일은 프로젝트 루트 기준
  상대경로 ../keystores에만 보관하는 규칙
- ../keystores 안의 파일, 비밀번호, 토큰, 개인 절대경로를
  Git에 추가하지 않는 규칙
- 변경 범위에 맞는 Build, Test, Lint를 실행하고 결과를 보고하는 규칙

버전 규칙:
- versionName은 major.minor.patch 형식
- 호환성을 깨는 변경은 major, 기능 추가는 minor,
  버그 수정은 patch 증가
- versionCode는 yymmddrrr 형식
- rrr은 같은 날짜의 릴리즈 순서이며 001부터 증가
- versionCode는 이전 Google Play 배포 값보다 항상 커야 함
- Google Play 허용 최댓값 2100000000을 넘지 않음
- 값 자동 생성은 매 Debug Build가 아니라 릴리즈 준비 단계에서만 실행
- 아직 Gradle 프로젝트가 없으므로 자동화 구현은 ROADMAP 작업으로 기록

Git 규칙:
- ROADMAP의 단위작업을 마칠 때 관련 검증을 통과한 변경만 commit
- commit 전에 git status와 git diff 확인
- 사용자 변경, 민감정보, 현재 작업과 관계없는 파일을 포함하지 않음
- ROADMAP의 한 페이즈가 끝나면 로컬 commit과 검증 결과를 확인한 뒤 push
- force push는 별도 승인 없이 사용하지 않음

작성 후에는 앱 코드를 건드리지 말고 다음만 보고해.
- 새로 작성하거나 바꾼 AGENTS.md 항목
- 원본 문서에서 가져온 근거
- ROADMAP에 추가해야 할 후속 작업
- 판단이 필요해 보류한 항목

2단계: 새 세션에서 적용 지침 확인

Codex는 실행을 시작할 때 AGENTS.md 지침 체인을 한 번 구성합니다. 파일을 새로 만들거나 고친 뒤에는 변경 내용을 먼저 검토하고, 새 Codex 세션에서 실제 적용 지침을 확인합니다.

git diff -- AGENTS.md
현재 적용 중인 프로젝트 지침의 출처와 핵심 규칙을 요약해.
특히 다음 항목이 포함되었는지 확인해.
- Markdown Viewer의 제품 범위
- ../keystores와 민감정보 보호
- versionName과 versionCode
- 검증 후 commit, 페이즈 종료 후 push
- Android 공식 스킬과 Architecture Guardian 사용 조건

빠졌거나 서로 충돌하는 지침이 있으면 파일을 바로 수정하지 말고 먼저 보고해.

AGENTS.md 결과 예시

프로젝트마다 문구는 달라도 됩니다. 아래처럼 규칙의 근거와 실행 조건이 구분되어 있으면 충분합니다.

# Markdown Viewer project instructions

## Product scope
- App name: Markdown Viewer
- Application ID and initial namespace: com.siamakerlab.markdownviewer
- Read and render Markdown files. Do not add editing features.
- Use MVP.md for product scope, ROADMAP.md for implementation order,
  and DEVELOPMENT_ENVIRONMENT.md for verified tool versions.

## Safety and verification
- Keep keystores and signing properties under ../keystores.
- Never commit passwords, tokens, keystores, or personal absolute paths.
- Run the Build, Test, and Lint checks relevant to the changed scope.

## Version and Git workflow
- Use major.minor.patch for versionName.
- Generate yymmddrrr versionCode only while preparing a release.
- Commit one verified ROADMAP task at a time.
- Push after a ROADMAP phase is complete. Never force-push without approval.

## Task-specific guidance
- Use installed official Android skills for Navigation 3, adaptive UI,
  edge-to-edge, Intent security, testing, and R8 analysis.
- Use Architecture Guardian before structural changes.

버전과 Git 규칙은 실행 시점까지 적는다

Markdown Viewer versionName과 yymmddrrr versionCode의 릴리즈 관리 규칙
versionName은 사용자에게 보이고 versionCode는 출시 순서를 판단합니다. 자동 생성은 릴리즈 준비 단계에서만 실행합니다.

versionNamemajor.minor.patch 형식으로 관리합니다. 호환성을 깨는 변경은 major, 기능 추가는 minor, 버그 수정은 patch를 올린다는 프로젝트 규칙입니다. Android가 이 의미를 강제하는 것은 아닙니다.

versionCodeyymmddrrr 형식을 사용합니다. 2026년 8월 24일의 첫 릴리즈는 260824001이고, 마지막 세 자리 rrr은 같은 날짜 안에서 001부터 증가합니다. 이 형식도 Android 표준이 아니라 시아메이커랩에서 사용하는 운영 규칙입니다.

자동 생성은 매 Debug Build가 아니라 릴리즈 준비 단계에서만 실행합니다. 그때 이전 Google Play 배포 값보다 큰지, Google Play의 2100000000 상한을 넘지 않는지 확인합니다. 아직 Gradle 프로젝트가 없으므로 지금은 규칙과 후속 작업만 문서화합니다.

Git은 ROADMAP의 단위작업 하나를 검증하고 되돌릴 수 있는 크기로 나눕니다. 커밋 전에는 git statusgit diff를 확인하고, 현재 작업과 관계없는 사용자 변경이나 민감정보가 섞이지 않았는지 검사합니다. push는 여러 단위작업이 모여 한 페이즈를 마쳤을 때 실행합니다.

검증된 단위작업을 Git 커밋하고 페이즈 종료 후 원격 저장소에 push하는 흐름
커밋에는 검증을 통과한 한 작업만 담고, 페이즈가 끝났을 때 원격 저장소에 push합니다.
작업 경계 확인할 내용 Git 작업
Android 프로젝트 골격 생성 Gradle 동기화와 Debug Build 확인 검증한 프로젝트 골격만 commit
파일 열기와 공유 Intent 처리 관련 테스트와 변경 범위에 맞는 Build 확인 Intent 처리와 관련 테스트를 한 단위로 commit
Viewer 핵심 구현 페이즈 완료 ROADMAP의 Build, Test, Lint와 git status, git diff 확인 로컬 commit을 확인한 뒤 push

Android Skills는 먼저 고르고, 승인한 뒤 설치한다

Google은 Android Skills 공식 문서android/skills 저장소에서 Android 개발용 스킬을 공개하고 있습니다. 스킬은 최신 Android API와 복잡한 작업 절차를 에이전트가 필요할 때 불러오는 지침입니다. 목록 전체를 무조건 설치하지 않고 MVP.mdROADMAP.md에 직접 연결되는 항목부터 고릅니다.

Android CLI와 공식 Android Skills를 소개하는 Android Developers 공식 영상입니다.

2026-08-25 기준 공식 배포 목록

포스팅 시점의 Google 공식 배포 매니페스트에는 22개 스킬이 등록되어 있습니다. 저장소의 목록은 계속 바뀔 수 있으므로, 아래 내용은 aaca635061a4befdd3890d63c4a02963f2e8d925 커밋을 기준으로 고정했습니다. 글이 지나치게 길어지지 않도록 전체 목록은 기본으로 접어 둡니다.

2026-08-25 기준 Google 공식 Android Skills 22개 전체 목록 보기
  1. agp-9-upgrade – Android 프로젝트를 Android Gradle Plugin 9으로 마이그레이션합니다.
  2. camerax – CameraX 기반 카메라 구현, 녹화 생명주기, 하드웨어 연동 및 ML Kit·Media3 통합을 안내합니다.
  3. appfunctions – 앱의 주요 작업을 Android AppFunctions로 노출하여 시스템이나 AI 에이전트가 실행할 수 있게 합니다.
  4. android-cli – 프로젝트 생성, SDK·에뮬레이터 관리, 공식 문서 검색 및 스킬 설치 등 Android CLI 사용법을 제공합니다.
  5. restore-credentials – 기기 복원 후 자동 로그인에 필요한 Credential Manager의 Restore Credentials 구현을 안내합니다.
  6. verified-email – Credential Manager를 이용해 OTP 없이 검증된 이메일을 안전하게 가져오는 흐름을 구현합니다.
  7. adaptive – 휴대전화, 태블릿, 폴더블, 데스크톱 등 다양한 창 크기와 입력 방식에 대응하는 Compose UI를 구현합니다.
  8. migrate-xml-views-to-jetpack-compose – 기존 XML View 화면을 단계적으로 Jetpack Compose로 이전합니다.
  9. styles – Compose Styles API를 도입하여 컴포넌트 테마와 상태별 스타일을 통합 관리합니다.
  10. media3-cast-integration – Jetpack Media3 기반 Google Cast 재생 기능을 Compose 또는 View 앱에 통합합니다.
  11. navigation-3 – Navigation 3 설치·이전과 back stack, deep link, 다중 pane 및 Scene 패턴을 구현합니다.
  12. r8-analyzer – R8·ProGuard 규칙의 중복과 과도한 keep 범위를 분석하여 앱 크기와 최적화 설정을 개선합니다.
  13. engage-sdk-integration – Play Engage SDK 통합, 콘텐츠 엔티티 매핑, 게시 코드 생성과 오류 해결을 지원합니다.
  14. play-billing-library-version-upgrade – 기존 Google Play Billing Library를 최신 안정 버전으로 이전합니다.
  15. play-policy-insights – 앱 코드와 Play Store 선언을 비교하여 권한, 데이터 안전성 및 정책 준수 위험을 점검합니다.
  16. android-profiler – 시스템 트레이스, 메모리, 할당, 호출 스택, jank 및 시작 성능을 기록하고 분석합니다.
  17. android-intent-security – Manifest와 수신 Intent를 점검하여 Intent Redirection 및 무단 컴포넌트 접근을 방지합니다.
  18. edge-to-edge – Compose 앱의 edge-to-edge, 시스템 바, IME inset 및 콘텐츠 겹침 문제를 처리합니다.
  19. testing-setup – Android 단위·UI·스크린샷·E2E 테스트 전략과 테스트 인프라를 구성합니다.
  20. leanback-to-compose-tv-migration – Android TV의 Leanback·Fragment·View 기반 UI를 Compose for TV로 이전합니다.
  21. wear-compose-m3 – Wear OS Compose Material 3 화면, 내비게이션, ambient mode 및 기존 Material 이전을 안내합니다.
  22. display-glasses-with-jetpack-compose-glimmer – Jetpack Compose Glimmer로 Android XR 디스플레이 안경용 UI와 상호작용을 구현합니다.
ROADMAP에서 필요한 Android Skills를 선별하고 사용자 승인 후 설치해 파일과 의존성을 검증하는 흐름
ROADMAP과 연결되는 스킬을 먼저 제안받고, 승인한 항목만 설치한 뒤 실제 파일과 의존성을 확인합니다.

1단계: 설치하지 않고 선정안만 받기

선정 단계에서는 특정 스킬을 후보로 먼저 제시하지 않습니다. 이름을 미리 지정하면 AI가 그 범위 안에서만 이유를 찾을 수 있기 때문입니다. 공식 배포 목록 전체와 프로젝트 자료를 함께 읽게 한 뒤, 필요한 항목과 미뤄도 되는 항목을 구분하게 합니다.

DEVELOPMENT_ENVIRONMENT.md, MVP.md, ROADMAP.md를 먼저 읽어.
앱 코드를 작성하거나 스킬을 설치하지 마.

Android 공식 문서와 android/skills 공식 저장소를 확인하고,
현재 환경에서 Android CLI를 실행할 수 있는지 점검해.
android skills list --long 결과와 각 SKILL.md를 근거로
공식 배포 목록 전체에서 Markdown Viewer에 필요한 스킬만 제안해.

제안한 스킬마다 다음을 표로 보고해.
- 연결되는 ROADMAP 작업
- 지금 필요한 이유
- 설치를 미뤄도 되는 이유
- 포함된 scripts, references, 외부 의존성
- 권장 설치 여부

선정하지 않은 스킬은 제외 이유를 짧게 덧붙여.
아직 설치하거나 파일을 변경하지 말고 내 승인을 기다려.

선정 결과: Markdown Viewer에 설치한 스킬

전체 목록을 ROADMAP과 대조한 뒤, 앞으로 구현과 검증에 사용할 스킬은 다음 6개로 정했습니다.

  • navigation-3: 두 Route, 단일 back stack, predictive back과 상태 복원
  • adaptive: 휴대전화·태블릿·폴더블·멀티 윈도우 대응
  • edge-to-edge: system bar, cutout과 WindowInsets 처리
  • android-intent-security: ACTION_VIEW, ACTION_SEND, URI grant와 exported Activity 보안
  • testing-setup: JVM·Compose UI·instrumentation·성능 테스트 기반 구성
  • r8-analyzer: 릴리스 R8·ProGuard 검증과 앱 크기 최적화

성능 문제가 실제로 발생하면 android-profiler를 추가로 설치하고, 그 안의 다음 분석 워크플로를 사용합니다. 아직 앱 구현 전이라 성능을 측정할 단계가 아니므로 3편에서는 설치하지 않습니다.

  • perfetto-trace-analysis: 시작 지연, 스크롤 jank와 메모리 문제의 trace 분석
  • perfetto-sql: Perfetto trace의 세부 지표와 원인 조회

이 두 이름은 위의 22개 매니페스트에 별도 스킬로 등록된 항목이 아닙니다. 해당 고정 커밋에서는 android-profiler 내부의 Perfetto 분석 워크플로로 포함되어 있으므로 공식 배포 목록의 개수는 22개로 유지됩니다. 실제 사용 전에는 android-profiler가 설치되어 있는지 확인합니다.

2단계: 선정한 스킬을 모두 설치하고 확인하기

설치 명령과 옵션을 직접 나열할 필요는 없습니다. 1단계에서 확정한 목록을 그대로 전달하면 AI가 현재 환경과 공식 문서를 확인해 필요한 설치 작업을 진행합니다.

1단계에서 선정한 공식 Android 스킬을 모두 설치해.
설치가 끝나면 실제 설치 경로와 변경된 파일,
각 스킬에 포함된 scripts, references, 외부 의존성을 확인해.
ROADMAP의 어느 작업에서 사용할지도 함께 보고해.

선정하지 않은 스킬은 설치하지 말고,
승인 없이 기존 스킬을 삭제하지 마.

설치가 끝났다는 메시지만 보고 넘어가지 않습니다. 실제 설치 경로와 SKILL.md, 포함된 스크립트와 외부 의존성을 코드와 같은 기준으로 확인합니다. Codex의 스킬 목록에 새 항목이 보이지 않을 때만 세션을 다시 시작합니다. 설치 방법과 조합을 더 넓게 비교하려면 Android 앱 개발에 활용할 Agent Skills 추천과 조합 방법도 참고할 수 있습니다.

Architecture Guardian은 제안과 반영을 분리한다

Architecture Guardian은 Google 공식 Android 스킬이 아니라, 모듈 경계와 변경 영향, 회귀위험을 반복해서 확인하려고 만든 별도의 스킬입니다. 아직 앱 코드가 없으므로 이 단계에서는 MVP.mdROADMAP.md를 대상으로 PLAN 리뷰만 진행합니다.

파일 입력, 문서 파싱, 화면 렌더링의 책임이 한곳에 섞이지 않았는지, 상태 소유자가 분명한지, Intent 처리를 테스트 가능한 경계로 나눴는지 확인합니다. 대용량 문서가 메인 스레드와 메모리에 줄 수 있는 위험, 화면 크기가 바뀌어도 읽던 상태를 유지할 방법도 검토합니다. 기능을 늘리는 것이 아니라 Viewer 범위 안에서 구조상 필요한 작업과 완료 조건을 찾는 단계입니다.

MVP와 ROADMAP을 Architecture Guardian으로 검토하고 변경 제안 승인 후 ROADMAP에 반영하는 과정
Architecture Guardian은 먼저 위험과 변경안을 보고하고, 승인 경계를 통과한 항목만 ROADMAP에 반영합니다.

1단계: ROADMAP을 고치지 않고 변경안만 검토한다

Architecture Guardian 스킬의 PLAN 절차로 MVP.md와 ROADMAP.md를 리뷰해.
아직 앱 코드나 ROADMAP.md를 수정하지 마.

다음을 확인해.
- 파일 입력, Markdown 파싱, Compose 렌더링의 책임과 경계
- 상태 소유권과 화면 크기 변화 시 상태 유지
- ACTION_VIEW, ACTION_SEND, Content URI 처리 경계
- Navigation 3 back stack과 화면 전환 책임
- 단위 테스트와 실제 기기 테스트가 가능한 구조
- 대용량 문서가 메인 스레드와 메모리에 줄 수 있는 위험

각 제안마다 다음을 보고해.
- 담당 모듈과 단일 책임
- 외부에 공개할 계약과 캡슐화할 구현
- 의존성 방향
- 영향을 받는 기존 기능과 예상 회귀위험
- 회귀위험을 확인할 테스트와 완료 조건
- MVP 범위에 필요한 이유
- ROADMAP에 넣을 위치

유지보수성을 이유로 MVP 밖의 기능이나 역할 없는 계층을 추가하지 마.
먼저 변경 제안만 보고하고 ROADMAP.md를 수정하지 않은 채 내 승인을 기다려.

결과는 “발견한 위험 → 제안 → 테스트와 완료 조건 → ROADMAP 위치 → 승인 상태” 순서로 나오게 합니다. 예를 들어 Intent 처리 항목이라면 외부 입력을 받는 경계, 파싱 계층으로 넘길 계약, 잘못된 Content URI를 확인할 테스트가 한 묶음으로 제시되어야 합니다.

2단계: 승인한 항목만 ROADMAP에 반영한다

앞서 제안한 항목 가운데 내가 승인한 내용만 ROADMAP.md에 반영해.
승인하지 않은 기능, 계층, 의존성은 추가하지 마.

반영 후 다음을 보고해.
- 추가, 변경, 제거한 ROADMAP 항목
- 각 항목의 위치와 변경 이유
- 추가한 테스트와 완료 조건
- MVP 범위가 유지되는지
- 아직 판단이 필요한 항목

앱 코드는 작성하지 마.

Architecture Guardian의 설치와 사용 방식은 AI 코딩 회귀버그를 줄이는 Architecture Guardian Skill에서 확인할 수 있습니다.

프로젝트가 바뀌면 지침도 같이 갱신한다

제품 범위가 바뀌면 먼저 MVP.md를, 구현 순서와 완료 조건이 바뀌면 ROADMAP.md를 고친 뒤 AGENTS.md를 확인합니다. 앱 이름, Application ID, 도구 조합, 키스토어 경로, 버전 또는 Git 규칙이 달라졌을 때도 같은 순서로 갱신합니다.

스킬을 업데이트했다면 바뀐 SKILL.md, 스크립트와 의존성을 다시 검토합니다. Codex가 변경을 감지하지 못했을 때만 새 세션을 시작합니다. 한 번 발생한 오류나 임시 해결책까지 모두 공통 지침으로 올리기보다, 이후 작업에서도 반복할 규칙인지 먼저 구분하는 편이 관리하기 쉽습니다.

검증 체크리스트

  • 저장소 루트의 AGENTS.md에 제품 범위, 안전, 버전과 Git 규칙이 들어갔다.
  • 새 Codex 세션에서 적용 중인 AGENTS.md의 출처와 핵심 규칙을 확인했다.
  • ROADMAP과 연결되는 공식 Android 스킬만 승인 후 설치했다.
  • 각 스킬의 실제 경로, SKILL.md, 스크립트와 외부 의존성을 확인했다.
  • 현재 세션에서 스킬 인식을 먼저 확인하고, 보이지 않을 때만 Codex를 다시 시작했다.
  • Architecture Guardian의 제안을 검토한 뒤 승인한 항목만 ROADMAP.md에 반영했다.
  • ../keystores, 비밀번호, 토큰과 개인 경로가 저장소 변경에 포함되지 않았다.

이번 편의 완료 상태

AGENTS.md, 승인한 Android 스킬, Architecture Guardian 검토가 ROADMAP과 연결됐다면 프로젝트 지침과 구조 검토 준비는 마친 셈입니다. 다음 편에서는 본격적인 구현 전에 프로젝트 루트의 keystore.txt에 서명 정보를 준비하고, Git 저장소 밖의 ../keystores에 debug·release 키스토어와 properties 파일 네 개를 만듭니다. 키스토어 준비까지 끝난 뒤 이 지침을 기준으로 Android 프로젝트 골격과 Markdown Viewer 기능을 구현합니다.

참고할 공식 문서

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다