---
id: topic-programming-index
title: "Topic Programming 인덱스"
category: "Index"
status: "draft"
verification_status: "applied"
canonical_id: ""
aliases: ["프로그래밍 위키 인덱스", "Topic_Programming 목차", "second brain coding index", "코딩 제2뇌 목차"]
duplicate_of: ""
source_trust_level: "A"
confidence_score: 0.95
created_at: 2026-06-13
updated_at: 2026-06-13
review_reason: ""
merge_history: []
tags: ["index", "navigation", "programming", "second-brain", "astraai"]
raw_sources: ["Topic_Programming 전체"]
applied_in: ["AstraAI"]
github_commit: ""
---

# [[Topic Programming 인덱스]]

## 🎯 한 줄 통찰 (One-line insight)
이 위키는 "로컬 작은 LLM(Gemma/Qwen/Llama 등)의 코딩·설계 능력을 제2뇌 지식으로 끌어올린다" 는 목적의 지식 베이스로, AstraAI 코드 분석에서 출발해 **언어 → 아키텍처 → 서브시스템 → 설계 결정(ADR) → 패턴 → 실패 → 플랫폼 → 일반 원칙** 으로 추상도를 높여간다.

## 🧠 핵심 개념 (Core concepts)
- **목적:** 코드 설명이 아니라 *전이 가능한 엔지니어링 지능* 을 작은 모델에 제공.
- **출처:** 1차 코드는 AstraAI(Astra) VS Code 확장(TypeScript, 308 파일). 일반 지식은 표준 소프트웨어 공학.
- **포맷:** P-Reinforce v3.1(frontmatter + 이모지 섹션 + [[위키링크]] + 출처).

## 📖 세부 내용 (Details · 전체 지도)

### 작은 모델 권장 학습 순서 (사용자 우선순위)
1. **프로젝트 위키** → 2. **설계 결정(ADR)** → 3. **패턴 라이브러리** → 4. **실패 라이브러리** → 5. **플랫폼별 개발 패턴** → 6. **일반 원칙**.

### 1) 언어 지식 (Language/)
- [[TypeScript 기초와 타입 시스템]] · [[TypeScript 고급 타입]] · [[비동기 프로그래밍 Promise async await]] · [[모듈 시스템과 프로젝트 구성]] · [[에러 처리와 커스텀 에러]]

### 2) 아키텍처·설계 (Architecture/)
- [[AstraAI 아키텍처 개요]] · [[VSCode 확장 구조와 생명주기]] · [[의존성 주입과 서비스 인터페이스]] · [[이벤트 소싱 스토어 패턴]] · [[동시성 제어 Lock Queue Transaction]]

### 3) 서브시스템 심층 (Subsystems/)
- [[5계층 메모리 시스템]] · [[RAG 검색 파이프라인]] · [[TF-IDF 이중언어 스코어링]] · [[LLM 프로바이더 추상화]] · [[Intelligence 검증 레이어]] · [[Agent 오케스트레이터 분해]]

### 4) 컨벤션 (Conventions/)
- [[코딩 컨벤션과 주석 철학]] · [[프롬프트 엔지니어링 패턴]]

### 5) 설계 결정 — ADR (Engineering_Intelligence/ADR/)
- [[ADR-0001 이벤트 소싱 채택]] · [[ADR-0002 5계층 메모리 분리]] · [[ADR-0003 단일작성자 다중역할 멀티에이전트]] · [[ADR-0004 순차 디스패치 채택]] · [[ADR-0005 파일 기반 저장 채택]] · [[ADR-0006 수동 의존성주입 인터페이스 서비스]] · [[ADR-0007 하이브리드 검색 결정론 우선]] · [[ADR-0008 로컬우선 LLM 클라우드 폴백]] · [[ADR-0009 결정론 항상 LLM검증 조건부]] · [[ADR-0010 오케스트레이터 골격 모듈추출]]

### 6) 엔지니어링 지능 (Engineering_Intelligence/)
- [[엔지니어링 트레이드오프 분석]] · [[교훈 라이브러리 Lessons Learned]] · [[안티패턴 카탈로그]] · [[아키텍처 휴리스틱]] · [[리팩토링 플레이북]] · [[디버깅 플레이북]]
- AI 학습 추출: [[AITRAIN 메모리 시스템]] · [[AITRAIN RAG 검색]] · [[AITRAIN 에이전트 오케스트레이션]] · [[AITRAIN 검증 레이어]] · [[AITRAIN 이벤트소싱 저장]] · [[AITRAIN 동시성 제어]] · [[AITRAIN 프로바이더 추상화]]

### 7) 패턴 카탈로그 (Pattern_Catalog/) → [[패턴 카탈로그 인덱스]]
- AI · Cross-cutting · Web · Mobile · Desktop 패턴 27종.

### 8) 실패 라이브러리 (Failure_Library/)
- [[소프트웨어 실패 라이브러리]]

### 9) 플랫폼 가이드 (Platform_Guides/) → [[플랫폼 개발 가이드 인덱스]]
- [[웹 개발 가이드]] · [[데스크탑 앱 개발 가이드]] · [[모바일 개발 가이드]] · [[백엔드 API 개발 가이드]] · [[AI 에이전트 개발 가이드]]

### 10) 일반 원칙 (Generalized_Principles/)
- [[프로젝트 독립 설계 원칙]] — 모든 것의 capstone(12원칙).

## ⚖️ 모순 및 업데이트 (Contradictions & updates)
AstraAI 사례 기반 지식은 *로컬·단일 사용자·작은 모델* 전제다. 다른 환경에선 [[엔지니어링 트레이드오프 분석]] 으로 재평가하라. 모든 문서는 draft — 사용하며 검증/보강.

## 🛠️ 적용 사례 (Applied in summary)
이 인덱스를 진입점으로, 작은 모델은 질의에 맞는 계층(언어/패턴/실패/원칙)을 RAG 로 회수해 컨텍스트에 주입한다.

## 🔗 지식 그래프 (Knowledge Graph)
- **상위/루트:** [[Topic Programming 인덱스]]
- **관련 개념:** [[AstraAI 아키텍처 개요]] · [[패턴 카탈로그 인덱스]] · [[플랫폼 개발 가이드 인덱스]] · [[프로젝트 독립 설계 원칙]]
- **참조 맥락:** 제2뇌 전체의 목차이자 진입점.

## 📚 출처 (Sources)
- [S1] Topic_Programming 전체 문서 + AstraAI 소스 분석

## 📝 변경 이력 (Change history)
- 2026-06-13: 제2뇌 코딩 지식 베이스 마스터 인덱스 생성.
