위키독스 분석 보드 — 2026-06-30

육상무선통신사 시험 대비를 위해 전파법·시행령·무선설비규칙의 정의, 무선국 허가·신고·검사·운용·보안·제재 절차를 조문 중심으로 정리한 법규 암기형 교재다.

adopt 후보 2개, improve 4개, skip 1개 — 핵심 가치는 무선통신 지식이 아니라 법규형 원문에서 기한·상태·검사·제재 구조를 추출해 형님 자동화 품질관리와 위키독스 분석 스키마를 정밀화하는 데 있다.

1. IMPROVE 법규형 지식의 조문-개념-절차 구조화
   wikidocs_analyzer.py의 분석 프롬프트 또는 후처리에 'legal_procedure_schema' 항목을 추가한다. 필드는 article, trigger_condition, required_action, authority, deadline, exception, sanction으로 둔다. 전파법규·공인중개사 법령·세무·계약서류처럼 절차형 법규 책에만 선택 적용한다.
2. ADOPT 기한·주기·만료일 기반 리마인더 추출
   wikidocs_analyzer.py에 deadline_extraction 섹션을 추가한다. 정규식과 LLM 추출을 병행해 'N년', 'N개월 전', 'N일 이내', '전후 N개월', '매 N년' 표현을 잡고, 결과를 옵시디언 분석 노트에 deadlines 배열로 저장한다. 이후 필요 시 apple-reminders 또는 Google Calendar 연동은 별도 단계로 둔다.
3. IMPROVE 허가·신고·면제·금지의 상태 분류
   obsidian_keywords 또는 wikidocs_analyzer 출력에 normative_status 필드를 추가한다. 값은 allowed, permit_required, report_required, exempt, prohibited, sanctionable로 제한한다. 전파법규 본문에서 '허가를 받아야 한다', '신고하여야 한다', '신고하지 아니하고', '할 수 없다', '면제' 패턴을 우선 룰 기반으로 추출한다.
4. IMPROVE 혼신·간섭·공동사용을 통한 동시 작업 충돌 관리 비유
   PostToolUse hook 설계 문서 또는 pre_write_harness_check.py 주변 가이드에 'shared-resource interference checklist'를 추가한다. 항목은 target_file lock, hook idempotency, retry backoff, simultaneous Write/Edit detection, queue serialization으로 둔다. 책 내용은 직접 코드가 아니라 충돌관리 체크리스트의 메타포 근거로만 사용한다.
5. ADOPT 검사·감시·제재의 운영 품질 루프
   pipeline_observer.py 또는 별도 automation_quality_report.py에 검사 등급을 추가한다. 신규 자동화는 준공검사, 기존 launchd/cron은 정기검사, 실패율 급등 작업은 수시검사, 반복 실패 작업은 운용정지 후보로 분류한다. 측정값은 success_rate, last_success_at, mean_runtime_sec, retry_count, alert_count로 둔다.

FastAPI를 중심으로 Svelte 프론트엔드, SQLAlchemy ORM, Alembic 마이그레이션, 라우터·의존성·Pydantic 구조를 단계적으로 붙여 하나의 게시판 서비스를 완성해 가는 입문형 풀스택 API 개발서다.

adopt 후보 3개, improve 3개, skip 1개 — 핵심 가치는 FastAPI 문법 자체가 아니라 형님 자동화를 외부 API·교육 콘텐츠·장기 운영 DB로 확장할 때 필요한 '재현 가능한 단계 관리, API 계약, migration 규율'이다.

1. ADOPT 챕터별 완성 소스 태그와 변경 내역 링크
   전자책·강의용 자동화 템플릿에 'chapter_version', 'complete_source_url', 'diff_url' 필드를 추가한다. 적용 후보 파일은 강의·전자책 생성 SKILL 또는 wikidocs_analyzer.py의 분석 출력 스키마다. 각 실습형 글에는 vN.NN 태그와 commit diff 링크를 필수 메타데이터로 넣는다.
2. IMPROVE 백엔드·프론트엔드 분리 실습 루프
   Hermes 자동화 대시보드나 system-dashboard에 FastAPI mock endpoint + Svelte/Vite 개발 루프 예제를 추가한다. 특히 CORS origins를 localhost와 127.0.0.1 양쪽으로 명시하고, fetch 실패를 브라우저 콘솔 기준으로 진단하는 체크리스트를 SKILL에 넣는다.
3. ADOPT 도메인별 router·crud·schema 3분할 구조
   HARNESS_DOMAIN_REGISTRY.md에 'api_exposure_pattern' 섹션을 추가하고, HTTP로 노출되는 agent는 <domain>_router.py, <domain>_service.py 또는 <domain>_crud.py, <domain>_schema.py를 기본 구조로 지정한다. 신규 FastAPI 기반 agent 템플릿에도 이 구조를 반영한다.
4. IMPROVE Pydantic 입출력 스펙과 자동 테스트 문서
   harness_integration.run_as_automation에 붙는 주요 agent부터 InputModel, OutputModel Pydantic 클래스를 추가한다. FastAPI 래퍼를 만들 경우 /docs에서 agent별 요청·응답 예시가 보이게 하고, 기존 selftest는 schema validation을 포함하도록 확장한다.
5. ADOPT Alembic 기반 데이터베이스 변경 관리
   채널 브리지 SQLite와 wikidocs_state 계열 저장소 중 스키마가 있는 DB부터 migrations/ 디렉터리와 alembic.ini를 추가한다. schema 변경 시 직접 ALTER TABLE 대신 alembic revision 파일을 남기도록 Pre-Write Protocol 체크 항목에 'DB schema 변경이면 migration 포함'을 추가한다.