AI Agent Ops Framework · Claude Code Plugin

Nova
AI Agent Ops
Framework

AI 코딩 에이전트가 많아질수록,
병목은 생성 속도가 아니라 운영 신뢰도다.

Nova는 Claude Code 위에서 에이전트 작업을 환경·맥락·검증·협업·진화로 운영한다.
품질 게이트는 제품의 전부가 아니라, 운영 체계 안에서 가장 강한 실행 루프다.

운영 루프 설치하기 도입 기준 보기

Operating Rules

Commands

Specialist Agents

Skills

$ claude plugin install nova@nova-marketplace

✓ Agent Ops ready

scroll

The Real Problem

AI 코딩의 진짜 병목은 운영이다

생성 속도가 빨라질수록 지침, 맥락, 검증, 배포 주의가 흩어지는 비용이 커진다.

운영 공백

코드는 늘었지만 통제면은 비어 있다

AI가 빠르게 구현해도, 어떤 규칙으로 일하고 어떤 상태를 기억하며 어디까지 검증했는지 남지 않으면 프로젝트는 더 빨리 복잡해진다.

지침 드리프트

CLAUDE.md 하나에 모든 것을 넣으면 다시 흩어진다

프로젝트 개요, 배포 주의, 인프라 참조, 시크릿 관리, 작업 규칙이 한 파일에 쌓이면 에이전트도 우선순위를 잃는다. 중요한 지침 표면을 작게 유지해야 한다.

검증 착시

자기가 만든 코드를 자기가 통과시킨다

같은 에이전트가 구현과 리뷰를 모두 맡으면 확증 편향이 생긴다. 설계-구현 갭, 하드코딩된 시크릿, 경계값 누락은 독립 관점에서 봐야 드러난다.

Adoption Standard

도입 전에 봐야 할 것은 데모가 아니라 운영 반복성

Nova의 핵심 질문은 “AI가 코드를 잘 짜는가”가 아니다. 같은 프로젝트에서 여러 에이전트가 오래 일해도, 지침과 검증과 맥락이 흩어지지 않는가다.

commands

skills

agents

rules

MCP tools

CategoryAgent Ops

AI coding output은 이미 풍부하다

다음 병목은 더 많은 코드를 만드는 능력이 아니라, 에이전트가 어떤 환경·맥락·권한·검증 루프 안에서 일하는지 운영하는 능력이다.

Adoption/nova:claude-md

신규와 기존 프로젝트를 모두 흡수해야 한다

빈 레포에는 에이전트 지침의 골격을 만들고, 오래된 레포에는 현재 관례·배포·시크릿·인프라를 읽어 가장 작은 지침 표면으로 재구성한다.

ControlHarness-native

하네스 레이어에 붙어야 반복성이 생긴다

Nova는 문서 하나가 아니라 훅, 커맨드, 스킬, MCP, 상태 파일을 함께 묶는다. 에이전트가 매번 기억해주길 바라는 대신 실행 경로에 규칙을 둔다.

ProofRepeatable gate

검증은 기능이 아니라 운영 습관이다

Generator-Evaluator 분리, clean-clone 확인, 릴리스 전 테스트를 통해 변경을 통과시키는 구조를 만든다. 중요한 것은 멋진 데모보다 반복 가능한 통제다.

Operational Checklist

what should stay true after every release

Positioning

Nova가 Quality Gate를 넘어 Agent Ops 카테고리로 설명되는가

Instruction Surface

CLAUDE.md·AGENTS.md·NOVA-STATE.md가 역할별로 분리되는가

Runtime Hook

세션 시작, worktree, 검증, 커밋 전 행동이 실행 경로에 연결되는가

Evidence

테스트·빌드·clean clone·Known Gaps가 기록으로 남는가

How It Works

가장 강한 실행 루프: Generator → Evaluator

Nova 전체는 Agent Ops 프레임워크이고, 그 안의 커밋 전 루프는 명확하다.
코드를 만든 에이전트와 검증하는 에이전트를 분리한다.

Generator

AI가 코드를 구현

Claude Code가 기능을 구현한다

Verification Loop

Nova

독립 Evaluator 루프

독립 서브에이전트가 적대적 검증

Done / Fix

PASS 또는 수정 요청

PASS면 완료, 문제면 즉시 보고

Evaluator의 5차원 검증

“통과시키지 마라, 문제를 찾아라” — 적대적 자세로 5가지 기준을 독립 검증

기능

요구사항과 실제 동작 일치 여부

데이터 관통

입력→저장→표시 전 경로 완전성

설계 정합성

기존 코드/아키텍처 일관성

에러 핸들링

에러 핸들링, 엣지 케이스, 타입 안전성

경계값

0, 음수, 빈 값에서 크래시 없음

Five Pillars

AI Agent Ops 5기둥

Nova는 품질 게이트에서 출발했지만, 이제 에이전트가 안정적으로 일하기 위한 환경·맥락·검증·협업·진화 전체를 다룬다. 검증 기둥은 여전히 가장 강한 증거다.

Environment

환경 — 에이전트 작업 공간

Worktree 격리, 시크릿 공유, 환경변수 연결까지 — 병렬 에이전트가 서로를 깨뜨리지 않고 일할 수 있는 운영 환경을 제공한다.

→Worktree 자동 셋업
→`.env`·`.secret/` 공유
→SessionStart 훅 자동 주입

Context

맥락 — 세션 연속성

NOVA-STATE.md로 진행 상태·블로커·결정 로그를 세션 간에 이어붙인다. 어제 끝낸 자리에서 오늘 그대로 시작한다.

→자동 갱신 체크포인트
→Known Gaps / Risks 추적
→memory 시스템과 연동

핵심 기둥

Verification · Core

검증 — Generator-Evaluator 분리

구현한 에이전트와 검증하는 에이전트를 다른 실행 주체로 분리한다. 커밋 전 하드 게이트는 검증 PASS를 실제 staged 변경(파일 해시)에 묶어, 검증되지 않은 커밋을 차단한다.

→독립 서브에이전트 검증
→5차원 (기능·데이터·설계·에러·경계값)
→커밋 게이트 = staged 파일 바인딩
→Hard-Block 분류 · `--emergency` 예외

Collaboration

협업 — 오케스트레이션 & 자문

설계→구현→검증 전체 사이클을 한 명령으로 조율하고, 결정이 갈리는 지점에서는 Claude·GPT·Gemini를 동시에 불러 교차 확인한다.

→/nova:auto — 풀 사이클
→/nova:run — 구현→검증
→/nova:ask — 멀티 AI 자문

Evolution

진화 — 자기 진단 & 업그레이드

코드베이스를 스캔해 다음 행동을 추천하고, 기술 동향을 반영해 Nova 자신을 안전 범위 안에서 업그레이드한다.

→/nova:scan — 온보딩 분석
→/nova:next — 다음 행동 추천
→/nova:evolve — 자율 진화

Coexist · v5.53.0

오케스트레이터를 바꾸지 않아도 된다

Nova는 oh-my-claudecode(OMC) 같은 velocity 오케스트레이터의 대체재가 아닙니다. 같이 씁니다 — 빠른 실행은 그쪽에 맡기고, Nova는 커밋 전 안전벨트만 남깁니다.

역할 분담 (공존 셋업)Velocity 툴Nova

빠른 생성 · 병렬 에이전트 실행●·

세션 오케스트레이션 · 자동 파이프라인●·

커밋 전 파일 바인딩 하드 게이트·●

검증 안 된 변경을 커밋에서 차단·●

감사 가능한 상태 · 결정 기록·●

→velocity 툴로 빠르게 만들고, Nova 게이트로 검증 안 된 커밋을 잡는다.

`NOVA_COEXIST`게이트만 남기는 공존 모드

오케스트레이터와 Nova를 같이 켜면 SessionStart·PreToolUse·Stop 훅이 양쪽에서 쌓입니다. 공존 모드는 Nova의 고유 가치인 커밋 게이트만 유지하고, 규칙 주입·per-tool 관찰성·stop 훅은 끕니다.

bash

# 게이트만 남기고 나머지 훅은 오케스트레이터에 양보 (한 번만)
bash scripts/nova-coexist.sh on

# 되돌리기 — full Nova 복귀
bash scripts/nova-coexist.sh off

# 현재 상태 확인
bash scripts/nova-coexist.sh status

! 적용은 새 Claude Code 세션부터 — 토글 후 재시작하세요.

✓완전 opt-in · 기본은 full Nova✓안 켜면 기존 사용자/팀원 영향 0✓프로젝트별 토글 (--project)

Nova 운영 루프가 잡아내는 결함

설계, 보안, API 계약, 시크릿 관리까지 커밋 전에 확인

DOCGET /api/auth/me 엔드포인트 누락

설계-구현 갭

/nova:check — 설계 문서 vs 라우트 핸들러 diff

SEC비밀번호 평문 저장

보안

설계는 bcrypt 요구, 코드에 해싱 없음 → Hard-Block

API이메일 중복 체크 누락 (409 미처리)

검증 계약 불이행

설계에 409 명시, 코드에 처리 없음

KEYJWT 시크릿 키 하드코딩

보안 패턴

정적 분석: 문자열 리터럴 탐지 → Hard-Block

Live Demo

실제 Nova 사용 예시

복잡도별로 Nova가 어떻게 다르게 동작하는지 확인해보세요.

간단"NullPointerException 수정해줘"

nova — "NullPointerException 수정해줘"

17 Commands

필요할 때 직접 제어

에이전트 운영 루프를 직접 제어할 때 사용하는 17개 커맨드.

Command

Description

/nova:ask

멀티 AI 다관점 자문을 실행한다. Claude + GPT + Gemini 3개 AI에게 동시에 질의하고 합의 수준을 분석한다.

/nova:auto

자연어 요청을 설계→구현→검증→수정 전체 사이클로 자동 실행한다.

/nova:check

코드 품질 리뷰 + 설계-구현 정합성 검증을 한 번에 수행한다. — MUST TRIGGER: 커밋 전(3파일 이상 변경 시), 스프린트 완료 시, 사용자가 버그를 보고한 직후.

/nova:checkpoint

세션 종료 전 STATE 드리프트를 점검하고, 완료 의심 항목을 정직하게 분류·보고한다. 검증 불가 항목을 완료로 포장하지 않는다.

/nova:claude-md

안내와 함께 CLAUDE.md/AGENTS.md 에이전트 지침을 감사하고 신규/기존 프로젝트 기준으로 재구성안을 만든다.

/nova:deepplan

Explorer→Synth→Critic→Refiner 4단 파이프라인으로 깊이 있는 Plan 문서를 생성한다.

/nova:design

CPS(Context-Problem-Solution) 프레임워크로 Design 문서를 작성한다.

/nova:migrate-state

NOVA-STATE.md를 최신 v3 work-item registry로 변환한다. v1/v2 입력 모두 직접 v3 가능. dry-run → 사용자 검수 → apply + drift-check 자동. — MUST TRIGGER: 사용자가 STATE 변환 요청한 직후, session-start v1/v2 hint를 본 직후, 또는 `.nova/work-items/` 부재.

/nova:next

현재 프로젝트 상태를 진단하고 다음에 실행할 Nova 커맨드를 추천한다.

/nova:plan

CPS(Context-Problem-Solution) 프레임워크로 Plan 문서를 작성한다.

/nova:review

코드를 적대적 관점에서 리뷰하고, 숨겨진 문제를 찾아낸다. — MUST TRIGGER: 커밋 전(로직 변경 시), PR 생성 전, 버그 수정 후 회귀 확인 시.

/nova:run

구현→검증을 한 사이클로 실행한다 (Full Cycle). --verify-only로 검증만 수행 가능.

/nova:scan

새 프로젝트에 처음 투입됐을 때 코드베이스를 자동 분석하고 '어디부터 볼지' 브리핑한다.

/nova:setup

새 프로젝트에 Nova Quality Gate를 초기 설정하거나, 기존 프로젝트의 갭을 자동 보완한다 (--upgrade).

/nova:status

프로젝트 현황(Phase·Sprint·그룹 진행률) + drift 알람을 stand-alone HTML로 한 눈에 본다. 노션/wiki sync 불필요 — git이 진실원. — MUST TRIGGER: AI에게 위임 후 점검, 멀티 프로젝트 상태 확인, 로드맵 drift 점검 필요 시. **자율 해석 금지** — Step 1 무조건 실행.

/nova:ux-audit

5인 적대적 평가자로 UI/UX를 다관점 심층 평가. 접근성(WCAG 2.2)·인지 부하·성능(Core Web Vitals)·다크 패턴(EU DSA)까지 코드 기반 분석.

/nova:worktree-setup

현재 worktree에서 메인 레포의 .env·시크릿·설정 파일을 즉시 심볼릭 링크한다. SessionStart 자동 훅의 수동 재시도 버전.

Orbit

멀티 에이전트 오케스트레이션

자연어 한 줄로 설계→구현→검증 전체 사이클을 실행한다. 역할별 전문 에이전트가 병렬로 작업하고, 독립 Evaluator가 커밋 전 위험 신호를 확인한다.

bash

npx nova-orbit

GitHub에서 보기

역할별 전문 에이전트

Architect

시스템 아키텍처 설계, 기술 선택, 확장성·유지보수성 검토

Senior Dev

코드 품질 개선, 리팩토링, 구현 전략, 기술 부채 식별

QA Engineer

테스트 전략 수립, 엣지 케이스 식별, 품질 검증

Security Engineer

보안 취약점 점검, 위협 모델링, 인증·인가 검토

DevOps Engineer

CI/CD 파이프라인, 인프라 설정, 배포 전략, 모니터링

핵심 기능

Kanban

Kanban 보드

드래그앤드롭으로 태스크를 관리하고, AI 에이전트에게 실시간 할당한다. 진행 상황을 한눈에 파악.

→태스크 생성 및 할당
→에이전트별 진행 추적
→우선순위 자동 정렬

Goal

Goal 분해

자연어로 목표를 입력하면 실행 가능한 태스크로 자동 분할한다. 복잡한 프로젝트도 한 줄로 시작.

→자연어 → 태스크 자동 분할
→의존성 그래프 생성
→예상 소요시간 추정

GitHub

GitHub 연동

레포 클론부터 브랜치 전략, PR 생성까지 GitHub 워크플로를 에이전트가 직접 수행한다.

→레포 클론 및 브랜치 관리
→자동 PR 생성 및 리뷰
→이슈 트래킹 연동

Verification

검증 루프 통합

Nova의 Generator-Evaluator 패턴을 내장. 5차원 검증으로 에이전트 산출물의 위험 신호를 커밋 전에 드러낸다.

→Generator-Evaluator 분리
→5차원 검증
→커밋 전 리스크 차단

왜 Orbit인가?

Orbit

단일 AI

수동

에이전트 역할 분리

독립 검증 (Evaluator)

자동 복잡도 판단

병렬 작업 실행

스프린트 분할·추적

설계-구현 갭 탐지

nova orchestrate

"사용자 인증 시스템 구현"Sprint 1/2

Architect완료

DB 스키마 + API 설계

Senior Dev진행 중

로그인 모듈 구현

QA대기

테스트 케이스 준비

전체 진행률42%

Evaluator — Sprint 1 검증 대기 중

MCP Server

어디서든 Nova 규칙에 접근

MCP(Model Context Protocol) 서버로 Nova의 규칙과 도구를 어느 Claude Code 세션에서든 사용할 수 있습니다. Nova가 설치되지 않은 프로젝트에서도 동작합니다.

MCP가 뭔가요?

MCP(Model Context Protocol)는 AI 모델이 외부 도구에 접근하는 표준 프로토콜입니다. Nova의 MCP 서버는 로컬에서 실행되며, Claude Code가 Nova의 규칙·상태·검증 도구를 직접 호출할 수 있게 합니다. API 호출이나 외부 서버 연결 없이, 로컬 파일만 읽습니다.

어떻게 동작하나요?

어느 프로젝트든→Claude Code→Nova MCP

get_rules() → Nova 규칙 전문

get_state() → NOVA-STATE.md

verify() → 코드 검증 실행

orchestrate() → 오케스트레이션 실행

제공 도구 (6개)

get_rulesNova 규칙 조회

전체 또는 섹션별(§1~§9) 규칙 반환

get_commands커맨드 목록 조회

13개 슬래시 커맨드와 설명

get_stateNOVA-STATE.md 기반 상태 조회 (advisory 포함)

NOVA-STATE.md 읽기 + advisory 메시지 반환

verify코드 검증 실행

Lite/Standard/Full 강도별 코드 품질 검증

orchestrate오케스트레이션 실행

자연어 요청 → 설계→구현→검증 전체 사이클 실행

create_planCPS 플랜 생성

주제를 입력하면 CPS 형식 Plan 초안 반환

bash

# Nova 플러그인 설치 시 MCP 서버도 함께 포함됩니다.
# 별도 설정 없이 바로 사용 가능합니다.

claude plugin marketplace add TeamSPWK/nova
claude plugin install nova@nova-marketplace

# MCP 도구 확인
# Claude Code 세션에서 자동으로 사용 가능

플러그인 설치만으로 MCP 서버가 자동 활성화됩니다. 별도 빌드나 설정이 필요 없습니다.

Quick Install

30초면 설치 완료

두 줄 명령어로 Nova Agent Ops가 모든 Claude Code 세션의 실행 경로에 붙습니다.

30s

30초 설치

두 줄 명령어로 즉시 설치

KEY

API 키 불필요

/nova:ask 외 대부분 로컬 실행

AUTO

자동 적용

세션마다 운영 규칙 로드

MIT

MIT 라이선스

오픈소스, 상업적 사용 가능

Install

bash

# Install (30 seconds)
claude plugin marketplace add TeamSPWK/nova
claude plugin install nova@nova-marketplace

# Start
/nova:next   # 현재 상태와 다음 행동 확인

Update / Remove (optional)

bash

# Update
claude plugin update nova@nova-marketplace

# Remove
claude plugin uninstall nova@nova-marketplace
claude plugin marketplace remove nova-marketplace

Requirements

✓Claude Code CLI (필수)
○OpenAI + Google AI Studio API 키 (선택, /nova:ask 사용 시만 필요)

GitHub에서 시작하기

MIT 오픈소스 · 무료

처음이신가요? 인터랙티브 가이드로 체험해보세요

FAQ

자주 묻는 질문

Nova에 대해 더 궁금한 점은 GitHub에서 확인하세요.

NovaAI Agent OpsFramework

AI 코딩의 진짜 병목은 운영이다

코드는 늘었지만 통제면은 비어 있다

CLAUDE.md 하나에 모든 것을 넣으면 다시 흩어진다

자기가 만든 코드를 자기가 통과시킨다

도입 전에 봐야 할 것은 데모가 아니라 운영 반복성

AI coding output은 이미 풍부하다

신규와 기존 프로젝트를 모두 흡수해야 한다

하네스 레이어에 붙어야 반복성이 생긴다

검증은 기능이 아니라 운영 습관이다

Operational Checklist

가장 강한 실행 루프: Generator → Evaluator

Evaluator의 5차원 검증

AI Agent Ops 5기둥

환경 — 에이전트 작업 공간

맥락 — 세션 연속성

검증 — Generator-Evaluator 분리

협업 — 오케스트레이션 & 자문

진화 — 자기 진단 & 업그레이드

오케스트레이터를 바꾸지 않아도 된다

NOVA_COEXIST게이트만 남기는 공존 모드

Nova 운영 루프가 잡아내는 결함

실제 Nova 사용 예시

필요할 때 직접 제어

멀티 에이전트 오케스트레이션

역할별 전문 에이전트

핵심 기능

Kanban 보드

Goal 분해

GitHub 연동

검증 루프 통합

왜 Orbit인가?

어디서든 Nova 규칙에 접근

MCP가 뭔가요?

어떻게 동작하나요?

제공 도구 (6개)

30초면 설치 완료

Install

Update / Remove (optional)

Requirements

자주 묻는 질문

Nova
AI Agent Ops
Framework

`NOVA_COEXIST`게이트만 남기는 공존 모드