nomadcode/agent-ops/skills/common/sync-push/SKILL.md

name	description
sync-push	현재 프로젝트의 agent-ops를 agentic-framework로 올리거나, agentic-framework의 공통 agent-ops를 대상 프로젝트 또는 상위 폴더의 agent-ops 적용 프로젝트 전체로 push하고 푸시한다. "agent-ops 싱크해", "agent-ops 동기화해", "agentic-framework에 올려줘" 요청 시 사용한다.

sync-push

목적

agent-ops/bin/sync.sh를 호출해 agent-ops 공통 파일을 push 방향으로 동기화한다.

• 일반 프로젝트에서는 현재 프로젝트 → agentic-framework 방향으로 올린다.
• agentic-framework 원본 프로젝트에서는 agentic-framework → 대상 프로젝트 방향으로 보내고, 대상 repo를 commit/push 한다.
• agentic-framework 원본 프로젝트에서 대상이 명시되지 않으면 현재 프로젝트의 상위 폴더에 있는 agent-ops 적용 프로젝트 전체로 보낸다.

언제 호출할지

• "agent-ops 싱크해", "agent-ops 동기화해" 요청 시
• "agentic-framework에 올려줘" 요청 시
• "agent-ops를 [프로젝트]로 싱크해" 요청 시

실행 절차

현 프로젝트가 일반 프로젝트인 경우 (.agent-ops-source 없음)

1. 현재 프로젝트의 상위 폴더(../) 에 agentic-framework 폴더가 있는지 확인한다 (현재 폴더 내부가 아님)
2. 있으면: agent-ops/bin/sync.sh 실행 또는 agent-ops/bin/sync.sh agentic-framework 실행
3. 없으면: 사용자에게 agentic-framework 경로 입력을 안내하고, 입력받은 경로로 실행
4. 공통 관리 파일 변경 없이 agent-ops/.version만 다른 경우 sync.sh는 버전 갱신과 commit/push를 건너뛴다
5. 일반 프로젝트에서 agentic-framework로 올릴 때는 AI ignore / permission 파일을 보강하거나 stage하지 않는다

현 프로젝트가 agentic-framework인 경우 (.agent-ops-source 있음)

1. 사용자 요청에서 target 프로젝트명 또는 경로를 추출한다
2. 명시된 경우: agent-ops/bin/sync.sh <target> 실행
3. 명시되지 않은 경우: agent-ops/bin/sync.sh 실행
4. target이 없으면 sync.sh가 현재 프로젝트 기준 상위 폴더(../)의 하위 디렉터리 중 agent-ops/ 폴더가 있는 프로젝트를 모두 대상으로 삼는다
5. sync.sh는 현재 agentic-framework의 agent-ops/rules/common/rules.md 내용을 대상 프로젝트 루트의 진입 파일에 덮어쓴다
6. 적용 후 각 대상 repo에서 agent-ops 공통 관리 경로(rules/common/rules.md 포함), 진입 파일, AI ignore / permission 파일을 stage 하여 commit/push 한다
7. AI ignore / permission 파일은 대상 프로젝트의 기존 내용을 덮어쓰지 않고, 누락된 표준 archive 제외 설정만 보강한다

덮어쓰기 대상은 init-agent-ops 초기 세팅과 동일하며, 실제 목록은 agent-ops/bin/entry-files.sh의 AGENT_OPS_ENTRY_FILES를 단일 기준으로 사용한다.

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

대상 프로젝트에 기존 진입 파일이 있어도 보존하거나 병합하지 않고 agent-ops/rules/common/rules.md 내용으로 교체한다.

agent-ops/bin/sync.sh [target]

푸시 대상 path는 항상 agent-ops/.version, agent-ops/bin, agent-ops/rules/common, agent-ops/skills/common, AGENT_OPS_ENTRY_FILES의 진입 파일로 제한한다. AI ignore / permission 파일은 framework에서 일반 프로젝트로 내려보내는 경우에만 대상 repo에서 추가 stage한다.

실행 결과 검증

• sync.sh 가 오류 없이 완료됐는가
• 버전 충돌 경고가 없었는가 — 있었다면 사용자에게 수동 머지 필요함을 알린다
• 대상 repo의 agent-ops/rules/common/rules.md가 현재 agentic-framework의 agent-ops/rules/common/rules.md와 일치하는가
• agentic-framework에서 대상 프로젝트로 push한 경우, agent-ops/bin/entry-files.sh의 모든 진입 파일 내용이 현재 agentic-framework의 agent-ops/rules/common/rules.md와 일치하는가
• framework에서 대상 프로젝트로 push한 경우, .geminiignore, .aiexclude, .cursorignore, .clineignore에 agent-task/archive/**와 agent-ops/roadmap/archive/**가 포함되어 있는가
• 일반 프로젝트에서 agentic-framework로 push한 경우, AI ignore / permission 파일이 agentic-framework에 유입되지 않았는가
• 대상 repo에 commit/push 된 path가 방향별 허용 범위로 제한되었는가

금지 사항

• sync.sh 를 거치지 않고 직접 파일을 복사하지 않는다