문서 유지보수 전략

name: Docs Sync Check
on:
  pull_request:
    paths:
      - 'src/**'
      - 'app/**'
      - 'docs/**'
      - 'AGENTS.md'
      - 'CLAUDE.md'
      - '.claude/**'
      - '.agents/**'

jobs:
  check-docs:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Check docs need update
        run: |
          SRC_CHANGED=$(git diff --name-only origin/main...HEAD | grep -E '^(src|app)/' || true)
          DOCS_CHANGED=$(git diff --name-only origin/main...HEAD | grep -E '^(docs/|AGENTS.md|CLAUDE.md|\\.claude/|\\.agents/)' || true)

          if [ -n "$SRC_CHANGED" ] && [ -z "$DOCS_CHANGED" ]; then
            echo "::warning::Code changed without docs or agent instructions update."
            echo "Confirm whether docs, AGENTS.md, CLAUDE.md, skills, or MCP resources need changes."
          fi

#!/usr/bin/env bash
set -euo pipefail

changed_api=$(git diff --name-only --cached | grep -E '^(src|app)/api/' || true)
changed_docs=$(git diff --name-only --cached | grep -E '^(docs/api|openapi|AGENTS.md|CLAUDE.md)' || true)

if [ -n "$changed_api" ] && [ -z "$changed_docs" ]; then
  echo "API code changed. Check API docs, OpenAPI, and agent instructions."
  exit 1
fi

codex --ask-for-approval never "List the active project instructions and summarize the validation commands. Do not modify files."

claude "Run /memory and tell me which CLAUDE.md, CLAUDE.local.md, and rules files are loaded. Do not edit files."

release-check Skill을 사용해서 현재 diff를 검토해줘.
파일을 수정하지 말고, 실행할 검증 명령과 누락 위험만 보고해줘.

freshness:
  warn_after_days: 90
  critical_after_days: 180
  review_required:
    - AGENTS.md
    - CLAUDE.md
    - .claude/rules/**
    - .agents/skills/**
    - .codex-plugin/plugin.json
    - docs/api/**
  exclude:
    - docs/adr/**
    - CHANGELOG.md

다음 문서와 현재 코드를 비교해서 불일치를 찾아줘.

문서:
- AGENTS.md
- CLAUDE.md
- docs/api/*.md
- .agents/skills/*/SKILL.md

코드:
- package.json
- src/api/**
- app/api/**
- openapi/**

확인할 것:
1. 문서의 명령어가 실제 scripts와 일치하는가
2. API 설명이 실제 route/schema와 일치하는가
3. Skill 절차가 현재 CI/배포 방식과 일치하는가
4. 금지사항과 하위 규칙이 서로 충돌하지 않는가
5. 삭제/이름 변경된 파일 경로가 남아 있는가