# Astra Project Knowledge Overview

Date: 2026-05-02T16:14:59.756Z
Project: Astra
Repository: `/Volumes/Data/project/Antigravity/ConnectAI`

## Purpose
Astra는 VS Code 안에서 로컬 AI 에이전트, Second Brain, 프로젝트 기록, 에이전트 스킬을 연결하는 개발 보조 프로젝트다.

## Confirmed Structure
- `src/agent.ts`: 에이전트 실행, 로컬 경로 프리플라이트, Second Brain Trace, 액션 실행 흐름의 중심.
- `src/sidebarProvider.ts`: Webview UI, 브레인/모델/프로젝트 선택, 프롬프트 전달, 기록 UI를 담당.
- `src/features/secondBrainTrace.ts`: Second Brain 검색 결과와 근거 정책을 구성.
- `src/features/projectChronicle/`: 프로젝트 기록을 Markdown으로 관리하는 Chronicle 기능.
- `src/core/`: 큐, 이벤트, 트랜잭션, 오류 처리 등 실행 안정성 계층.
- `tests/`: Second Brain, 로컬 경로 프리플라이트, Chronicle, 보안/트랜잭션 회귀 테스트.

## Evidence Files
- `package.json`
- `docs/records/ConnectAI/README.md`
- `README.md`
- `src/agent.ts`
- `src/agents/AgentWorkflowManager.ts`
- `src/agents/factory.ts`
- `src/bridge.ts`
- `src/config.ts`
- `src/extension.ts`
- `src/MrBeast_Premium_10.md`
- `src/security.ts`
- `src/sidebarProvider.ts`

## Scanned Tree Excerpt
```text
assets/
  assets/icon.png
  assets/icon.svg
core_py/
  core_py/events.py
  core_py/inference.py
  core_py/loader.py
  core_py/monitoring.py
  core_py/optimizer.py
  core_py/queue_worker.py
  core_py/requirements.txt
docs/
  docs/records/
    docs/records/ConnectAI/
      docs/records/ConnectAI/decisions/
      docs/records/ConnectAI/development/
        docs/records/ConnectAI/development/2026-05-02_answer-format-readability-tuning.md
        docs/records/ConnectAI/development/2026-05-02_local-path-code-review-preflight.md
        docs/records/ConnectAI/development/2026-05-02_no-evidence-no-project-claim.md
        docs/records/ConnectAI/development/2026-05-02_progressive-answer-format.md
        docs/records/ConnectAI/development/2026-05-02_project-claim-output-brake.md
        docs/records/ConnectAI/development/2026-05-02_project-claim-policy-enforcement.md
        docs/records/ConnectAI/development/2026-05-02_query-intent-search-tuning.md
        docs/records/ConnectAI/development/2026-05-02_remove-local-template-replies.md
        docs/records/ConnectAI/development/2026-05-02_second-brain-trace-quality-tuning.md
      docs/records/ConnectAI/discussions/
      docs/records/ConnectAI/planning/
        docs/records/ConnectAI/planning/2026-05-02_project-chronicle-guard.md
        docs/records/ConnectAI/planning/2026-05-02_second-brain-trace-mode.md
      docs/records/ConnectAI/project-profile.md
      docs/records/ConnectAI/README.md
      docs/records/ConnectAI/timeline.md
  docs/Advanced_Features_Implementation_Guide.md
  docs/UX_UI_Consistency_Guidelines.md
src/
  src/agents/
    src/agents/AgentWorkflowManager.ts
    src/agents/factory.ts
  src/core/
    src/core/conflict.ts
    src/core/dataProcessor.ts
    src/core/errorHandler.ts
    src/core/errors.ts
    src/core/events.ts
    src/core/health.ts
    src/core/lock.ts
    src/core/queue.ts
    src/core/services.ts
    src/core/session.ts
    src/core/statusBar.ts
    src/core/transaction.ts
  src/features/
    src/features/projectChronicle/
      src/features/projectChronicle/guardPrompt.ts
      src/features/projectChronicle/index.ts
      src/features/projectChronicle/markdownFileWriter.ts
      src/features/projectChronicle/templates.ts
      src/features/projectChronicle/types.ts
    src/features/secondBrainTrace.ts
  src/lib/
    src/lib/engine.ts
  src/types/
    src/types/interfaces.ts
  src/agent.ts
  src/bridge.ts
  src/config.ts
  src/extension.ts
  src/MrBeast_Premium_10.md
  src/security.ts
  src/sidebarProvider.ts
  src/utils.ts
tests/
  tests/mocks/
    tests/mocks/vscode.js
  tests/dataProcessor.test.ts
  tests/localPathPreflight.test.ts
  tests/projectChronicle.test.ts
  tests/projectChronicleGuardPrompt.test.ts
  tests/secondBrainTrace.test.ts
  tests/systemPrompt.test.ts
```

## Current Knowledge Gap
- 전체 아키텍처는 파일 구조와 일부 프리뷰 기준으로 파악 가능하지만, 세부 동작 지식은 `src/agent.ts`, `src/sidebarProvider.ts`, `secondBrainTrace.ts`, `projectChronicle` 순서로 심화 분석해 보강해야 한다.

## Next Records
- `agent.ts` 실행 흐름 상세 분석
- Second Brain Trace 검색 및 근거 정책 분석
- Project Chronicle 기록 생성 흐름 분석