toki/agentic-framework
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
agentic-framework/agent-ops/skills/common/init-agent-ops/SKILL.md
toki 6e92b028b5 초기화
2026-04-13 18:27:22 +09:00

7.6 KiB
Raw Blame History

name version description
init-agent-ops 1.1.0 프로젝트 상태를 판별하고 agent-ops 기본 스캐폴드를 생성하기 위한 초기 규칙

init-agent-ops

목적

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

  1. 에이전트 진입 파일
  2. agent-ops 기본 폴더 구조
  3. rules/project/rules.md (프로젝트 특화 규칙, 분석 후 생성)
  4. 초기 domain rule 초안
  5. 초기 skill (필요 시)

"현재 프로젝트에 맞는 최소 스캐폴드" 생성을 우선한다.

언제 호출할지

  • 프로젝트에 agent-ops 구조가 없을 때
  • agent-ops 구조가 불완전하여 재설정이 필요할 때
  • 사용자가 "agent-ops 초기화해줘", "에이전트 설정해줘" 요청 시

입력

  • project-type: 신규 / 운영중 (선택, 미지정 시 자동 판별)

먼저 확인할 것

  • 프로젝트 루트에 기존 agent-ops 관련 파일(CLAUDE.md, agent-ops/ 등)이 있는지 확인
  • .agent-ops-source 파일이 있는지 확인 (공통 관리 레포 여부)
  • 기존 진입 파일(CLAUDE.md, GEMINI.md 등)이 있는지 확인

핵심 원칙

  • 기존 구조를 우선한다.
  • 새 파일 생성은 꼭 필요한 최소 범위로 제한한다.
  • 도메인은 발명하지 말고 현재 구조에서 발견한다.
  • 처음에는 핵심 도메인만 생성한다.
  • 반복되는 작업만 초기 skill로 만든다.
  • 불확실한 내용은 후보로 제시한다.

상태 판별

신규 프로젝트

  • 코드/폴더 구조가 단순하다
  • 도메인 경계가 아직 약하다
  • Agent-Ops 관련 파일이 없다

운영중 프로젝트

  • 모듈/폴더/패키지 경계가 보인다
  • 반복 작업이 드러난다
  • 핵심 책임 경계가 식별된다

생성 대상

파일 방법
CLAUDE.md,GEMINI.md,AGENTS.md, .cursorrules, .clinerules 등 진입 파일 rules/common/rules.md를 에이전트별 파일명으로 프로젝트 루트에 복사 후 rules/common/rules.md 삭제
agent-ops/.version 공통 관리 레포의 VERSION 파일을 그대로 복사 (프레임워크 버전 추적용)
agent-ops/rules/common/ 공통 폴더 전체 복사 (수정 금지)
agent-ops/skills/common/ 공통 폴더 전체 복사 (수정 금지)
agent-ops/rules/project/rules.md 프로젝트 분석 후 생성
agent-ops/rules/project/domain/<domain>/rules.md 도메인 분석 후 생성
agent-ops/rules/private/ 폴더만 생성 (내용은 개인이 작성)
.gitignore에 agent-ops/rules/private/ 추가 git 추적 제외

에이전트별 파일명:

에이전트 파일명
Claude CLAUDE.md
Gemini GEMINI.md
Kilo Code / OpenCode AGENTS.md
Cursor .cursorrules
Cline .clinerules

에이전트 진입 파일 원칙

진입 파일은 rules/common/rules.md 내용 그대로를 에이전트별 파일명으로 복사한다. 별도 내용을 추가하거나 수정하지 않는다.

Rule 구조 원칙

rules/common/rules.md

  • 공통 관리 레포에서 제공. 프로젝트에서 직접 수정하지 않는다.
  • 실제 사용은 진입점 파일들에서 사용된다.

포함 항목:

  • 기본 원칙
  • 공통 스킬 라우팅 (router.md 참조)
  • project/rules.md 로드 지시

rules/project/rules.md

init-agent-ops가 프로젝트를 분석하여 생성한다.

포함 항목:

  • 응답 언어
  • 프로젝트 개요 / 주요 구조
  • 기술 스택
  • 프로젝트 특화 컨벤션
  • 도메인 매핑 테이블 (경로 패턴 → domain rules.md)
  • 프로젝트 스킬 라우팅 (해당 시)

common/rules.md와 내용이 중복되지 않도록 한다.

도메인 매핑 테이블 형식

## 도메인 매핑

| 경로 패턴 | 도메인 | rules.md |
|----------|--------|----------|
| `src/order/**` | order | `agent-ops/rules/project/domain/order/rules.md` |
| `src/payment/**` | payment | `agent-ops/rules/project/domain/payment/rules.md` |
| `src/common/**` | common | `agent-ops/rules/project/domain/common/rules.md` |

프로젝트 스킬 라우팅 형식

## 스킬 라우팅

| 요청 키워드 | SKILL.md |
|------------|----------|
| 테스트 실행해줘 | `agent-ops/skills/project/run-test/SKILL.md` |

domain rule

각 도메인 rules.md에는 아래만 둔다.

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

DDD 기준

  • Core Domain: 핵심 가치와 주요 유즈케이스
  • Supporting Domain: 핵심 도메인을 지원
  • Generic / Common: 여러 도메인이 공통으로 사용

도메인은 실제 폴더, 모듈, 패키지, 책임 경계와 연결되어야 한다.

실행 절차

  1. 상태 판별

    • 프로젝트 구조, 모듈 경계, agent-ops 파일 유무를 분석하여 신규/운영중을 판별한다

  2. 에이전트 진입 파일 생성

    • rules/common/rules.md를 에이전트별 파일명으로 프로젝트 루트에 복사한다
    • 복사 후 rules/common/rules.md를 삭제한다

  3. agent-ops 폴더 구조 복사

    • 공통 관리 레포의 agent-ops/ 공통 폴더(rules/common, skills/common)를 복사한다
    • agent-ops/.version 파일을 복사한다

  4. rules/project/rules.md 생성

    • 프로젝트를 분석하여 응답 언어, 프로젝트 개요, 기술 스택 등을 채운다
    • common/rules.md와 내용이 중복되지 않도록 한다

  5. 도메인 분석 및 domain rule 생성

    • 신규 프로젝트: 핵심 domain placeholder 2~4개만 제안한다. domain rules를 과도하게 채우지 않는다
    • 운영중 프로젝트: Core/Supporting/Generic 도메인을 식별하고 실제 경로를 반영한 초안을 생성한다

  6. 초기 skill 제안

    • 신규 프로젝트: 최소 2개만 제안한다
    • 운영중 프로젝트: 반복 작업 기반으로 필요한 skill을 제안한다

  7. 결과 보고

    • 상태 판별 결과, 생성된 파일 목록, 도메인 제안, skill 제안, 주의사항을 출력한다

출력 형식

상태 판별

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

스캐폴드 계획

  • 생성할 파일
  • 바로 채울 파일
  • placeholder로 둘 파일

도메인 제안

  • Core Domain
  • Supporting Domain
  • Generic / Common

초기 skill 제안

  • skill 이름
  • 필요한 이유

주의사항

  • 지금 만들지 말아야 할 것
  • 아직 확정하면 안 되는 것

실행 결과 검증

  • 진입 파일이 프로젝트 루트에 존재하고, 내용이 rules/common/rules.md와 일치하는가
  • agent-ops/rules/project/rules.md가 생성되었고, 필수 항목(응답 언어, 프로젝트 개요, 기술 스택)이 포함되어 있는가
  • 생성된 domain rules.md가 domain-rule-template.md 형식을 따르는가
  • rules/project/rules.md의 도메인 매핑 테이블에 생성된 도메인이 모두 등록되어 있는가
  • .gitignore에 agent-ops/rules/private/ 항목이 추가되어 있는가
  • 검증 실패 시: 누락된 파일/항목을 사용자에게 알리고 해당 부분만 보완한다

금지 사항

  • 진입 파일에 rules/common/rules.md 외 내용을 추가하지 않는다.
  • 실제 구조보다 앞선 추상 구조를 강요하지 않는다.
  • 처음부터 많은 domain / skill을 만들지 않는다.
  • rules/common/rules.md를 프로젝트에서 직접 수정하지 않는다.
  • rules/project/rules.md에 rules/common/rules.md와 중복되는 내용을 넣지 않는다.