AI와 사람이 함께 코딩하는 협업 환경 구축

Spec(.kiro/specs): 기능별 요구사항, 설계, 작업 목록을 문서화하여 개발의 순차적 진행(Sequential Progression)을 지원하며, 각 단계는 사람의 승인을 거쳐야 다음 단계로 넘어갑니다.

Steering(.kiro/steering): 프로젝트 규칙을 정의하여 모든 대화에 자동으로 적용하거나 특정 파일 작업 시에만 제한적으로 적용할 수 있어, 일관된 개발 지침(Consistent Development Guidelines)을 유지합니다.

Hooks(.kiro/hooks): 파일 저장이나 작업 시작과 같은 이벤트에 검사를 적용하여, 조건이 맞지 않으면 실행을 차단함으로써 개발 프로세스의 무결성(Integrity of Development Process)을 강화합니다.

데이터 반출입 통제(Data Import/Export Control): 파일 이동은 엄격한 검사와 결재 절차를 거친 단일 경로로만 가능하도록 하여, 데이터 유출 위험(Data Leakage Risk)을 최소화합니다.

기관 단위 분리(Organization-level Separation): 단일 플랫폼을 여러 기관이 사용하더라도 각 기관의 데이터와 권한은 철저히 분리되어 데이터 격리 아키텍처(Data Isolation Architecture)를 보장합니다.

도메인 기반 개발 단위: 권한, 결재, 감사 기록, 격리 환경이 유기적으로 연동되도록 개발 단위를 14개 도메인으로 세분화하여, 작업 점유(Lock) 및 진척 측정의 기준 단위로 활용합니다.

통합 지침 관리: 개발자 개인의 프롬프트 의존에서 벗어나, Notion에 공통 지침, 기획, 명세를 통합 관리하며 모든 Agent는 작업 전 최신 내용을 참조합니다. 이는 설계 불일치(Design Inconsistency)를 방지하는 데 기여합니다.

실시간 변경 전파: Git 커밋/병합 완료 후 반영되는 방식과 달리, Notion의 공통 원본 갱신 시 다른 개발자와 Agent가 즉시 최신 지침을 참조할 수 있어 개발 흐름의 지연(Delay in Development Flow)을 줄입니다.

도메인 단위 작업 점유(Lock): 병합 시점에 충돌을 발견하는 일반적인 방식과 달리, 도메인 단위로 작업을 점유하여 한 영역에 활성 작업은 하나만 허용함으로써 착수 전 충돌을 차단합니다.

PM Agent의 프로젝트 관리: 개별 작업 및 코드 생성 중심에서 벗어나, PM Agent가 코드, 일정, 품질, 리스크를 지속 분석하여 프로젝트 관리를 지원합니다.

Git: 소스코드, 협업 프로토콜 문서, 영역별 Agent 지침 등 자주 변경되지 않는 불변 규칙(Immutable Rules)을 보관합니다. 코드와 동일한 타임라인에서 변경 이력을 추적하는 것이 유리하기 때문입니다.

Notion: 기획, 기능별 Spec, Plan, Tasks, 도메인 점유 현황판 등 자주 변경되고 즉시 공유되어야 하는 정보(Frequently Changing Information)를 관리합니다. 공유 지연 시 설계 불일치로 이어질 수 있다는 점을 고려했습니다.

단계별 문서화 및 승인: 각 단계별 산출물(Spec, Plan, Tasks 등)은 사람의 검토와 승인을 거쳐 다음 단계로 진행됩니다. 이는 코드 구현 전 방향 오류를 문서 단계에서 수정할 수 있게 합니다.

작업 개시 절차: 도메인 점유 체크와 기획 변경 체크라는 두 번의 확인을 거쳐야 작업에 착수할 수 있습니다. 이를 통해 동시 작업 시 발생 가능한 충돌(Concurrent Work Collisions)을 사전에 차단합니다.

협업 게이트: 작업 범위 파악, 기획 snapshot 대조, Status 전이 재검증 등 자동화된 검증 게이트를 통해 규칙 위반 시 작업을 중단시키고, 사람과 Agent 모두에게 동일한 절차를 예외 없이 적용합니다.

Lock 입자화: 주 도메인, BE only, FE only 등 마커를 사용하여 실제 수정 대상만 잠금으로써 병렬 작업의 효율성(Efficiency of Parallel Work)을 높입니다.

기능 진척 측정: 기획 대비 코드 구현 비율(%)을 도메인별로 산출하고, BE 구조, DB 마이그레이션, FE 화면 구현 등 구체적인 코드 기반 지표(Code-based Metrics)를 활용합니다.

개발 트랙 건전성 점검: 기획에 잡히지 않는 기반 작업의 건강 상태를 엔지니어링, 품질, 인프라, 기술 부채 등의 지표로 측정하여 시스템의 장기적인 안정성(Long-term System Stability)을 확보합니다.

상시 및 주간 관리 주기: 코드 변화, 진척, 병목을 상시 점검하고, 주간 단위로 기능 진척과 일정을 비교하며 신규 리스크를 리포트합니다. 대시보드 자동 생성을 통해 개발자와 관리자가 같은 근거로 의사결정할 수 있도록 지원합니다.