Communitygithub.com

ASoudy/AGS

자동 메모리(MEMORY.md)에 기록된 검증된 패턴을 CLAUDE.md 또는 .claude/rules/로 승격시켜 영구적으로 적용합니다.

AGS란 무엇인가요?

이 스킬은 Claude의 자동 메모리(MEMORY.md)에 저장된 학습 패턴을 프로젝트 규칙 시스템(CLAUDE.md 또는 .claude/rules/)으로 승격시키는 프로세스를 자동화합니다. 자동 메모리는 단순한 참고 노트 역할을 하지만, 한 번 규칙으로 승격되면 Claude가 모든 향후 세션에서 강제로 따라야 하는 명령이 됩니다. 사용자는 승격할 패턴을 설명하고, 대상 파일(CLAUDE.md, .claude/rules/의 특정 주제 파일, 또는 ~/.claude/CLAUDE.md)을 선택할 수 있습니다. 이 스킬은 패턴 검색, 규칙 요약(명령형 스타일), 대상 파일 쓰기, 그리고 자동 메모리 정리까지 전 과정을 안내하며, Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용 가능합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/nginity-skills-library/engineering-team/self-improving-agent/skills/promote

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

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

문서

/si:promote — 학습 내용을 규칙으로 승격

Claude의 자동 메모리에 저장된 검증된 패턴을 프로젝트의 규칙 시스템으로 이동시켜, 단순한 참고 노트가 아닌 강제 명령으로 만듭니다.

사용법

/si:promote <패턴 설명>                    # 최적의 대상을 자동 감지
/si:promote <패턴> --target claude.md      # CLAUDE.md로 승격
/si:promote <패턴> --target rules/testing.md  # 범위가 지정된 규칙으로 승격
/si:promote <패턴> --target rules/api.md --paths "src/api/**/*.ts"  # 경로와 함께 범위 지정

워크플로

1단계: 패턴 이해

사용자의 설명을 파싱합니다. 모호한 경우 다음 질문 중 하나로 명확히 합니다.

  • "Claude가 따라야 할 구체적인 동작은 무엇인가요?"
  • "모든 파일에 적용되나요, 아니면 특정 경로에만 적용되나요?"

2단계: 자동 메모리에서 패턴 찾기

# MEMORY.md에서 관련 항목 검색
MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F|/|; s|^/||')/memory"
grep -ni "<키워드>" "$MEMORY_DIR/MEMORY.md"

일치하는 항목을 보여주고 사용자가 의도한 것이 맞는지 확인합니다.

3단계: 올바른 대상 결정

패턴 범위대상예시
전체 프로젝트에 적용./CLAUDE.md"pnpm을 사용하고 npm은 사용하지 않음"
특정 파일 유형에 적용.claude/rules/<주제>.md"API 핸들러는 검증이 필요함"
모든 프로젝트에 적용~/.claude/CLAUDE.md"명시적 오류 처리를 선호함"

사용자가 대상을 지정하지 않았다면, 범위에 따라 대상을 추천합니다.

4단계: 간결한 규칙으로 요약

자동 메모리의 서술형 노트 형식을 CLAUDE.md의 명령형 형식으로 변환합니다.

이전 (MEMORY.md — 서술형):

이 프로젝트는 pnpm 워크스페이스를 사용합니다. npm install을 시도했을 때 실패했습니다. 잠금 파일은 pnpm-lock.yaml입니다. 의존성 설치에는 반드시 pnpm install을 사용해야 합니다.

이후 (CLAUDE.md — 규정형):

## 빌드 및 의존성
- 패키지 매니저: pnpm (npm 아님). `pnpm install` 사용.

요약 규칙:

  • 가능하면 한 줄에 하나의 규칙
  • 명령형 어조 사용 ("X 사용", "항상 Y", "절대 Z 금지")
  • 개념뿐만 아니라 명령어나 예시 포함
  • 배경 이야기 없이 — 명령만 포함

5단계: 대상에 쓰기

CLAUDE.md의 경우:

  1. 기존 CLAUDE.md 읽기
  2. 적절한 섹션 찾기 (또는 새로 만들기)
  3. 올바른 제목 아래 새 규칙 추가
  4. 파일이 200줄을 초과하면 .claude/rules/ 사용 제안

.claude/rules/의 경우:

  1. 파일이 없으면 생성
  2. 범위가 지정된 경우 YAML frontmatter에 paths 추가
  3. 규칙 내용 작성
---
paths:
  - "src/api/**/*.ts"
  - "tests/api/**/*"
---

# API 개발 규칙

- 모든 엔드포인트는 Zod 스키마로 입력을 검증해야 함
- 오류 응답에는 `ApiError` 클래스 사용 (원시 Error 사용 금지)
- 핸들러 함수에 OpenAPI JSDoc 주석 포함

6단계: 자동 메모리 정리

승격 후, MEMORY.md의 원래 항목을 제거하거나 표시합니다.

# 제거될 내용 확인
grep -n "<패턴>" "$MEMORY_DIR/MEMORY.md"

사용자에게 제거 확인을 요청합니다. 그런 다음 MEMORY.md를 편집하여 승격된 항목을 제거합니다. 이렇게 하면 새로운 학습을 위한 공간이 확보됩니다.

7단계: 확인

✅ {{대상}}으로 승격 완료

규칙: "{{요약된 규칙}}"
출처: MEMORY.md {{n}}번째 줄 (제거됨)
MEMORY.md: {{줄 수}}/200줄 남음

이제 패턴이 강제 명령이 되었습니다. Claude는 향후 모든 세션에서 이를 따릅니다.

승격 결정 가이드

승격 대상:

  • 자동 메모리에 패턴이 3회 이상 나타난 경우
  • Claude를 같은 내용으로 두 번 이상 수정한 경우
  • 모든 기여자가 알아야 할 프로젝트 규칙인 경우
  • 반복되는 실수를 방지하는 경우

승격하지 말아야 할 경우:

  • 일회성 디버깅 노트인 경우 (자동 메모리에 유지)
  • 세션별 컨텍스트인 경우 (세션 메모리가 처리)
  • 곧 변경될 가능성이 있는 경우 (예: 마이그레이션 중)
  • 기존 규칙으로 이미 다루어지는 경우

CLAUDE.md vs .claude/rules/

CLAUDE.md 사용 대상.claude/rules/ 사용 대상
전역 프로젝트 규칙파일 유형별 패턴
빌드 명령어테스트 규칙
아키텍처 결정API 설계 규칙
팀 규칙프레임워크별 주의사항

팁

  • CLAUDE.md는 200줄 미만으로 유지 — 초과 시 rules/ 사용
  • 한 줄에 하나의 규칙이 문단보다 유지보수에 용이
  • 개념뿐만 아니라 구체적인 명령어 포함
  • 분기마다 승격된 규칙 검토 — 더 이상 관련 없는 규칙은 제거

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

관련 스킬