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:
Antigravity Agent
2026-07-11 11:05:56 +09:00
parent 6549ead309
commit c24165b8bc
6193 changed files with 1717 additions and 31 deletions
@@ -0,0 +1,71 @@
---
id: wiki-2026-0514-python-143
title: requirements.txt와 constraints.txt
category: 10_Wiki/Topics/Coding/Python
status: needs_review
canonical_id: self
aliases: [python_requirements_constraints]
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, packaging, python_requirements_constraints]
raw_sources: [user_request:2026-05-14-python-coding-batch]
tech_stack: { language: "Python", pillar: "packaging" }
applied_in: []
verification_status: conceptual
related_notes: [requirements, constraints, packaging]
---
# requirements.txt와 constraints.txt
## 한 줄 통찰
> 의존성 명세를 나누면 업데이트 리스크를 더 잘 통제할 수 있다.
## 핵심 개념
- 요약: 두 파일의 역할 차이와 운영 전략을 정리한다.
- 지식 축: 패키징, 의존성, 환경, 배포를 다루는 Python 운영 지식 축
- 이 문서는 Python 코딩과 설계, 운영, 품질 판단에 연결할 수 있는 개념 초안이다.
## 세부 내용
- 환경 관리가 흔들리면 Python 프로젝트는 재현성을 잃기 쉽다.
- 패키징은 배포보다 경계와 메타데이터 설계 문제이기도 하다.
- 의존성 관리는 기술 부채의 주요 출발점이다.
- 이 주제는 Python 코드의 표현 방식뿐 아니라 팀 규칙, 운영 환경, 리팩토링 비용까지 함께 고려해야 한다.
## 의사결정 기준
- 프로젝트 목적에 맞는 패키징 수준을 먼저 정한다.
- 재현 가능한 환경과 잠금 전략을 함께 설계한다.
- 개발용 설정과 배포용 설정을 명확히 분리한다.
## 안티패턴
- 전역 환경에 무분별하게 설치한다.
- 의존성 버전 전략 없이 패키지를 추가한다.
- 배포 메타데이터를 나중 문제로 미룬다.
## 적용 사례
- 아직 직접 연결된 실제 적용 사례는 없다.
- `verification_status: conceptual` 상태이며 추후 실제 Python 프로젝트, 스크립트, 서비스 구조에 연결되면 갱신한다.
## 중복 검사 결과
- 2026-05-14 기준 `Topics/Coding` 전역에서 동일 제목의 Python 전용 문서는 직접 확인되지 않았다.
- 일부 유사 개념은 범용 코딩 문서 또는 AI/Backend 문서 안에 부분적으로 존재할 수 있으므로 후속 정리 대상이다.
## 모순 및 업데이트
- 현재 문서는 사용자 요청으로 생성된 AI 기반 개념 초안이다.
- 실제 프로젝트 적용이나 코드 사례가 생기면 `applied_in``verification_status`를 갱신한다.
## 관련 문서
- [[requirements]]
- [[constraints]]
- [[packaging]]
## Raw Source
- user_request:2026-05-14-python-coding-batch
## 변경 이력
- 2026-05-14: Python 코딩 지식 배치용 초기 문서 생성.