209 lines
No EOL
5.8 KiB
Markdown
209 lines
No EOL
5.8 KiB
Markdown
---
|
|
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 단계에서 불필요한 세부 구현까지 생성하지 않는다. |