Workout History 출시 여정 — 회고와 설계 원칙 6개¶

출처¶

• raw/workout-history/TIMELINE.md — 출시 여정 회고(2026-08-19 심사 제출 스냅샷 + 2026-09-03 출시 후 표)
• raw/workout-history/TECH_NOTES.md — 설계 원칙 6개와 그 이유·함정(2026-09-03 공개 요약)
• 상세 설계 문서(PLANNING·CONCEPTS·ARCHITECTURE·DATABASE)는 비공개 앱 저장소가 유일한 원본입니다. 이 위키에는 공유 기준선(2026-08-19) 결정대로 회고와 개념 요약만 둡니다.

앱 한 줄¶

"3초 안에 기록하는" 맨손운동 중심 운동 기록 앱입니다. 요구사항 1번(R1)이 "3초 기록"이고, 이후 모든 설계 결정은 R1을 해치는지로 심판했습니다.

주요 이정표¶

설계 원칙 6개 — 어디로 승격했나¶

원칙 5 · 성능 예산의 구현 단서¶

헬스·걸음수 조회는 첫 프레임 이후로 미루고, 저장은 in-flight 가드로 더블탭 중복을 막습니다. 가드는 첫 await 이전의 동기 구간에 두어야 두 번째 탭이 끼어들 틈이 없습니다.

bool _saving = false;

Future<void> onSaveTap() async {
  if (_saving) return;      // 첫 await 이전, 동기 구간에서 차단
  _saving = true;
  try {
    await repo.append(record);
    haptic.success();       // 탭 → 햅틱 < 100ms 예산
  } finally {
    _saving = false;
  }
}

삽질 로그 — 다음에 안 밟기 위한 기록¶

개발 프로세스 — 에이전트 6역할¶

Claude Code 에이전트를 advisor(판단·범위·문서 정합) · app-developer(도메인·엔진·DB·네이티브) · ui-developer(화면·토큰·접근성) · qa-reviewer(머지 게이트) · tester(회귀 시나리오) · release-manager(버전·제출) 6역할로 나눴습니다.

에이전트가 여섯이면 이름이 흔들리는 순간 코드가 갈라집니다. 용어 사전은 문체 규칙이 아니라 병합 충돌 예방책입니다.

관련 페이지¶

• concept-local-first-append-only — 원칙 1·2·6의 영속 개념
• concept-wall-clock-state-machine — 원칙 3의 영속 개념
• concept-thin-client-idempotent-sync — 원칙 4의 영속 개념 + 증분 가져오기 앵커 함정
• concept-advisor-worker — 6역할 프로세스의 원형
• guide-project-docs-setup — PLANNING·ARCHITECTURE·BACKLOG 문서 체계의 템플릿
• src-on-pocket-news — 같은 1인 개발 사례: 통과 신호보다 화면 증적을 완료 기준으로
• src-morningbrief — 다음 1인 앱: 같은 개발 루프 규칙(5회 실패 시 중단)과 배치 + Firestore 구조

이 개념을 다룬 글¶

블로그 트렌드나침반에서 이 주제를 다룬 글입니다.

• 운동 기록 앱을 45일 만에 App Store에 올리기까지 — 혼자, 그리고 여섯 에이전트와
• AI 네이티브 시대 개발자 생존 전략: 앱 세 개를 AI 에이전트와 만들며 바뀐 내 역할