본문으로 건너뛰기

Generated Files 정리본

이 문서는 team-library-harness/generated/ 아래 실제로 존재하는 파일들을, 처음 보는 사람도 어떤 용도인지 빠르게 이해할 수 있게 다시 정리한 인덱스 문서입니다.

즉, 원문 파일을 그대로 보는 것보다 먼저 이 문서를 보면 아래를 더 빨리 파악할 수 있습니다.

  • 어떤 파일이 있는가?
  • 각각 무슨 역할을 하는가?
  • 어떤 순서로 보면 이해가 쉬운가?
  • 실무에서는 어디부터 쓰면 좋은가?

한눈에 보기​

이 generated 구조는 크게 5묶음으로 보면 쉽습니다.

  1. Agents
    • 누가 어떤 역할을 맡는가
  2. Skills
    • 반복 작업을 어떤 방식으로 처리하는가
  3. Workflows
    • 실제 작업이 어떤 순서로 흘러가는가
  4. Prompts
    • 어떤 질문/지시문으로 시작하는가
  5. Templates
    • 결과물을 어떤 문서 형식으로 정리하는가

즉,

  • Agents = 역할
  • Skills = 처리 방식
  • Workflows = 흐름
  • Prompts = 입력 문구
  • Templates = 결과 문서 틀

로 이해하면 됩니다.

1. Agents​

에이전트 문서는 역할 설명서에 가깝습니다.

intake-analyst​

  • 역할: 원문을 먼저 읽고 문서화 가치와 처리 경로를 판단
  • 잘 맞는 일: Slack/회의록/주간보고 1차 분류
  • 보기: intake-analyst

structuring-writer​

  • 역할: 원문이나 분석 결과를 Team Library용 초안으로 구조화
  • 잘 맞는 일: 운영 가이드, FAQ, 체크리스트 초안 작성
  • 보기: structuring-writer

reviewer​

  • 역할: 민감정보, 정확성, 게시 적합성 검토
  • 잘 맞는 일: 공개 전 검토, 보류 여부 판단
  • 보기: reviewer

publisher-planner​

  • 역할: 문서를 어디에 둘지, 어떤 이름으로 둘지 결정
  • 잘 맞는 일: docs/blog/workflows/templates 경로 정리
  • 보기: publisher-planner

report-analyst​

  • 역할: 회의록, 주간보고, 시트 데이터를 분석해 문서 후보 추출
  • 잘 맞는 일: 반복 이슈/결정사항/액션아이템 정리
  • 보기: report-analyst

Agents는 언제 먼저 보면 좋은가​

아래가 궁금할 때 먼저 보면 좋습니다.

  • "이 구조에서 누가 무슨 일을 하는가?"
  • "역할 분리를 어떻게 했는가?"
  • "이 작업을 한 AI가 다 하지 않고 왜 나눴는가?"

2. Skills​

스킬 문서는 반복 작업 처리 규칙에 가깝습니다.

slack-thread-analysis​

  • 역할: Slack 스레드에서 핵심 질문, 결정사항, 액션아이템 추출
  • 보기: slack-thread-analysis

meeting-notes-structuring​

weekly-report-analysis​

  • 역할: 주간보고나 시트 내역에서 반복 이슈와 문서화 후보 추출
  • 보기: weekly-report-analysis

docs-draft-writer​

sensitive-info-review​

team-library-publisher​

Skills는 언제 먼저 보면 좋은가​

아래가 궁금할 때 먼저 보면 좋습니다.

  • "Slack 스레드를 어떤 기준으로 분석하는가?"
  • "회의록을 어떤 구조로 바꾸는가?"
  • "민감정보는 어떻게 검토하는가?"

3. Workflows​

워크플로우 문서는 실제 진행 순서를 보여줍니다.

slack-to-team-library​

google-sheet-weekly-report-to-slack​

meeting-notes-to-doc-candidates​

Workflows는 언제 먼저 보면 좋은가​

아래가 궁금할 때 먼저 보면 좋습니다.

  • "실제 순서는 어떻게 되는가?"
  • "사람 승인 단계는 어디에 들어가는가?"
  • "Slack/회의록/주간보고가 문서로 어떻게 이어지는가?"

4. Prompts​

프롬프트 문서는 작업을 시작할 때 쓰는 입력문 예시에 가깝습니다.

build-doc-from-slack​

  • 역할: Slack 스레드를 Team Library 문서 초안으로 바꾸는 시작 프롬프트
  • 보기: build-doc-from-slack

analyze-weekly-report​

publish-to-team-library​

Prompts는 언제 먼저 보면 좋은가​

아래가 궁금할 때 먼저 보면 좋습니다.

  • "실제로 어떤 문장으로 시작해야 하는가?"
  • "AI에게 어떤 형태로 지시해야 하는가?"

5. Templates​

템플릿 문서는 최종 결과물 틀입니다.

troubleshooting-doc​

ops-guide-doc​

slack-analysis-output​

Templates는 언제 먼저 보면 좋은가​

아래가 궁금할 때 먼저 보면 좋습니다.

  • "최종 문서를 어떤 형식으로 써야 하는가?"
  • "트러블슈팅 문서 틀은 어떻게 잡는가?"

처음 보는 사람에게 추천하는 읽는 순서​

가장 쉬운 순서​

  1. Team Library Harness Generated Output
  2. Generated Files 정리본
  3. slack-to-team-library workflow
  4. intake-analyst
  5. slack-thread-analysis
  6. troubleshooting-doc 또는 ops-guide-doc

역할 중심으로 보고 싶다면​

  1. Agents
  2. Skills
  3. Workflows

실제 입력/출력 기준으로 보고 싶다면​

  1. Prompts
  2. Templates
  3. Workflows

실무적으로 가장 먼저 써볼 만한 조합​

조합 1. Slack 답변 문서화​

  • workflow: slack-to-team-library
  • agent: intake-analyst
  • skill: slack-thread-analysis
  • prompt: build-doc-from-slack
  • template: ops-guide-doc

조합 2. 회의록 정리​

  • agent: report-analyst
  • skill: meeting-notes-structuring
  • workflow: meeting-notes-to-doc-candidates

조합 3. 주간보고 분석​

  • skill: weekly-report-analysis
  • prompt: analyze-weekly-report
  • workflow: google-sheet-weekly-report-to-slack

한 줄 정리​

Generated Files는 복잡한 파일 묶음이 아니라, 역할(Agents) / 처리 규칙(Skills) / 흐름(Workflows) / 입력문(Prompts) / 결과 틀(Templates) 로 나눠서 보면 훨씬 쉽게 이해할 수 있는 문서 세트입니다.