nomadcode/agent-ops/rules/project/rules.md

nomadcode-core project rules

응답 언어

• 기본 응답은 한국어로 작성한다.

프로젝트 개요

nomadcode-core는 사용자 요청을 task로 저장하고, 비동기 agent 작업 흐름을 관리하기 위한 Go 서버다. HTTP API, PostgreSQL 저장소, sqlc 생성 코드, River job 실행, Plane/Mattermost adapter stub을 포함한다.

기술 스택

• Go 1.25.0
• chi HTTP router
• PostgreSQL, pgx, sqlc, goose
• riverqueue/river 기반 비동기 job
• Docker Compose 선택 실행 환경

프로젝트 특화 컨벤션

• internal/db/db.go, internal/db/models.go, internal/db/tasks.sql.go는 sqlc 생성 파일이므로 직접 수정하지 않는다.
• DB 스키마 변경은 migrations/와 queries/를 먼저 수정하고 ./bin/sqlc로 생성 코드를 갱신한다.
• 실행/검증 명령은 가능한 한 bin/ 스크립트 또는 Makefile alias를 사용한다.
• 외부 연동은 현재 adapter stub 단계이므로 실제 API 호출 추가 시 설정, 에러 처리, 테스트 경계를 함께 정한다.

도메인 매핑

경로 패턴	도메인	rules.md
internal/workflow/**	workflow	agent-ops/rules/project/domain/workflow/rules.md
internal/storage/**, internal/db/**, migrations/**, queries/**, sqlc.yaml	persistence	agent-ops/rules/project/domain/persistence/rules.md
internal/http/**, cmd/server/**	http-api	agent-ops/rules/project/domain/http-api/rules.md
internal/scheduler/**, internal/notification/**	scheduler	agent-ops/rules/project/domain/scheduler/rules.md
internal/adapters/**	adapters	agent-ops/rules/project/domain/adapters/rules.md

스킬 라우팅

현재 프로젝트 전용 스킬은 없다. 반복 작업이 안정적으로 드러난 뒤 agent-ops/skills/project/에 추가한다.