nexo/agent-ops/rules/project/domain/workspace-ops/rules.md

domain	last_rule_review_commit	last_rule_updated_at
workspace-ops	60eb73c281	2026-05-26

workspace-ops

목적 / 책임

워크스페이스 공통 문서, helper command, 루트 수준 설정을 담당한다. 여러 모듈에 걸친 작업 흐름을 연결하되 각 모듈의 내부 책임을 침범하지 않는다.

포함 경로

• bin/ — root helper entrypoints: dev, test, lint, build
• docs/ — 여러 모듈에 걸친 제품, migration, 운영 문서
• README.md — workspace overview
• root .gitignore와 루트 수준 설정 파일
• agent-ops/rules/project/**, agent-ops/skills/project/** — 프로젝트 전용 agent-ops 규칙과 skill

제외 경로

• services/core/ — core server, webapp, API 구현 책임
• packages/messaging_flutter/ — Flutter push plugin 구현 책임
• apps/client/ — client host app 구현 책임
• agent-ops/rules/common/**, agent-ops/skills/common/** — 공통 framework 파일이며 프로젝트에서 직접 수정하지 않는다.

주요 구성 요소

• bin/test — Flutter tests와 선택적 Go test 실행
• bin/lint — Flutter analyze와 선택적 Go vet 실행
• bin/build — Flutter web build와 선택적 Go build 실행
• bin/dev — 개발 entrypoint 안내

유지할 패턴

• root helper script는 모듈별 command를 얇게 묶는 역할로 유지한다.
• 로컬 도구가 없을 때 skip하는 기존 동작을 보존하고, skip된 검증은 작업 보고에 명시한다.
• 여러 모듈에 걸친 문서는 docs/에 두고, 모듈 내부만 해당하는 설명은 해당 모듈 README나 docs에 둔다.
• 프로젝트 전용 agent-ops 파일만 수정하고 common 파일은 원본 framework에서 동기화한다.

다른 도메인과의 경계

• core-service: workspace script가 core 검증을 호출할 수 있지만 core 내부 명령 선택은 core 규칙을 따른다.
• messaging-flutter: plugin 검증은 workspace script로 실행할 수 있으나 API/플랫폼 계약은 plugin 도메인이 소유한다.
• client-app: client 검증은 workspace script로 실행할 수 있으나 app behavior는 client 도메인이 소유한다.

금지 사항

• root helper에 모듈 내부 business logic을 넣지 않는다.
• module-specific 문서를 이유 없이 root docs로 끌어올리지 않는다.
• agent-ops common 파일을 타겟 프로젝트에서 직접 편집하지 않는다.