Skip to content

chore: AX 기반 이식 (CI · 테스트 · 규칙 문서 · MIT 라이선스) - #1

Merged
hyesngy merged 6 commits into
developfrom
chore/ax-foundation
Sep 13, 2026
Merged

hyesngy merged 6 commits into
developfrom
chore/ax-foundation

Conversation

@hyesngy

@hyesngy hyesngy commented Sep 13, 2026

Copy link
Copy Markdown
Contributor

무엇을 바꿨나

origin/chore/ax-setup의 AX 기반(CI · 테스트 · AI 규칙 문서 · 템플릿)을 develop에 선택 이식하고, 공개 저장소 · git-flow 기준으로 규칙 문서를 맞췄다. MIT 라이선스와 공통 문서(architecture · domain · decisions)를 추가했다.

커밋은 리뷰하기 쉽게 나눴다. Squash 머지하면 develop에는 하나로 합쳐진다.

  1. chore: AX 기반 파일 이식 — CI, PaxoTests 21개와 테스트 타깃, AGENTS.md · CLAUDE.md 3종, CONTRIBUTING, PR 템플릿, 프롬프트, 스킬
  2. chore: .gitignore · README 병합 — 비공개 경로 무시 규칙 유지 (브랜치 버전에는 docs/private 규칙이 없어 통째로 가져오지 않음)
  3. docs: git-flow · 공개 저장소 기준으로 규칙 문서 갱신
  4. chore: MIT LICENSE · 공통 문서 뼈대 추가
  5. style: swift-format 정규화 — 13개 파일, 동작 변경 없음. 리뷰 때 건너뛰어도 된다
  6. test: UsageTracker에 테스트용 UserDefaults 주입 지점 추가 — 과금 경로(Paxo/Store/). 기본값이 .standard라 앱 동작은 같다

가져오지 않은 것: .github/CODEOWNERS 자리표시자(계정 확정 후), 브랜치의 앱 Swift 스타일 커밋(develop 기준으로 새로 포맷), App Store 제출 문서(비공개 저장소로 이동)

어떻게 확인했나

xcodebuild -project Paxo.xcodeproj -scheme Paxo -destination 'platform=macOS' CODE_SIGNING_ALLOWED=NO test
# ✔ Test run with 21 tests in 4 suites passed · ** TEST SUCCEEDED **

git ls-files '*.swift' | grep -E '^(Paxo|PaxoTests)/' | xargs xcrun swift-format lint --strict --configuration .swift-format
# 위반 0건

find <DerivedData>/Build/Products/Debug/Paxo.app \( -iname '*.md' -o -iname '*.swift' \)
# 결과 없음 — EXCLUDED_SOURCE_FILE_NAMES 동작

git diff --name-only origin/develop...HEAD | grep -E '^(docs/private|docs/hansung)/|Secrets\.swift$'
# 결과 없음

체크리스트

  • 빌드와 테스트를 직접 돌려 통과를 확인했다
  • 새 유틸리티를 만들기 전에 기존 것을 검색했다
  • 코드에 들어간 숫자·문구·외부 정보를 직접 검증했다 (AI 초안을 그대로 믿지 않았다)
  • 프록시 계약(GeminiService ↔ api/generate.js)을 건드렸다면 양쪽 다 고쳤다
  • 시크릿이나 비공개 문서가 섞이지 않았다 (저장소는 공개)

머지 후

  • 전원 git pull (develop)
  • 팀원 1: CI가 develop에서 안정적으로 돌면 Rulesets에 필수 체크 추가, CODEOWNERS 작성
  • origin/chore/ax-setup 브랜치 삭제

- origin/chore/ax-setup에서 브랜치에만 있는 파일을 경로 단위로 가져옴
- CI(금지 파일 검사 · swift-format · 빌드 및 테스트), PaxoTests 21개와 테스트 타깃
- AGENTS.md · CLAUDE.md 3종, CONTRIBUTING, PR 템플릿, 프롬프트 라이브러리, Claude 스킬 3종
- 스타일 커밋 · .gitignore · README · CODEOWNERS는 제외하고 후속 커밋에서 병합
- .gitignore: 비공개 경로(docs/hansung · docs/private)는 유지하고 AI 도구 로컬 설정 제외를 추가
- README: 기여 · 에이전트 규칙 안내, 구조 표(테스트 · docs · 스킬 · CI), 로드맵, 브랜치 전략, 라이선스
- 브랜치의 README를 그대로 가져오지 않음 — 비공개로 옮긴 제출 문서 링크가 되살아나지 않게
- develop 통합(Squash) · main 릴리즈(Merge) 전략을 AGENTS.md · CONTRIBUTING · 프롬프트 · 스킬 · CI 트리거에 반영
- 비공개 저장소로 옮긴 제출 절차 링크와 존재하지 않는 온보딩 문서 링크를 바로잡음
- 루트 AGENTS.md 첫 줄에 "작업 시작 전 git pull", 공통 문서 인덱스 추가
- Paxo/AGENTS.md에서 이미 삭제된 주석을 인용하던 문장 정리
- 금지 파일 검사에 docs/private 추가, Claude 설정에 강제 푸시 · PR 머지 · 프로덕션 배포 · 사업 문서 읽기 거부 추가
- LICENSE (MIT)
- docs/decisions.md: 지금까지 합의한 결정 7건
- docs/architecture.md: 앱 ↔ 프록시 ↔ Gemini ↔ StoreKit 연결 초안
- docs/domain.md: 기능 · 과금 · 개발 용어 뼈대 (킥오프에서 보강)
- .swift-format 설정으로 Paxo · PaxoTests를 포맷 (동작 변경 없음)
- CI의 swift-format --strict 검사를 통과시키기 위한 별도 커밋
- 브랜치 5f02e6f의 앱 코드 변경을 이식 (첫 이식에서 스타일 변경으로 잘못 분류해 빠졌다)
- init(defaults:)의 기본값이 .standard라 앱 동작은 바뀌지 않는다
- 과금 경로(Paxo/Store/) 파일이다
@hyesngy
hyesngy merged commit 9f62657 into develop Sep 13, 2026
3 checks passed
@hyesngy
hyesngy deleted the chore/ax-foundation branch September 13, 2026 04:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant