refactor(topics): 멀티 에이전트용 지식 재편 — _Common(공통 기본기) + Domain_* 구조
에이전트 8종(대화형/프로그래머 C·S/디자이너/설계자/기획자/QA/PD/PM)에게 [공통 기본 능력 + 롤별 Specialty] 2층으로 지식을 주입하기 위한 재분류. 문서 내용·포맷은 무수정, 폴더 이동만 (6,372개 문서 수 보존 확인). - Topic_Programming → Domain_Programming (내부 구조 보존) - Topic_Graphic → Domain_Design - Topic_Business → Domain_Product - Topic_General → Domain_General - _Common 신설: Math(구 Topic_Math_Specialty), Reasoning(구 General/From_Thinking & Reasoning), Reasoning_Creativity(구 General/From_창의성), Communication(Poetic_Blog_Writing + From_writing) - 타 도메인의 From_* 폴더는 유지 (출처 표기일 뿐, 이미 도메인에 맞게 분류된 문서) - 빈 폴더 정리 (memory/procedures) - 에이전트→폴더 매핑은 workspace의 .astra/agent-knowledge-map.json (9개 에이전트) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,71 @@
|
||||
---
|
||||
id: wiki-2026-0514-python-104
|
||||
title: cancelation 설계
|
||||
category: 10_Wiki/Topics/Coding/Python
|
||||
status: needs_review
|
||||
canonical_id: self
|
||||
aliases: [python_async_cancellation]
|
||||
duplicate_of: none
|
||||
source_trust_level: C
|
||||
confidence_score: 0.6
|
||||
created_at: 2026-05-14
|
||||
updated_at: 2026-05-14
|
||||
last_reinforced: 2026-05-14
|
||||
review_reason: ai_generated_concept_batch
|
||||
merge_history: []
|
||||
tags: [Python, async, python_async_cancellation]
|
||||
raw_sources: [user_request:2026-05-14-python-coding-batch]
|
||||
tech_stack: { language: "Python", pillar: "async" }
|
||||
applied_in: []
|
||||
verification_status: conceptual
|
||||
related_notes: [cancellation, cleanup, asyncio]
|
||||
---
|
||||
|
||||
# cancelation 설계
|
||||
|
||||
## 한 줄 통찰
|
||||
> 취소는 예외 상황이 아니라 기본 흐름으로 설계해야 한다.
|
||||
|
||||
## 핵심 개념
|
||||
- 요약: 비동기 cancellation 흐름과 안전한 정리 패턴을 다룬다.
|
||||
- 지식 축: 비동기, 동시성, 병렬 처리와 관련된 Python 실행 모델 지식
|
||||
- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다.
|
||||
|
||||
## 세부 내용
|
||||
- 동시성 문제는 속도보다 작업 성격과 병목 위치를 먼저 봐야 한다.
|
||||
- asyncio, threads, processes는 서로 다른 비용 구조를 가진다.
|
||||
- 정확한 cancellation, timeout, backpressure 설계가 중요하다.
|
||||
- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다.
|
||||
|
||||
## 의사결정 기준
|
||||
- I/O bound와 CPU bound를 먼저 구분한다.
|
||||
- 동시성 도입 전 단순 구조로 충분한지 검토한다.
|
||||
- 종료, 오류 전파, 리소스 해제를 기본 설계에 넣는다.
|
||||
|
||||
## 안티패턴
|
||||
- 비동기를 만능 성능 해법처럼 쓴다.
|
||||
- 취소와 종료 흐름을 설계하지 않는다.
|
||||
- 공유 상태 경쟁 조건을 무시한다.
|
||||
|
||||
## 적용 사례
|
||||
- 아직 직접 연결된 실제 적용 사례는 없다.
|
||||
- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다.
|
||||
|
||||
## 중복 검사 결과
|
||||
- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다.
|
||||
- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다.
|
||||
|
||||
## 모순 및 업데이트
|
||||
- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다.
|
||||
- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in`과 `verification_status`를 갱신한다.
|
||||
|
||||
## 관련 문서
|
||||
- [[cancellation]]
|
||||
- [[cleanup]]
|
||||
- [[asyncio]]
|
||||
|
||||
## Raw Source
|
||||
- user_request:2026-05-14-python-coding-batch
|
||||
|
||||
## 변경 이력
|
||||
- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성.
|
||||
Reference in New Issue
Block a user