mattermost-mobile/Agent-Ops-SKILL.md

name	description	version
scaffold-agent-ops	프로젝트 상태를 판별하고 에이전트 진입 파일과 agent-ops 기본 스캐폴드를 생성하기 위한 초기 규칙	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//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 단계에서 불필요한 세부 구현까지 생성하지 않는다.