저장소 컨텍스트
이 저장소는 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 방법론 명령어 개선
- 스킬 추가 또는 업데이트
- 패키징/마켓플레이스 설치 문제 해결
- 게시된
graceCLI 및 해당 린트 워크플로우 유지 관리 - 표준 스킬 트리와 패키징된 스킬 트리 동기화 유지
- 릴리스 주변 검증 강화