sync-upstream

Sterne0

Forks0

Aktualisiert9. Juli 2026 um 13:59

ADK fork chain의 upstream 동기화. naia-adk(최상위) 이하 모든 fork가 주기적으로 `git merge upstream/main`로 정식 동기화하도록 한다. selective cherry-pick으로 인한 체인 부패(divergence)를 예방. "upstream sync", "fork 동기화", "naia-adk에서 받아와", "sync-upstream" 요청 시 사용. drift(behind/merge-base 낡음) 감지→fetch→merge→버전 스탬프까지.

Installation

Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.

Quelle

nextain

nextain/naia-adk

GitHub-Repository öffnen Creator-Repositorys ansehen

Download

Verwandte BerufeSOC

Basierend auf der SOC-Berufsklassifikation

SoftwareentwicklerInformatik- und Mathematikberufe·SOC 15-1252

Datei-Explorer

3 Dateien

SKILL.md

readonly

name	sync-upstream
description	ADK fork chain의 upstream 동기화. naia-adk(최상위) 이하 모든 fork가 주기적으로 `git merge upstream/main`로 정식 동기화하도록 한다. selective cherry-pick으로 인한 체인 부패(divergence)를 예방. "upstream sync", "fork 동기화", "naia-adk에서 받아와", "sync-upstream" 요청 시 사용. drift(behind/merge-base 낡음) 감지→fetch→merge→버전 스탬프까지.
argument-hint	[--merge] [--remote URL]

Upstream 동기화 (Sync Upstream)

목적

ADK fork chain의 위생을 유지한다. selective cherry-pick 대신 정식 git merge upstream/main 로 주기적으로 동기화하여, 3개월치 sync 빚이 쌓여 대형 충돌이 되는 일(체인 부패)을 막는다.

Fork chain (위→아래)

naia-adk            ← 범용/개인 base (최상위, upstream_repo: null)
  └─ naia-business-adk   ← 회사 layer
       └─ nextain-adk     ← 넥스테인 org
            └─ alpha-adk   ← 루크 (넥스테인 직원)

onmam-adk는 naia-business-adk에서 분기. 각 fork는 바로 위 단계에서만 동기화한다 (skip-hop 금지 — nextain-adk가 naia-adk를 직접 받지 않고 business-adk를 받는 식).

버전 / 동기화 SoT

VERSION (루트) — 현재 adk 버전(semver). 동기화 시 upstream의 값으로 맞춰진다.
.agents/upstream-sync.yaml — 동기화 baseline. 각 fork가 자기 upstream_repo + 마지막 동기화 커밋/날짜를 기록. drift 감지의 기준.

핵심 스크립트

# drift 보고만 (변경 없음) — behind 정도, merge-base 낡음, 버전 차이 점검
node .agents/skills/sync-upstream/sync-upstream.js

# 실제 동기화: fetch + merge + 버전 스탬프
node .agents/skills/sync-upstream/sync-upstream.js --merge

# upstream remote가 없으면 declared upstream_repo에서 자동 세팅.
# 강제 지정: --remote https://github.com/nextain/naia-adk.git

출력은 ASCII-safe. 스크립트는 .agents/upstream-sync.yaml의 upstream_repo를 읽어 대상을 정한다. 최상위(naia-adk, upstream_repo: null)는 no-op.

워크플로우

Step 1: drift 보고

sync-upstream.js(인자 없음)로 현재 위생 상태를 본다:

behind 커밋 수 — 0이면 이미 최신.
merge-base 날짜 — 오래됐으면 동기화 빚.
version drift — local VERSION vs upstream VERSION.

behind가 크거나 merge-base가 수주 이상이면 Step 2.

Step 2: fetch + merge

--merge로 실행. 충돌이 없으면 자동으로 버전 스탬프까지 찍힌다.

Step 3: 충돌 해소 정책 (upstream-structure-first)

충돌이 나면 upstream(위 단계)의 구조적 개선을 우선 채택하고, fork 고유 layer 추가본만 보존:

분류	정책
SoT 구조 파일(context lessons/harness/gstack, hooks, settings)	upstream 것 채택 (신설계가 우선)
진입점 문서(AGENTS/CLAUDE/GEMINI/README)	upstream 내용 + fork 정체성(이름·scope·fork-chain)
`.gitignore`	양쪽 합집합
fork 고유 기능(회사 RBAC·business skills 등)	보존 (보통 비충돌 신규 파일이라 자동 포함)

핵심: fork가 가진 차이가 "낡은 구버전"이면 upstream 것으로, "진짜 layer 추가"면 보존. 헷갈리면 git log로 그 차이가 selective sync 잔재인지 fork 고유 작업인지 확인.

Step 4: 버전 스탬프 + push

clean merge면 스크립트가 VERSION + .agents/upstream-sync.yaml(upstream_commit, last_synced_at, adk_version)을 갱신. 변경 검토 후 git push origin main.

Step 5: 아래 단계로 연쇄

이 fork를 동기화했으면, 한 단계 아래 fork가 이제 이 fork를 upstream으로 sync-upstream 한다 (business-adk 완료 → nextain-adk가 business-adk sync → alpha-adk가 nextain-adk sync …).

언제 동기화하나

upstream에 의미 있는 변경(스kill/컨텍스트 추가, hook 개선)이 올라왔을 때
behind가 20+ 커밋 또는 merge-base가 2주+ 낡았을 때
정기(예: 월 1회) 위생 점검

Key Files

파일	용도
`sync-upstream.js`	drift 보고 + fetch/merge + 버전 스탬프 (node, 외부 의존성 무)
`VERSION`	adk 버전(semver)
`.agents/upstream-sync.yaml`	동기화 baseline SoT

참고

selective cherry-pick은 금지 아니다 — 긴급 단건 반영은 가능. 단, 정기 full merge를 대체하지 않음. cherry-pick만 계속하면 merge-base가 얼어붙어 빚이 쌓인다(이 스킬이 막는 현상).
skip-hop(한 단계 건너뛰기) 금지: nextain-adk는 naia-adk가 아닌 business-adk에서 받는다.
node 18+ 필요.

Mehr aus diesem Repository

gleiches Repository

verify-request-contract

nextain/naia-adk

원요청 무결성 하네스의 원문 해시체인, 완전 범위 추적, 서명 권한, 2회 Clean 결박, Claude Code/Codex 등록·동등성을 결정론으로 검증합니다. request-contract 코어·어댑터·설정·스키마·review-pass를 수정한 뒤, Review/Post-test Review 및 커밋 전에 반드시 사용합니다.

2026-07-140

manage-skills

nextain/naia-adk

세션 변경사항을 분석해 verify-* 스킬 드리프트를 탐지하고 자동 생성/업데이트합니다. issue-driven-development Sync 단계, 새 패턴/규칙 도입 후, PR 전 검증 스킬 커버리지 확인 시 반드시 사용. /manage-skills로 호출.

2026-07-140

review-pass

nextain/naia-adk

Stage-gated multi-AI cross-validation review with optional REQ-ID traceability. 4 stages (planning, development, test, integration) with configurable reviewers, finding consensus, and convergence loop. Fully project-agnostic and distributable.

2026-07-140

verify-implementation

nextain/naia-adk

등록된 모든 verify-* 스킬을 순차 실행해 통합 검증 보고서를 생성합니다. 기능 구현 후, PR 전, 코드 리뷰 시, issue-driven-development Review/Post-test Review 단계마다 반드시 사용. /verify-implementation으로 호출.

2026-07-140

session-resume

nextain/naia-adk

Claude Code / Codex / opencode 세션 기록을 열어 대화 흐름을 추출·요약한다. 다른 도구(또는 주간 한도 컷)에서 끊긴 작업을 현재 세션에서 이어하거나, 과거 세션이 무엇을 했는지 파악할 때 사용. "claude --resume <id>", "codex 세션 이어서", "opencode 세션 열어줘", "이전 세션 이어서", "저번 세션 뭐했지", "세션 기록 봐줘" 요청 시 사용.

2026-07-090

finetune-persona

nextain/naia-adk

Teach a character/persona to a Qwen3 base model with LoRA, evaluate before/after, export to GGUF, and load it into a naia container via the model-swap API. Dataset-driven and fully reusable — swap the JSONL and you get a different character (Deadpool → grumpy grandma → butler → dialect docent). Includes training-time measurement.

2026-07-040

name	sync-upstream
description	ADK fork chain의 upstream 동기화. naia-adk(최상위) 이하 모든 fork가 주기적으로 `git merge upstream/main`로 정식 동기화하도록 한다. selective cherry-pick으로 인한 체인 부패(divergence)를 예방. "upstream sync", "fork 동기화", "naia-adk에서 받아와", "sync-upstream" 요청 시 사용. drift(behind/merge-base 낡음) 감지→fetch→merge→버전 스탬프까지.
argument-hint	[--merge] [--remote URL]

Upstream 동기화 (Sync Upstream)

목적

Fork chain (위→아래)

naia-adk            ← 범용/개인 base (최상위, upstream_repo: null)
  └─ naia-business-adk   ← 회사 layer
       └─ nextain-adk     ← 넥스테인 org
            └─ alpha-adk   ← 루크 (넥스테인 직원)

버전 / 동기화 SoT

VERSION (루트) — 현재 adk 버전(semver). 동기화 시 upstream의 값으로 맞춰진다.
.agents/upstream-sync.yaml — 동기화 baseline. 각 fork가 자기 upstream_repo + 마지막 동기화 커밋/날짜를 기록. drift 감지의 기준.

핵심 스크립트

# drift 보고만 (변경 없음) — behind 정도, merge-base 낡음, 버전 차이 점검
node .agents/skills/sync-upstream/sync-upstream.js

# 실제 동기화: fetch + merge + 버전 스탬프
node .agents/skills/sync-upstream/sync-upstream.js --merge

# upstream remote가 없으면 declared upstream_repo에서 자동 세팅.
# 강제 지정: --remote https://github.com/nextain/naia-adk.git

출력은 ASCII-safe. 스크립트는 .agents/upstream-sync.yaml의 upstream_repo를 읽어 대상을 정한다. 최상위(naia-adk, upstream_repo: null)는 no-op.

워크플로우

Step 1: drift 보고

sync-upstream.js(인자 없음)로 현재 위생 상태를 본다:

behind 커밋 수 — 0이면 이미 최신.
merge-base 날짜 — 오래됐으면 동기화 빚.
version drift — local VERSION vs upstream VERSION.

behind가 크거나 merge-base가 수주 이상이면 Step 2.

Step 2: fetch + merge

--merge로 실행. 충돌이 없으면 자동으로 버전 스탬프까지 찍힌다.

Step 3: 충돌 해소 정책 (upstream-structure-first)

충돌이 나면 upstream(위 단계)의 구조적 개선을 우선 채택하고, fork 고유 layer 추가본만 보존:

분류	정책
SoT 구조 파일(context lessons/harness/gstack, hooks, settings)	upstream 것 채택 (신설계가 우선)
진입점 문서(AGENTS/CLAUDE/GEMINI/README)	upstream 내용 + fork 정체성(이름·scope·fork-chain)
`.gitignore`	양쪽 합집합
fork 고유 기능(회사 RBAC·business skills 등)	보존 (보통 비충돌 신규 파일이라 자동 포함)

Step 4: 버전 스탬프 + push

clean merge면 스크립트가 VERSION + .agents/upstream-sync.yaml(upstream_commit, last_synced_at, adk_version)을 갱신. 변경 검토 후 git push origin main.

Step 5: 아래 단계로 연쇄

언제 동기화하나

upstream에 의미 있는 변경(스kill/컨텍스트 추가, hook 개선)이 올라왔을 때
behind가 20+ 커밋 또는 merge-base가 2주+ 낡았을 때
정기(예: 월 1회) 위생 점검

Key Files

파일	용도
`sync-upstream.js`	drift 보고 + fetch/merge + 버전 스탬프 (node, 외부 의존성 무)
`VERSION`	adk 버전(semver)
`.agents/upstream-sync.yaml`	동기화 baseline SoT

참고

selective cherry-pick은 금지 아니다 — 긴급 단건 반영은 가능. 단, 정기 full merge를 대체하지 않음. cherry-pick만 계속하면 merge-base가 얼어붙어 빚이 쌓인다(이 스킬이 막는 현상).
skip-hop(한 단계 건너뛰기) 금지: nextain-adk는 naia-adk가 아닌 business-adk에서 받는다.
node 18+ 필요.