ai-rules handbook AI Log Automation Model

AI Log Automation Model

아침/저녁 자동 업데이트용 AI 로그 시스템을 설계할 때 필요한 흐름, 저장 구조, 검증 구조를 짧게 정리

guide docs/guide/AI_LOG_AUTOMATION_MODEL.md

목적: 아침/저녁 자동 업데이트용 AI 로그 시스템을 설계할 때 필요한 흐름, 저장 구조, 검증 구조를 짧게 정리


한 줄 요약

자동 업데이트는 자동 게시보다 자동 수집 -> evidence 저장 -> 초안 생성 -> 검토 후 반영 구조가 더 안전하다.


핵심 흐름

flowchart TD
    A[Scheduler<br/>morning / evening] --> B[Collector]
    B --> C[Official Sources]
    C --> D[Raw Evidence Snapshot]
    D --> E[Draft Generator]
    E --> F[Log Entry]
    F --> G{Verification Status}
    G -->|verified| H[Monthly Index]
    G -->|inferred| I[Needs Review Queue]
    G -->|needs-review| I

ERD 초안

erDiagram
    LOG_ENTRY ||--o{ SOURCE_SNAPSHOT : has
    LOG_ENTRY }o--|| MONTH_INDEX : belongs_to
    LOG_ENTRY {
      string id
      string title
      string status
      string source_type
      string source_url
      string evidence_path
      date published_at
      string category
    }
    SOURCE_SNAPSHOT {
      string id
      string title
      string url
      string source_type
      date fetched_at
      string local_path
    }
    MONTH_INDEX {
      string id
      string year
      string month
      string local_path
    }

왜 이 구조가 좋은가

  • 오탐이 나도 원문 evidence를 다시 볼 수 있다
  • verified / inferred / needs-review를 문서 단위로 구분할 수 있다
  • 월간 페이지는 자동 갱신하기 쉽고, 심화 문서는 guide/에 남길 수 있다
  • 로그가 단순 뉴스 요약이 아니라 audit 가능한 기록이 된다

권장 문서 경로

  • 날짜 문서: docs/log/YYYY/MM/YYYY-MM-DD-topic.md
  • 원문 스냅샷: docs/log/YYYY/MM/_sources/topic.md
  • 월간 인덱스: docs/log/YYYY/MM/00_INDEX.md
  • 연간 인덱스: docs/log/YYYY/00_INDEX.md

ai-rules 관점 메모

  • 자동화의 핵심은 더 많은 문서를 만드는 것이 아니라, 검증 가능성을 유지하면서 누적하는 것이다.
  • 이 구조는 handbook를 뉴스 모음이 아니라 evidence-backed operational memory로 바꾼다.
  • 나중에 viewer에서 status badge, source badge, evidence 링크를 바로 노출하면 오탐 방지에 도움이 된다.

구현 현황 (2026-04-16)

아래 Collector 파이프라인이 구현 완료되었다.

구성 요소 스크립트 상태
Collector (단일 프로젝트) scripts/export_ai_logs.ps1 구현 완료 — 3개 소스 분리 수집 (Cursor chat, Claude Code, Terminal)
Collector (멀티 프로젝트) scripts/ai-logs-daily.ps1 구현 완료 — Obsidian vault 프로젝트별/날짜별 출력
Scheduler scripts/setup-ai-logs-scheduler.ps1 구현 완료 — Windows 작업 스케줄러 등록/해제
Config ~/.ai-rules/ai-logs-config.json 구현 완료 — vault 경로 + 프로젝트 목록

출력 구조

Agent-Work-Hub/projects/{ProjectName}/logs/{YYYY}/{YYYY-MM-DD}/
├── cursor-{uuid}.md      # Cursor 채팅 로그
├── claude-{uuid}.md       # Claude Code 세션 로그 (KST 타임스탬프)
└── terminal-{n}.txt       # claude 명령 포함 터미널 로그

미구현

  • Draft Generator: 수집된 로그에서 일일 요약 초안 자동 생성
  • Verification Status: verified / inferred / needs-review 배지 시스템
  • Monthly/Yearly Index: 월간/연간 자동 인덱스 생성

제안 액션

  • viewer에 verified / inferred / needs-review 배지 추가
  • _sources/ 문서를 접을 수 있는 evidence 링크로 노출
  • schedule workflow는 초안 생성까지만 자동화하고 게시 전 검토 단계를 둠