← 실험실 목록

Xinics Skill Plugin

Jira 기반 개발 절차와 Xinics Brain을 결합한 Claude Code 플러그인입니다. 단계별 산출물을 검사하고 검증된 판단을 다음 이슈에 재사용합니다.

2026.03 ~ · Internal Developer Tool
Claude CodePlugin SDKXinics BrainContext EngineeringJiraMCPBitbucket

왜 만들었는가

같은 Jira 이슈를 맡겨도 에이전트의 결과는 일정하지 않았습니다. 원인은 모델 자체보다 단계, 입력과 완료 조건이 정의되지 않은 실행 구조에 있었습니다.

기술 조사부터 설계, 구현, 리뷰, 검증과 보고까지 책임과 진입 조건을 나눴습니다. 사람이 직접 실행하든 에이전트에 맡기든 같은 산출물과 검증 절차를 거치도록 했습니다.

Night Worker에서도 같은 단계 정의를 재사용해야 했습니다. 대화 유무와 상관없이 중단 조건과 검증 명령이 동작하도록 스킬 계약을 구조화했습니다.

내부 Bitbucket 인증을 유지할 수 있도록 로컬 마켓플레이스로 배포했습니다. 저장소에서 변경을 받은 뒤 plugin update로 적용하는 절차도 팀 문서에 남겼습니다.


판단과 검증을 잇는 개발 파이프라인

기술 탐색, 계획, 구현, 리뷰와 검증을 서로 다른 책임과 진입 조건으로 분리했다. 오케스트레이터가 Jira 이슈 상태와 이전 산출물을 읽어 다음 단계로 연결하고, 검증 근거가 없으면 완료로 처리하지 않습니다.

CONTROLLED DELIVERY LOOP

탐색에서 보고까지, 산출물이 다음 단계를 여는 파이프라인

오케스트레이터는 이슈 상태를 읽고 단계를 선택하며, 계획·검증 산출물이 없으면 구현이나 커밋으로 넘어가지 않습니다.

탐색에서 보고까지, 산출물이 다음 단계를 여는 파이프라인 오케스트레이터는 이슈 상태를 읽고 단계를 선택하며, 계획·검증 산출물이 없으면 구현이나 커밋으로 넘어가지 않습니다. FINDINGS PASS orchestrator route by Jira state tech-explore feasibility plan decision log develop implementation review risk scan verify evidence commit traceable change report shared context
화살표는 자동 실행 자체보다 단계별 입력·출력 계약을 뜻합니다.

orchestrator

Jira 이슈 상태와 기존 산출물을 읽고 필요한 스킬로 연결합니다.

tech-explore

구현 전에 기술 선택지와 제약, 타당성을 조사합니다.

plan

이슈의 복잡도에 맞춰 설계와 구현 순서를 구체화합니다.

develop

확정된 계획을 기준으로 코드를 구현하고 변경 범위를 추적합니다.

review

구현 결과를 계획과 비교하고 코드 결함과 회귀 위험을 점검합니다.

verify

QA 시나리오와 자동화 테스트를 실행하며, 실패하면 커밋 단계로 넘어가지 않습니다.

commit

정적 검사와 타입 검사를 통과한 변경만 Jira 이슈 번호와 함께 커밋합니다.

report

PM과 QA가 확인할 수 있는 변경 요약과 검증 근거를 Jira에 남깁니다.


2026.06—07 / Xinics Brain

DEPLOYED / 2026.07

기억할 대상은 대화가 아니라
다시 쓸 수 있는 판단입니다.

이전 작업에서 확인한 제약과 실패 원인을 다음 이슈에서 다시 찾고 설명해야 했습니다. 반대로 대화 전체를 넣으면 오래된 규칙과 불필요한 맥락이 함께 검색됐습니다.

6월에는 완료된 작업에서 재사용할 판단만 남긴다는 가설로 기억 계약을 설계했고, 7월에는 Xinics Brain으로 구현해 플러그인에 추가했습니다. 저장 단위는 결정, 불변 조건, 실패 패턴, 검증 근거와 고객사별 판단 주의사항입니다.

01 / CAPTURE

완료된 workflow에서 decision · invariant · failure · evidence · client guardrail만 구조화해 추출합니다.

02 / RECONCILE

기존 memory와 비교해 ADD · UPDATE · SUPERSEDE · IGNORE로 갱신합니다.

03 / SCOPE & RANK

customer · project · repository · module · version으로 먼저 제한하고, relevance · recency · evidence confidence로 정렬합니다.

04 / INJECT & TRACE

현재 작업에 필요한 양만 주입하고, 어떤 기억이 쓰였는지 실행 기록에 남긴다.

SCOPED ORGANIZATIONAL MEMORY

검증된 판단만 추출하고, 다음 실행에 필요한 만큼만 돌려줍니다

대화 전문이 아니라 결정·불변 조건·실패 패턴·고객사 주의사항을 출처와 유효기간이 있는 원자 단위로 관리합니다.

검증된 판단만 추출하고, 다음 실행에 필요한 만큼만 돌려줍니다 대화 전문이 아니라 결정·불변 조건·실패 패턴·고객사 주의사항을 출처와 유효기간이 있는 원자 단위로 관리합니다. UPSERT NEXT RUN Verified work tests · review · Jira Extract atomic memory Reconcile add · update · replace Xinics Brain evidence-backed store Scope customer · module Rank relevance · recency Inject context budget Usage trace which memory was used
ADD · UPDATE · SUPERSEDE 이력을 보존하고, customer/project/repository/module/version 범위로 먼저 제한합니다.
ATOMIC MEMORY CONTRACT
scope
customer / project / repository / module / version
kind
decision / invariant / failure / guardrail / evidence
provenance
Jira / Confluence / commit / test result
validity
valid from / review at / status
statement
다음 작업이 바로 사용할 수 있는 atomic decision
confidence
evidence level과 human review status

고객사별 기억에는 배포 제약, 승인 조건, 피해야 할 구현 패턴처럼 작업 판단에 필요한 주의사항도 담았다. 고객사와 프로젝트 범위를 조회의 첫 조건으로 두어 다른 환경의 규칙이 섞이지 않게 했고, 팀 범위 기억에는 출처를 필수로 두었다. 비밀 정보와 개인 정보는 수집 대상에서 제외했다. 충돌하거나 낡은 기억은 조용히 누적하지 않고 대체 이력을 남긴다. 덕분에 에이전트가 과거 결정을 무조건 따르는 대신, 현재 작업에 적용 가능한 근거인지 사람이 추적할 수 있다.


핵심 설계

검증된 도구를 조합하는 설계

각 단계를 새로 구현하는 대신 기존 Superpowers의 brainstorming, writing-plans와 subagent-driven-development를 조합했습니다.

플러그인은 이슈 번호, 프로젝트 설정과 현재 상태를 입력 계약으로 추가합니다. 기존 도구의 실행 방법은 유지하면서 Jira의 작업 맥락과 완료 조건을 함께 전달합니다.

계획 스킬은 이슈 규모를 판단해 단순한 작업에는 구현 계획만, 복잡한 작업에는 설계 탐색과 구현 계획을 차례로 적용합니다.

단계 전환의 명시적 조건

구현 단계는 계획 산출물이 있을 때만, 커밋 단계는 검증 결과가 있을 때만 시작하도록 전제 조건을 명시했다. 조건을 만족하지 못하면 다음 스킬로 넘어가지 않고 부족한 산출물을 보고한다.

프롬프트의 금지 문장만으로 정확성을 보장할 수는 없다. 그래서 각 단계의 입력, 출력, 중단 조건과 실행해야 할 검증 명령을 구체적으로 기록했다.

시작 선언은 심리적 장치가 아니라 실행 기록이다. 어떤 스킬이 어떤 목표로 시작됐는지 로그에 남겨 이후 결과와 연결한다.

대화형과 비대화형의 통합

같은 단계 정의가 사용자와 대화하는 실행과 claude -p로 시작되는 Night Worker 실행에서 모두 동작해야 했습니다.

대화형 실행은 계획을 보여준 뒤 사용자 승인을 기다립니다. 야간 실행은 사전에 정한 범위 안에서 진행하고 치명적 오류나 검증 실패가 발생하면 중단합니다.

단계별 입력과 출력은 공유하되 승인 방식과 중단 조건만 실행 환경에 따라 분리했습니다.

로컬 마켓플레이스 패턴

팀의 Bitbucket 인증과 업데이트 절차를 유지하기 위해 로컬 마켓플레이스를 선택했습니다. 핵심은 우회 설치가 아니라 팀이 검토한 변경만 명시적으로 배포하는 흐름입니다.

git pull로 변경을 받은 뒤 claude plugin update로 적용합니다. 설치, 갱신과 복구 절차는 팀 문서에 남겼습니다.

저장소 상태와 설치 상태를 분리해 변경을 검토한 뒤 적용할 수 있게 했습니다.


확인한 변화와 한계

계획, 구현, 리뷰, 검증, 커밋, 보고 단계와 각 산출물을 한 흐름에서 추적할 수 있게 됐다. 실행 기록으로 어느 단계와 검증 명령을 거쳤는지 확인할 수 있다.

Night Worker에서는 같은 단계 정의를 비대화형 작업에 사용한다. 완료된 작업은 커밋과 보고 산출물을 남기지만, 병합과 배포 전에는 사람이 결과를 검토한다.

verify 스킬은 QA 시나리오와 테스트 결과를, report 스킬은 비기술적 변경 요약을 산출한다. 이 산출물은 검토를 돕지만 코드의 정확성이나 테스트 완전성을 보장하지 않는다.

Xinics Brain은 이전 작업의 결정과 실패 패턴, 고객사별 판단 주의사항을 현재 이슈에 재사용하고, 각 기억을 Jira·Confluence·커밋·테스트 근거까지 추적할 수 있게 했다. 다만 기억이 검색됐다는 사실이 현재 맥락에서의 정답을 뜻하지 않으므로, 적용 범위와 검증 게이트는 그대로 유지한다.

정량적인 품질 변화는 아직 측정하지 않았습니다. 다음 과제는 동일한 이슈 표본에서 반복 질문, 오래되거나 잘못 검색된 기억, 문맥 토큰 사용량과 검증 실패율을 도입 전후로 비교하는 일입니다.