28 lines
1.3 KiB
Markdown
28 lines
1.3 KiB
Markdown
# 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`
|