nexo/agent-roadmap/archive/phase/product-foundation/milestones/identity-baseline.md

4.7 KiB

Milestone: 정체성 기준선

위치

  • Roadmap: agent-roadmap/ROADMAP.md
  • Phase: agent-roadmap/phase/product-foundation/PHASE.md

목표

이 Milestone은 nexo의 제품 정체성을 독립 메시징/알림 서비스로 고정한다. 알림은 메시징 서비스의 하위 경험으로 다루고, 문서, 설정, 코드의 public/project-owned naming은 nexo 기준으로 맞춘다.

상태

[완료]

구현 잠금

  • 상태: 해제
  • 결정 필요:
    • 없음
  • 결정 완료:
    • 2026-05-26: public package name과 사용자/프로젝트 소유 네이밍은 지금 nexo 계열 이름으로 전환한다.
    • 2026-05-26: 제품 표면은 알림 중심이 아니라 메시지 전체를 포함하는 메시징/알림 서비스로 둔다.
    • 2026-05-26: 기존 upstream/vendor 명칭은 최종 프로젝트 표면에 남기지 않는 것을 목표로 하며, 가능한 범위에서 코드 내 project-owned naming까지 교체 대상으로 본다.

범위

  • 제품명 nexo와 모노레포 정체성 정리
  • 메시지 전체와 알림을 포괄하는 서비스 범위 정리
  • 기존 기술 의존 표면과 nexo naming 전환 방향 기록
  • public 문서, 설정, package/import/native package 등 project-owned code naming의 전환 범위 정리
  • agent-ops 진입 규칙, README, roadmap 사이의 역할 분리
  • 현재 구조에서 유지할 모듈 경계 정리

기능

Epic: [identity] 제품 정체성

nexo가 제공하려는 서비스의 방향과 기존 기술을 대하는 방식을 문서와 네이밍 기준선으로 만든다.

  • [product-story] nexo를 메시지 전체와 알림을 포괄하는 독립 메시징/알림 서비스로 설명하는 문서 표현을 README, roadmap, domain rule에서 일관되게 유지한다. 검증: 관련 문서에서 제품 목표와 모듈 경계가 충돌하지 않는다.
  • [tech-boundary] 기존 upstream/vendor 명칭을 public product identity에서 제거하고, project-owned 문서/설정/코드 naming의 nexo 전환 기준을 정리한다.
  • [nexo-rename] package/import/native package 등 project-owned code identifier를 nexo 계열 이름으로 전환할 범위와 실행 순서를 정리한다. 검증: repo scan에서 기존 upstream/vendor 명칭이 허용된 compatibility context에만 남는다.
  • [module-shape] 최상위 구조를 apps/client, packages/messaging_flutter, services/core 중심으로 유지하고 과한 scaffold를 만들지 않는 원칙을 문서화한다.

Epic: [agent-entry] 작업 진입점

AI 에이전트와 사람이 같은 규칙으로 프로젝트에 들어오도록 작업 진입점을 고정한다.

  • [rules-entry] AGENTS.md, agent-ops/rules/project/rules.md, domain rules, roadmap current의 역할을 충돌 없이 연결한다.
  • [readme-entry] 루트 README가 제품 소개와 작업 진입점 역할을 함께 수행하도록 유지한다. 검증: README의 명령과 참조 경로가 실제 파일을 가리킨다.

완료 리뷰

  • 상태: 승인됨
  • 요청일: 2026-05-27
  • 완료 근거:
    • README.md, agent-ops/rules/project/rules.md, domain rules, roadmap 문서가 nexo를 메시징/알림 서비스로 설명하고 apps/client, packages/messaging_flutter, services/core 경계를 같은 기준으로 유지한다.
    • packages/messaging_flutterapps/client의 public package/import/native identifier가 nexo_messaging, NexoMessagingPlugin, com.tokilabs.nexo.messaging, com.tokilabs.nexo_client 계열로 정리되어 있다.
    • 기존 upstream/vendor 명칭은 services/core upstream 영역과 compose image/db/user/path, push-proxy config 같은 compatibility context에 남아 있다.
  • 리뷰 필요:
    • 사용자가 완료 결과를 확인했다
    • archive 이동을 승인했다
  • 리뷰 코멘트: 2026-05-27 사용자 승인으로 완료 처리하고 archive로 이동한다.

범위 제외

  • 프로토콜, 데이터 모델, 인증, 서버 기능 삭제처럼 동작을 바꾸는 독립 서비스화 작업은 이 Milestone에서 수행하지 않는다.
  • 외부 호환을 위해 즉시 제거할 수 없는 upstream/vendor 문자열은 허용 근거와 후속 제거 위치를 남긴다.
  • 별도 contract 패키지나 infra 모듈은 만들지 않는다.

작업 컨텍스트

  • 관련 경로: README.md, AGENTS.md, agent-ops/rules/project/rules.md, agent-ops/rules/project/domain/, agent-roadmap/, packages/messaging_flutter/, apps/client/, services/core/
  • 표준선(선택): 제품명은 nexo, 제품 표면은 메시지 전체를 포함하는 메시징/알림 서비스, public/project-owned naming은 nexo 계열로 전환
  • 선행 작업: 기존 monorepo migration과 README 보완
  • 후속 작업: 운영 기준선, 메시징 계약 표준화
  • 확인 필요: 없음