문서 오케스트레이션
이 스킬이 호출되면 다음 파이프라인을 실행합니다:
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은 각자의 문서 파일을 수정해야 합니다.