---
name: scaffold-agent-ops
description: 프로젝트 상태를 판별하고 에이전트 진입 파일과 agent-ops 기본 스캐폴드를 생성하기 위한 초기 규칙
version: 1.0.0
---

# 목적

이 스킬은 프로젝트에 Agent-Ops 구조가 없거나 불완전할 때,
현재 프로젝트 상태를 분석하여 다음을 세팅한다.

1. 에이전트 진입 파일
2. agent-ops 기본 폴더 구조
3. global rule
4. domain rule 템플릿
5. skill router
6. skill 템플릿
7. 초기 domain / skill 세팅

이 스킬은 과도한 초기 생성보다
"현재 프로젝트에 맞는 최소 스캐폴드" 생성을 우선한다.

# 핵심 원칙

- 기존 구조를 우선한다.
- 새 파일 생성은 꼭 필요한 최소 범위로 제한한다.
- 에이전트별 md는 얇은 진입점으로 둔다.
- 실제 규칙은 agent-ops 아래로 모은다.
- 도메인은 발명하지 말고 현재 구조에서 발견한다.
- 처음에는 핵심 도메인만 생성한다.
- 반복되는 작업만 초기 skill로 만든다.
- 불확실한 내용은 후보로 제시한다.

# 상태 판별

## 신규 프로젝트
다음 조건이 많으면 신규 프로젝트로 본다.

- 코드/폴더 구조가 단순하다
- 도메인 경계가 아직 약하다
- Agent-Ops 관련 파일이 없다
- 반복 작업 패턴이 아직 적다

## 운영중 프로젝트
다음 조건이 많으면 운영중 프로젝트로 본다.

- 모듈/폴더/패키지 경계가 보인다
- 반복 작업이 드러난다
- 기존 규칙/문서/관례의 흔적이 있다
- 핵심 책임 경계가 식별된다

# 생성 대상

이 스킬은 아래 구조를 기준으로 scaffold를 제안하거나 생성한다.

- CLAUDE.md
- GEMINI.md
- .cursorrules
- agent-ops/rules/global.md
- agent-ops/rules/_templates/domain-rule-template.md
- agent-ops/rules/domain/<domain>/rules.md
- agent-ops/skills/router.md
- agent-ops/skills/_templates/skill-template.md

필요 시 아래 초기 skill도 함께 제안한다.

- agent-ops/skills/find-domain/SKILL.md
- agent-ops/skills/code-change/SKILL.md

# 에이전트 진입 파일 원칙

CLAUDE.md, GEMINI.md, .cursorrules 는 공통적으로 얇게 유지한다.

각 파일에는 아래만 둔다.

- 응답 언어
- 기존 구조 우선
- 새 파일 생성보다 기존 수정 우선
- 작업 전 agent-ops/skills/router.md 참조
- 관련 rule / skill 만 최소 로드
- 세부 규칙은 agent-ops 아래 파일을 따른다

각 에이전트 진입 파일에 프로젝트별 상세 규칙을 중복 작성하지 않는다.

# Rule 구조 원칙

## global.md
전 프로젝트 공통 규칙만 둔다.

포함 항목:
- 응답 언어
- 기존 구조 우선
- 새 파일 생성보다 기존 수정 우선
- 코드 변경 전 관련 domain rule 확인
- 요청 범위를 넘는 변경 금지
- 불확실하면 단정하지 말고 후보 제시
- 플랫폼 특화 규칙은 global에 두지 않음

## domain rule
각 도메인 rules.md 는 아래만 둔다.

- 목적 / 책임
- 포함 경로
- 제외 경로
- 주요 구성 요소
- 유지할 패턴
- 다른 도메인과의 경계
- 금지 사항

# DDD 기준

도메인은 아래 기준으로 분류한다.

## Core Domain
핵심 가치와 주요 유즈케이스를 담당하는 영역

## Supporting Domain
핵심 도메인을 지원하는 영역

## Generic / Common
여러 도메인이 공통으로 사용하는 범용 영역

도메인은 반드시 실제 폴더, 모듈, 패키지, 네임스페이스, 책임 경계와 연결되어야 한다.

# Skill 구조 원칙

## router.md
router.md 는 작업 유형에 따라 필요한 skill 또는 domain rule만 로드하게 한다.

최소 라우팅 축:
- 구조 분석 / 스캐폴드
- 도메인 판별
- 코드 변경
- 흐름 추적
- 문서/릴리즈 정리

처음부터 너무 많은 분기를 만들지 않는다.

## skill-template.md
각 skill 은 아래 형식을 따른다.

- 목적
- 언제 호출할지
- 입력
- 먼저 확인할 것
- 실행 절차
- 출력 형식
- 금지 사항

# 신규 프로젝트 처리

신규 프로젝트일 때는 템플릿 중심으로 세팅한다.

1. 언어/구조를 확인한다.
2. 에이전트 진입 파일 3개를 얇게 생성한다.
3. agent-ops/rules/global.md 생성
4. domain-rule-template.md 생성
5. skills/router.md 생성
6. skill-template.md 생성
7. 핵심 domain placeholder 2~4개만 제안
8. 초기 skill 은 최소 2개만 제안한다.

신규 프로젝트에서는 domain rules 를 과도하게 채우지 않는다.

# 운영중 프로젝트 처리

운영중 프로젝트일 때는 현재 구조 기반으로 자동 채움한다.

1. 구조를 분석한다.
2. Core / Supporting / Generic 도메인 후보를 식별한다.
3. 실제 경로를 반영한 domain rules 초안을 제안한다.
4. 반복 작업 기반으로 필요한 초기 skill 을 제안한다.
5. router.md 에 기본 라우팅을 채운다.
6. 신규 프로젝트보다 한 단계 더 구체적으로 scaffold 한다.

운영중 프로젝트에서는 실제 코드 구조에 맞는 domain / skill 을 일부 채워 넣는다.

# 출력 형식

## 상태 판별
- Agent-Ops 상태: 없음 / 부분 적용 / 운영중
- 프로젝트 상태: 신규 / 운영중
- 근거: 짧게 요약

## 스캐폴드 계획
- 생성할 파일
- 바로 채울 파일
- placeholder 로 둘 파일

## 도메인 제안
- Core Domain
- Supporting Domain
- Generic / Common

## 초기 skill 제안
- skill 이름
- 필요한 이유

## 주의사항
- 지금 만들지 말아야 할 것
- 아직 확정하면 안 되는 것

# 금지

- 플랫폼 전용 규칙을 기본 scaffold 에 넣지 않는다.
- agent 별 md 에 상세 규칙을 중복 작성하지 않는다.
- 실제 구조보다 앞선 추상 구조를 강요하지 않는다.
- 처음부터 많은 domain / skill 을 만들지 않는다.
- scaffold 단계에서 불필요한 세부 구현까지 생성하지 않는다.