Files
team_agent/.claude/teams/signit-v2.md
2026-03-20 17:57:55 +09:00

4.6 KiB

name, description
name description
signit-v2 Signit v2 전체 프로젝트 팀. 기획부터 배포까지 전 단계를 담당하는 풀스택 팀입니다. Edge/Cloud/Mobile 3계층 IoT 플랫폼 개발 및 운영.

Signit v2 팀 구성

팀 개요

스마트팜 IoT 통합 관리 플랫폼(Signit v2) 개발 팀. Edge(농가 현장) + Cloud(AWS) + Mobile 3계층 구조.

팀원 (Agents)

리드

  • tech-lead: 기술 방향 결정, 역할 간 조율, 아키텍처 최종 승인, 리스크 관리

기획/설계

  • product-planner: 기능 기획, 요구사항 분석, 사용자 스토리 작성
  • system-architect: 전체 시스템 설계, API 계약, MQTT 토픽 설계
  • db-architect: DB 스키마 설계, Alembic 마이그레이션, 인덱스/쿼리 최적화
  • security-architect: 보안 아키텍처 설계, JWT 흐름, 암호화 전략

개발

  • python-pro (user_backend, manager_backend): FastAPI 백엔드 개발
  • flutter-expert (user_frontend, mobile): Flutter UI 개발
  • frontend-developer (user_frontend): Flutter Web 현장 UI 개발
  • ui-ux-designer: 웹 UI/UX 설계 (Edge 현장 UI, 관리자 페이지)
  • mobile-ui-ux-designer (mobile): 모바일 앱 UI/UX (iOS/Android 패턴)

품질/보안

  • code-reviewer: 코드 리뷰, 품질 검토
  • qa-engineer: 테스트 케이스 설계, 오프라인 시나리오 검증, 버그 리포트
  • test-engineer: 테스트 자동화 코드 작성, CI/CD 파이프라인, 부하 테스트
  • security-auditor: 구현 코드 보안 점검, 취약점 분석, 보안 리포트
  • performance-engineer: 성능 프로파일링, Edge 리소스 최적화, 응답 시간 튜닝

운영/문서

  • doc-writer: 문서 작성 (md/xlsx/pptx/docx 형식별 목적에 맞게)

워크플로우

신규 기능 개발 플로우

1. product-planner      → 기능 정의서, 사용자 스토리
2. tech-lead            → 기술 방향 검토, 트레이드오프 결정
3. system-architect     → API 계약, 서비스 흐름 설계
4. db-architect         → DB 스키마, 마이그레이션 계획
5. security-architect   → 보안 요소 설계 (인증/인가/암호화)
6. ui-ux-designer       → 화면 설계 (웹)
   mobile-ui-ux-designer → 화면 설계 (모바일, 해당 시)
7. python-pro           → Backend 구현
8. flutter-expert       → Frontend/Mobile 구현
9. code-reviewer        → 코드 리뷰
10. test-engineer       → 자동화 테스트 작성
11. qa-engineer         → 테스트 케이스 검증 (오프라인 시나리오 포함)
12. security-auditor    → 보안 점검
13. performance-engineer → 성능 검증 (Edge 기준)
14. doc-writer          → 문서 업데이트 (md/xlsx/pptx/docx)

버그 수정 플로우

1. qa-engineer          → 버그 리포트, 재현 절차
2. tech-lead            → 우선순위 결정
3. python-pro /         → 수정 구현
   flutter-expert
4. code-reviewer        → 변경사항 리뷰
5. test-engineer        → 회귀 테스트 추가
6. qa-engineer          → 검증
7. doc-writer           → CHANGELOG 업데이트

보안/성능 이슈 대응 플로우

보안 이슈:
1. security-auditor     → 취약점 발견 및 리포트
2. security-architect   → 수정 방향 설계
3. tech-lead            → 우선순위 및 영향도 결정
4. python-pro           → 수정 구현
5. security-auditor     → 수정 검증

성능 이슈:
1. performance-engineer → 프로파일링, 병목 분석
2. db-architect         → 쿼리/인덱스 최적화 (DB 관련 시)
3. python-pro /         → 코드 최적화 구현
   flutter-expert
4. performance-engineer → 개선 검증 (Edge 기준 달성 여부)

서브 프로젝트 담당 Agent 매핑

프로젝트 주담당 Agent 보조 Agent
signit_v2_user_backend python-pro, debugger db-architect, performance-engineer
signit_v2_user_frontend flutter-expert, frontend-developer ui-ux-designer
signit_v2_manager_backend python-pro, debugger db-architect, system-architect
signit_v2_mobile flutter-expert, debugger mobile-ui-ux-designer
signit_v2_frp security-architect, security-auditor

문서 형식 규칙

형식 용도
.md 개발자용 (아키텍처, README, CLAUDE.md)
.xlsx API 명세서, 테스트 케이스
.pptx 사용자/현장 매뉴얼
.docx 운영 가이드, 보안 정책, 설치 가이드

작업 승인 규칙

  • Read/Add: 확인 불필요
  • Update/Delete: 사용자 확인 필요 + CHANGELOG 기록