agent-shell/AGENTS.md

agent-shell 프로젝트 규칙

응답 언어

• 기본 응답은 한국어로 한다.
• 코드, 식별자, 명령어, 에러 메시지는 원문 표기를 유지한다.

프로젝트 개요

agent-shell은 제품 앱이 아니라 Flutter 앱들이 공통으로 가져다 쓰는 agent interaction package다. 채팅 메시지, tool call 표시, 승인 UI, capability registry, host integration boundary를 제공하되 IOP, NomadCode, OTO 같은 제품 도메인을 직접 알지 않는다.

작업 규칙

• lib/ 안에는 MaterialApp, runApp, Firebase/SystemChrome 같은 application bootstrap을 넣지 않는다.
• 제품별 의존성(iop_*, nomadcode_*)은 이 패키지에 import하지 않는다.
• 백엔드 transport, 인증, endpoint, theme, navigation은 host 앱이 주입한다.
• Agent capability는 interface와 event/command model만 제공하고, 제품별 capability pack은 각 제품 repo나 optional composition package가 소유한다.
• 새 public API를 추가하면 lib/agent_shell.dart export와 README 예시를 함께 확인한다.
• UI 위젯은 host layout에 embedded될 수 있게 fixed app chrome을 전제하지 않는다.
• 테스트는 변경 범위에 맞춰 flutter test를 우선 실행한다.

진입 파일

• README.md
• pubspec.yaml
• lib/agent_shell.dart
• agent-ops/rules/project/rules.md