e2c5471046
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
5.3 KiB
5.3 KiB
id, title, category, status, verification_status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, review_reason, merge_history, tags, raw_sources, applied_in, github_commit
| id | title | category | status | verification_status | canonical_id | aliases | duplicate_of | source_trust_level | confidence_score | created_at | updated_at | review_reason | merge_history | tags | raw_sources | applied_in | github_commit | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| topic-programming-index | Topic Programming 인덱스 | Index | draft | applied |
|
A | 0.95 | 2026-06-13 | 2026-06-13 |
|
|
|
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 · 전체 지도)
작은 모델 권장 학습 순서 (사용자 우선순위)
- 프로젝트 위키 → 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/) → 플랫폼 개발 가이드 인덱스
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뇌 코딩 지식 베이스 마스터 인덱스 생성.