Community생산성 & 협업github.com

osovv/grace-marketplace

GRACE(Graph-RAG Anchored Code Engineering): 계약 중심 AI 코드 생성을 위한 개방형 에이전트 스킬로, 시맨틱 마크업, 지식 그래프를 지원하며 Claude Code, Codex CLI, Kilo Code와 호환됩니다.

grace-marketplace란 무엇인가요?

GRACE(Graph-RAG Anchored Code Engineering)는 계약 우선(contract-first) AI 엔지니어링 방법론으로, 시맨틱 마크업, XML 계획 아티팩트, 지식 그래프 탐색, 검증/로그 기반 실행을 통해 코딩 에이전트가 더 구조화되고 신뢰할 수 있는 코드를 생성할 수 있도록 돕습니다. 이 저장소는 GRACE 스킬의 마켓플레이스 패키지로, Claude Code, Codex CLI, Kilo Code와 같은 주요 AI 코딩 도구에서 사용할 수 있습니다. 핵심 기능으로는 GRACE 프로젝트 아티팩트 초기화, 모듈 아키텍처 및 계약 설계, 검증 및 로그 증거 설계, 계획의 순차적/병렬 실행, 프로젝트 상태 검사, 드리프트 감지, 무결성 검토 등을 제공합니다. 이 패키지는 방법론 콘텐츠, 스킬 명령어, 마켓플레이스 배포를 주로 다루며, 지속적인 버전 동기화와 패키징 검증을 통해 안정성을 보장합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add osovv/grace-marketplace

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

저장소 컨텍스트

이 저장소는 GRACE 마켓플레이스 패키지로, 최종 사용자 애플리케이션이 아닙니다.

GRACE는 Graph-RAG Anchored Code Engineering의 약자로, 시맨틱 마크업, XML 계획 아티팩트, 지식 그래프 탐색, 검증/로그 기반 실행을 기반으로 구축된 계약 우선 AI 엔지니어링 방법론입니다.

이 저장소가 포함하는 것

  • skills/grace/* — 표준 스킬 소스 파일입니다.
  • plugins/grace/skills/grace/* — Claude 마켓플레이스/플러그인 배포를 위해 사용되는 패키징된 미러입니다.
  • .claude-plugin/marketplace.json — 마켓플레이스 진입점을 정의합니다.
  • plugins/grace/.claude-plugin/plugin.json — 패키징된 플러그인 매니페스트를 정의합니다.
  • openpackage.yml — OpenPackage 메타데이터를 정의합니다.
  • README.md — 사용자 대상 개요 및 설치 가이드입니다.
  • package.json, src/grace.ts, src/grace-lint.ts — 게시된 Bun 기반 CLI 패키지 @osovv/grace-cli와 grace lint 명령어를 정의합니다.
  • scripts/validate-marketplace.ts — 패키징, 경로 안전성, 버전 동기화, 패키징 대 표준 소스 간 차이(drift)를 검증합니다.

핵심 목적

이 저장소는 GRACE 스킬을 패키징하고 배포하여 코딩 에이전트가 다음 작업을 수행할 수 있도록 합니다:

  • GRACE 프로젝트 아티팩트 초기화
  • 모듈 아키텍처 및 계약 계획
  • 검증 및 로그 증거 설계
  • 계획을 순차적으로 또는 병렬 안전 웨이브로 실행
  • 프로젝트 상태 검사, 드리프트 새로고침, 무결성 검토, GRACE 설명, 프로젝트 질문에 답변

이 저장소는 주로 방법론 콘텐츠, 스킬 명령어, 마켓플레이스 패키징을 다룹니다.

중요 작업 규칙

  • 특별히 패키징된 출력에 대한 작업이 아닌 이상 skills/grace/*를 주요 진실 공급원(source of truth)으로 취급합니다.
  • 게시된 스킬이 변경될 때 plugins/grace/skills/grace/*를 표준 skills/grace/* 복사본과 동기화된 상태로 유지합니다.
  • README.md, openpackage.yml, .claude-plugin/marketplace.json, plugins/grace/.claude-plugin/plugin.json 전반에 걸쳐 버전을 동기화합니다.
  • 패키징 또는 메타데이터 변경 후 bun run ./scripts/validate-marketplace.ts를 실행하여 저장소 무결성을 검증합니다.
  • CLI 변경 시 또는 공개 린트 워크플로우를 확인할 때는 bun run grace lint --path . --allow-missing-docs도 함께 실행합니다.
  • skills/grace/ 아래의 모든 디렉터리가 게시되는 것은 아닙니다. 실제 배포 세트는 .claude-plugin/marketplace.json에 선언되어 있습니다.

변경 사항에 대한 사고 방식

  • 스킬 텍스트 변경은 제품 변경입니다.
  • 패키징/매니페스트/메타데이터 변경은 릴리스 표면 변경입니다.
  • 검증 변경은 표준 스킬과 패키징된 복사본 간의 차이(drift)를 방지합니다.
  • README 및 변경 로그 업데이트는 릴리스 위생의 일부이지 선택적 개선이 아닙니다.

향후 세션을 위한 기본 정신 모델

요청이 모호한 경우, 사용자가 다음 영역 중 하나에서 작업 중이라고 가정합니다:

  • GRACE 방법론 명령어 개선
  • 스킬 추가 또는 업데이트
  • 패키징/마켓플레이스 설치 문제 해결
  • 게시된 grace CLI 및 해당 린트 워크플로우 유지 관리
  • 표준 스킬 트리와 패키징된 스킬 트리 동기화 유지
  • 릴리스 주변 검증 강화

관련 스킬