Files

T

Antigravity Agent 9148c358d0 docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거

Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를
Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류.

- 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로
  자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거,
  동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거.
- 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming,
  Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business,
  Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로,
  나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는
  title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백).
  원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지.
- 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서.
- 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는
  지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지.
- Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경.
- 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.

2026-07-05 00:33:48 +09:00

2.7 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, last_reinforced, review_reason, merge_history, tags, raw_sources, tech_stack, applied_in, verification_status, related_notes

title

Optional과 Union 판단

한 줄 통찰

None이 끼는 순간 API 경계가 더 중요한 설계 문제가 된다.

핵심 개념

요약: Optional, Union, None 처리 기준을 다룬다.
지식 축: 정적 타입 힌트와 타입 기반 설계를 다루는 Python 지식 축
이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다.

세부 내용

타입 힌트는 문서이자 검증 도구이며 협업 비용을 낮춘다.
정확한 타입은 리팩토링 자신감을 높인다.
점진적 적용이 중요하며 팀의 규칙과 함께 가야 한다.
이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다.

의사결정 기준

도메인 경계와 공개 API부터 타입을 강화한다.
복잡한 타입은 가독성과 안정성의 균형을 본다.
런타임 검증과 정적 타입의 역할을 분리한다.

안티패턴

타입을 형식 체크용 장식으로만 붙인다.
과도한 타입 마법으로 가독성을 해친다.
공개 API에 타입 기준이 없어 협업 비용을 키운다.

적용 사례

아직 직접 연결된 실제 적용 사례는 없다.
verification_status: conceptual 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다.

중복 검사 결과

2026-05-14 기준 Topics/Coding 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다.
일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다.

모순 및 업데이트

현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다.
실제 프로젝트 적용이나 코드 사례가 생기면 applied_in과 verification_status를 갱신한다.

Raw Source

user_request:2026-05-14-python-coding-batch

변경 이력

2026-05-14: Python 코딩 지식 배치용 초기 문서 생성.

2.7 KiB Raw Blame History