Expo 앱을 만드세요. 주도권은 내 손에.

Autotomy는 Expo와 React Native 스타터입니다. 편집 가능한 TypeScript 소스, 아키텍처 검사, AI 코딩 도구와 함께 쓰는 CLI를 제공합니다.

스타터 내부 살펴보기
또는 프로젝트 폴더에서 실행
npx autotomy install

출시 준비가 완료되면 설치와 구매가 열립니다. 지금은 설치 안내를 확인할 수 있습니다.

나의 소스. 선택한 AI. 확인할 수 있는 검사.

앱은 무엇 위에 만들어질까요?

기반이 되는 도구Expo + React Native

Expo와 React Native가 모바일 플랫폼을 제공합니다. 라이브러리는 화면 이동, 스타일, 저장 등의 역할을 맡습니다.

스타터가 준비한 것Autotomy Expo Starter Pack

Autotomy는 명확한 프로젝트 구조, AI 작업 지침, 검사, 작동하는 예제를 제공합니다. 소스 코드는 직접 살펴보고 수정할 수 있습니다.

내가 만드는 앱나만의 기능과 서비스 연동

내 앱만의 기능을 더하세요. 인증, 백엔드, 결제는 제품에 필요해질 때 문서에 정리된 방식에 따라 추가하면 됩니다.

앱의 기반을 직접 확인하세요.

폴더를 선택하면 역할을 볼 수 있습니다.

autotomy / expo실제 소스를 따라가는 안내
expo / package.jsonAutotomy 기반 코드

좋은 도구에 명확한 역할을.

Expo와 React Native가 앱을 실행합니다. 라이브러리는 화면 이동, 스타일, 저장 등의 역할을 맡습니다.

이 구조가 필요한 이유

Autotomy는 프로젝트 구조, AI 작업 지침, 검사를 더합니다. 내 기능을 추가하기 전에 각 부분이 어떻게 연결되는지 확인할 수 있습니다.

기술 세부 내용 보기

라이브러리와 각각의 역할

외부 라이브러리이 구조가 필요한 이유
Expo모바일 개발 도구와 런타임React Native네이티브 앱 UIExpo Router파일 기반 탐색NativeWind유틸리티 클래스 스타일링TanStack Query서버 상태 조율AsyncStorage로컬 영속 저장Zod런타임 데이터 검증

package.json에 선언하고 pnpm으로 설치합니다. Autotomy의 어댑터는 프로젝트 자체 소스이며 외부 라이브러리 코드가 아닙니다.

폴더 안의 파일

package.json
pnpm-lock.yaml
expo / src/app/Autotomy 기반 코드

경로는 화면으로 들어가는 문입니다.

Expo Router 파일은 탭과 URL을 화면 및 컨트롤러에 연결합니다. 루트 계층에서는 앱의 프로바이더도 구성합니다.

이 구조가 필요한 이유

라우팅은 작게 유지합니다. 화면 표현과 제품 동작을 각자의 자리에 두어 경로 하나에 기능 전체가 담기지 않게 합니다.

기술 세부 내용 보기

폴더 안의 파일

src/app/_layout.tsx
src/app/(tabs)/settings.tsx
expo / src/ui/Autotomy 기반 코드

사용자가 보고 만지는 부분.

화면은 로딩, 준비 완료, 오류 상태를 보여줍니다. 공용 기본 컴포넌트와 조합이 일관된 시각 언어를 만듭니다.

이 구조가 필요한 이유

표현 계층은 명시적인 입력을 받습니다. 다른 화면 내부에 접근해 구현을 빌려 쓰지 않습니다.

기술 세부 내용 보기

폴더 안의 파일

src/ui/components/shared/
src/ui/components/common/
src/ui/settings/
expo / src/ui/settings/포함된 예제

작은 기능을 처음부터 끝까지.

화면 모양 설정은 화면, 컨트롤러, 유스케이스, reducer, 저장소 어댑터를 연결합니다. 로딩과 실패 상태도 포함합니다.

이 구조가 필요한 이유

자신의 기능을 추가하기 전에 아키텍처를 관통하는 완전한 경로 하나를 살펴볼 수 있습니다.

기술 세부 내용 보기
설정 변경 따라가기

포함된 Settings 기능을 단순화한 경로입니다. 단계를 선택하면 구현된 위치를 볼 수 있습니다.

폴더 안의 파일

src/ui/settings/
src/hooks/settings/useSettingsController.ts
src/use-cases/settings/settings.ts
src/services/settings.ts
expo / src/ui/puzzle-lab/포함된 예제

제거 경로까지 갖춘 예제.

실제로 작동하는 체스 퍼즐 기능으로 데이터를 가져오고, 오류를 처리하고, 앱의 각 부분을 연결하는 방법을 보여줍니다.

이 구조가 필요한 이유

완성된 예제에서 배운 뒤, 내 기능을 추가할 준비가 되면 보관할 수 있습니다. 포함된 설정 기능은 독립적으로 유지됩니다.

기술 세부 내용 보기

배운 내용은 남기고, 데모는 제거하세요.

src/*/puzzle-labdocs/reference/puzzle-lab

이 명령은 Puzzle Lab 전용입니다. 예제 소스를 보관하고 공용 코드에 기여한 내용을 검토용으로 기록합니다.

pnpm puzzle-lab:move-to-docs
pnpm check

폴더 안의 파일

src/ui/puzzle-lab/
src/hooks/puzzle-lab/usePuzzleLab.ts
src/use-cases/puzzle-lab/puzzle-lab.ts
src/services/lichess-puzzles/
expo / src/hooks/Autotomy 기반 코드

각 부분이 여기서 만납니다.

조합 hooks는 상태, 유스케이스, 서비스를 연결하고 화면에 필요한 모델과 동작을 준비합니다.

이 구조가 필요한 이유

화면은 표현에 집중하고, 이 계층은 화면이 제 역할을 하도록 필요한 작업을 조율합니다.

기술 세부 내용 보기
설정 변경 따라가기

포함된 Settings 기능을 단순화한 경로입니다. 단계를 선택하면 구현된 위치를 볼 수 있습니다.

폴더 안의 파일

src/hooks/settings/useSettingsController.ts
src/hooks/settings/settingsScreenModel.ts
expo / src/use-cases/앱 로직

앱이 무엇을 할지 결정합니다.

앱이 무엇을 할지 결정하는 곳입니다. 설정 기능은 여기서 사용자 환경설정을 저장하고 복원합니다.

이 구조가 필요한 이유

저장 동작과 저장 라이브러리를 분리했습니다. 실제 기기에 데이터를 쓰지 않고도 이 동작을 테스트할 수 있습니다.

기술 세부 내용 보기
설정 변경 따라가기

포함된 Settings 기능을 단순화한 경로입니다. 단계를 선택하면 구현된 위치를 볼 수 있습니다.

폴더 안의 파일

src/use-cases/settings/settings.ts
src/use-cases/puzzle-lab/puzzle-lab.ts
expo / src/state/앱 로직

변화를 따라갈 수 있는 상태.

순수 reducer가 상태 전이를 설명합니다. 지속되는 클라이언트 사실을 보관하고 Immer로 불변 업데이트를 수행합니다.

이 구조가 필요한 이유

네트워크와 저장소의 부수 효과는 다른 곳에 둡니다. 같은 상태와 입력이 주어지면 reducer는 같은 결과를 다시 만들 수 있습니다.

기술 세부 내용 보기
설정 변경 따라가기

포함된 Settings 기능을 단순화한 경로입니다. 단계를 선택하면 구현된 위치를 볼 수 있습니다.

폴더 안의 파일

src/state/settings/settings.state.ts
src/state/puzzle-lab/puzzle-lab.state.ts
expo / src/services/Autotomy 기반 코드

외부 도구는 경계를 통해 연결합니다.

앱을 저장소 및 외부 서비스와 연결하는 폴더입니다. 들어오는 데이터를 확인하고 오류를 처리한 뒤 결과를 돌려줍니다.

이 구조가 필요한 이유

각 연동이 위치할 곳이 명확합니다. 앱의 판단과 실제 작업을 수행하는 외부 도구를 분리해 유지합니다.

기술 세부 내용 보기
설정 변경 따라가기

포함된 Settings 기능을 단순화한 경로입니다. 단계를 선택하면 구현된 위치를 볼 수 있습니다.

폴더 안의 파일

src/services/settings.ts
src/services/api/
src/services/query-client.ts
expo / src/types/앱 로직

공통의 의미를 명확하게 기록합니다.

설정, 경로, 오류, 비동기 데이터에는 명시적인 타입이 있습니다. 결과 contract는 neverthrow 라이브러리를 사용합니다.

이 구조가 필요한 이유

각 구획은 서로의 구현을 가져오지 않고도 무엇을 주고받는지 합의할 수 있습니다.

기술 세부 내용 보기
설정 변경 따라가기

포함된 Settings 기능을 단순화한 경로입니다. 단계를 선택하면 구현된 위치를 볼 수 있습니다.

폴더 안의 파일

src/types/settings.ts
src/types/result.ts
expo / src/theme/Autotomy 기반 코드

한곳에서 바꾸는 UI의 시각 언어.

의미 기반 tokens와 테마 런타임이 앱의 시각 어휘를 정의합니다. tokens.ts에서 global.css의 테마 블록을 생성합니다.

이 구조가 필요한 이유

생성된 CSS를 수정하는 대신 원본 tokens를 바꿉니다. 공용 컴포넌트가 그 선택을 화면에 반영합니다.

기술 세부 내용 보기

폴더 안의 파일

src/theme/tokens.ts
src/theme/provider.tsx
src/theme/css-variables.ts
expo / src/route-error/Autotomy 기반 코드

화면을 그릴 수 없을 때.

Expo Router 오류 어댑터는 렌더링 실패를 기록하고 독립된 복구 화면을 제공합니다.

이 구조가 필요한 이유

대체 화면은 실패한 화면의 프로바이더에 의존하지 않아 복구 과정까지 함께 실패할 원인을 줄입니다.

기술 세부 내용 보기

폴더 안의 파일

src/route-error/index.tsx
expo / scripts/Autotomy 기반 코드

검사할 수 있는 규칙.

스크립트는 아키텍처 규칙, 테마 생성, 소스 패키징과 Puzzle Lab 보관 절차를 지원합니다.

이 구조가 필요한 이유

pnpm check는 타입, 경계, 테스트, 생성된 테마, 네이티브 설정과 의존성 검사를 함께 실행합니다. 문제를 찾을 수 있지만 오류 없는 앱을 보장하지는 않습니다.

기술 세부 내용 보기

폴더 안의 파일

scripts/eslint-rules.cjs
expo / docs/Autotomy 기반 코드

설계 이유를 소스와 함께 남깁니다.

담당 범위 안내, 기능 패턴과 slice 원형은 프로젝트의 구성과 확장 방법을 설명합니다.

이 구조가 필요한 이유

개발자와 AI가 다음 변경을 위해 같은 자료를 참고할 수 있습니다. 나중에 합류한 엔지니어도 같은 결정을 읽을 수 있습니다.

기술 세부 내용 보기

폴더 안의 파일

docs/SLICE_ARCHETYPES.md
docs/SETTINGS.md
docs/PUZZLE_LAB.md
expo / AGENTS.mdAutotomy 기반 코드

AI에게 프로젝트 규칙을 전달하세요.

AGENTS.md는 이 저장소에서 작업할 때 지켜야 할 아키텍처 경계와 지침을 기록합니다.

이 구조가 필요한 이유

범위를 정한 기능 요청에서 이 지침과 slice 원형을 참조하고, 검토 전에 pnpm check를 실행하도록 요구할 수 있습니다.

기술 세부 내용 보기

폴더 안의 파일

AGENTS.md
ARCHITECTURE.md
expo / START_HERE.mdAutotomy 기반 코드

구체적인 순서로 시작하세요.

사용 안내서는 설치, 스타터 실행, 변경 확인과 문제 발생 시 복구를 다룹니다.

이 구조가 필요한 이유

수정 가능한 소스와 문서화된 작업 절차를 제공합니다. 앱 스토어 계정, 서명과 제품별 출시 결정은 직접 맡습니다.

기술 세부 내용 보기

폴더 안의 파일

START_HERE.md
PRIVATE_BETA.md
폴더를 선택하면 역할을 볼 수 있습니다.TypeScript · Expo

AI에게 명확한 시작점을 주세요.

Codex, Claude Code 또는 Cursor에서 아래 프롬프트를 사용하세요. 브라우저에서 직접 로그인하고 결제하면 에이전트가 설치를 이어갑니다.

코딩 에이전트에 붙여넣기
Set up Autotomy in this project. Inspect the current directory and Git status first. Preserve all existing work and secrets. Run npx autotomy doctor --json to inspect compatibility, then npx autotomy install for an Autotomy or unchanged Lite checkout; use npx autotomy init <new-directory> for a new project. If the CLI requests authentication or a purchase, show me its browser link and let me complete it myself, then resume the command. Never ask me to paste credentials into chat. Do not bypass compatibility or verification failures, overwrite conflicting files, or subscribe on my behalf. Follow the installed project instructions, report any required hook approval, run npx autotomy check, and show me how to start the app from its expo directory.
시작하기

Autotomy란 무엇인가요?

Autotomy는 Expo와 React Native 스타터입니다. 편집 가능한 TypeScript 소스, 아키텍처 검사, AI 코딩 도구와 함께 쓰는 CLI를 제공합니다.

기반 코드에는 무엇이 포함되나요?

Foundation 전체 소스, 기본 검사, 에이전트 설정, 구매 버전과 공개된 v1 수정 사항에 대한 접근.

직접 추가하는 것은 무엇인가요?

제품의 기능입니다. 인증, 백엔드, 결제와 권한이 필요한 네이티브 기능은 제품이 필요로 할 때 추가하도록 의도적으로 남겨 두었습니다. 서비스를 선택하고 해당 기능 slice를 구현합니다.

하나를 바꾸고, 확인하세요.

START_HERE.md에서 시작하세요. AI에게 범위가 명확한 기능 하나를 설명하고, slice 원형에 따라 검사를 실행하세요. 결과를 확인한 뒤 다음 작업을 이어갑니다.

프로젝트 지침 보기스타터 내부 살펴보기
코딩 에이전트에 붙여넣기
Add <feature> as a cohesive slice in this Autotomy project. Read AGENTS.md and expo/docs/SLICE_ARCHETYPES.md first. Preserve architecture boundaries, explicit error handling, and existing work. Do not modify generated theme CSS directly. Run npx autotomy check, fix failures without weakening gates, and summarize the change and verification evidence.

소스부터 시작하고, 유지보수는 함께.

Foundation을 한 번 구매하고 필요할 때 감사와 업그레이드 안내를 추가하세요.

Lite

무료

최소한의 Expo 앱과 폴더 구조로 구매 전에 시작점을 살펴보세요.

Lite 설치 보기

Starter

US$149일회 결제

Foundation 전체 소스, 기본 검사, 에이전트 설정, 구매 버전과 공개된 v1 수정 사항에 대한 접근.

Starter에는 Pro 30일이 포함됩니다. 자동 갱신되지 않습니다.

내 계정으로 이동

Pro

US$19/ 월

또는 US$190 / 년

지속 관리되는 감사, 검증 설정 변경 감지, AI 지원 Expo 업그레이드, 프리미엄 hook 피드백.

내 계정

개발자 1명, Autotomy 프로젝트 수 무제한. Pro는 Starter가 필요합니다. 코딩 에이전트와 사용 비용은 별도입니다.

Pro 만료 후 프리미엄 명령어가 중지됩니다. 소스, 기본 검사, 빌드, 배포된 앱은 계속 작동합니다.

별도로 Pro를 구매하면 즉시 청구됩니다. 남은 포함 기간은 차감되지 않습니다. 갱신 전 취소하면 결제된 기간까지 사용할 수 있습니다.

출시 준비가 완료되면 설치와 구매가 열립니다. 지금은 설치 안내를 확인할 수 있습니다.

시작하기 전에

무엇을 구매하나요?

Starter는 편집 가능한 Expo 소스와 기본 검증입니다. Pro는 감사와 AI 업그레이드 안내를 위한 선택 구독입니다. 호스팅 앱 제작 서비스가 아닙니다.

포함된 30일이 끝나면 어떻게 되나요?

직접 구독하지 않으면 Pro가 중지되며 자동 청구되지 않습니다. 소스와 기본 검사는 계속 사용할 수 있습니다.

앱이 자동 수정되나요?

설치는 관리 대상 파일만 다룹니다. 감사는 근거와 수정 프롬프트를 제공하며 AI의 변경을 직접 검토합니다.

소스 라이선스는 무엇인가요?

기존 Foundation은 MIT 라이선스를 유지합니다. 새로운 프리미엄 도구와 안내에는 별도 상용 조건이 적용됩니다. 외부 패키지는 자체 라이선스를 유지합니다.

앱 인증과 결제가 포함되나요?

아니요. Autotomy 계정은 개발 도구용입니다. 앱 인증, 백엔드, 결제, 서명, 스토어 출시는 별도로 결정합니다.

AI와 함께 개발하는 기록

개발 노트 읽기