Community라이팅 & 에디팅github.com

wafflestack

🧇 하나의 반죽, 모든 저장소 — 재사용 가능한 AI 에이전트 및 스킬 정의를 네이티브 파일(.claude/, .codex/, .agents/)로 렌더링합니다.

wafflestack란 무엇인가요?

wafflestack은 AI 에이전트(Claude, Codex 등)를 위한 문서 오케스트레이션 스킬로, 코드베이스 변경 사항을 감지하고 에이전트 문서(AGENTS.md)와 사람 대상 문서(DECISIONS.md, STATUS.md, ARCHITECTURE.md)를 자동으로 업데이트하는 파이프라인을 제공합니다. 이 스킬은 세 단계의 순차적 파이프라인(아키텍처 감사 → 에이전트 문서 업데이트 → 사람 문서 업데이트)으로 구성되어 있어, 문서와 실제 코드 간의 동기화를 보장합니다. 주로 Claude, Codex, Cursor 등의 AI 에이전트 플랫폼에서 사용되며, 저장소 루트의 단일 AGENTS.md 레지스트리를 기준으로 작동합니다. 개발자는 이 스킬을 통해 번들, 스킬, 에이전트, 구성 키, CLI 명령어 등의 변경 사항을 자동으로 추적하고 문서에 반영할 수 있어, 유지보수 부담을 크게 줄일 수 있습니다. 렌더링된 출력(waffle/ 디렉토리 등)은 .gitignore로 추적에서 제외되며, 각 단계는 완료 후 다음 단계로 넘어가는 순차적 방식으로 동작합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add dustinkeeton/wafflestack

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

문서

문서 오케스트레이션

이 스킬이 호출되면 다음 파이프라인을 실행합니다:

1단계: 아키텍처 감사

general-purpose 에이전트를 다음 프롬프트로 생성합니다:

현재 코드베이스를 감사하여 마지막 문서 업데이트 이후의 변경 사항을 확인하세요. 기존 머신 문서(단일 루트 AGENTS.md 레지스트리)를 읽고 실제 프로젝트와 비교하세요. 다음을 포함하는 간결한 변경 보고서를 생성하세요:

  • 새로 추가되거나 제거된 번들, 스킬, 에이전트, 구성 키, CLI 명령어
  • 변경된 설치 프로그램 내보내기 또는 템플릿 의미(installer/lib/*.mjs)
  • bundle.yaml 구성 선언이 플레이스홀더 사용과 불일치하는 경우
  • 렌더링 출력 드리프트: node installer/cli.mjs doctor --allow-missing이 깨끗한지 (커밋된 렌더 + 잠금이 동기화됨 — 번들 편집 후 다시 렌더링 및 커밋); .gitignore가 여전히 의도적으로 추적되지 않는 렌더(라벨-훅 워크플로우, 워크트리, .waffle/ 개요 문서)를 포함하는지

변경 보고서만 구조화된 텍스트로 출력하세요. 파일을 수정하지 마세요.

2단계: 에이전트 문서

변경 보고서를 가져와 docs-agent 에이전트를 다음 프롬프트로 생성합니다:

다음은 wafflestack 코드베이스의 아키텍처 변경 보고서입니다:

{1단계 출력}

머신 문서(단일 루트 AGENTS.md 레지스트리)를 업데이트하여 프로젝트의 현재 상태를 반영하세요. 변경 보고서에만 의존하지 말고 실제 소스 파일을 읽어 세부 정보를 확인하세요. 형식과 구조에 대한 docs-agent 스킬 가이드라인을 따르세요.

3단계: 사람 문서

docs-agent가 완료된 후 docs-human 에이전트를 다음 프롬프트로 생성합니다:

머신 문서가 방금 업데이트되었습니다. 저장소 루트에 있는 사람 대상 문서(DECISIONS.md, STATUS.md, ARCHITECTURE.md)를 이에 맞게 업데이트하세요.

정확성을 위해 업데이트된 머신 문서와 실제 소스를 읽으세요. 형식, 구조 및 가드레일(소유자 음성 문서는 플래그만 표시하고 다시 작성하지 않음)에 대한 docs-human 스킬 가이드라인을 따르세요.

중요

  • 각 단계는 이전 단계가 완료된 후에 시작되어야 합니다. 각 단계의 출력이 다음 단계에 전달됩니다.
  • 1단계는 읽기 전용입니다. 감사 에이전트는 보고만 합니다.
  • docs-agent와 docs-human은 각자의 문서 파일을 수정해야 합니다.

관련 스킬