한국어 |

OpenCode를 각 작업과 학습하고 성장하는 수석 프로젝트 전문가로 전환하십시오.

---

🔥 통증 포인트

새로운 세션을 시작할 때마다 AI가 처음부터 시작합니다. 그것은 기억하지 않습니다:

• 왜 당신은 그 아키텍처를 선택 했습니까?
• 코드베이스에 어떤 gotchas 존재?
• 당신의 본은 무엇을 따릅니다?
• 험악한 버그를 디버깅에서 배운 것은?

당신은 이상과 같은 것을 설명합니다.

✨ 해결책

Smart-Codebase는 SKILL 파일을 통해 AI 영구 메모리를 제공합니다. AI 에이전트를 사용하여 대화 및 프로젝트 파일에서 자율적으로 지식을 캡처합니다.

---

제목의 표

• ⚙️ 어떻게 작동하나요?
• ☸ 설치
• ⚙️ 설정
• • 파일 구조
• 542️ 개발

---

# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

1. ** 당신은 일반적으로 작동 ** - 파일을 편집, 디버그 문제, 건축 결정을.
2. First time setup - 소스 코드를 스캔하고 종합적인 SKILL 파일을 생성하기 위해 한 번 [T0]을 실행하십시오.
3. Ongoing Capture - 현재 세션에서 지식을 추출하기 위해 이정표에 도달하면 /sc-update를 실행합니다.
4. 명세.

Smart-Codebase

English | 简体中文

Turn your OpenCode into a senior project expert that learns and grows with every task.

---

🔥 The Pain Point

Every time you start a new session, AI starts from scratch. It doesn’t remember:

• Why you chose that architecture?
• What gotchas exist in your codebase?
• What patterns your team follows?
• What you learned from debugging that nasty bug?

You explain the same things over and over.

✨ The Solution

Smart-Codebase gives your AI permanent memory through SKILL files. It uses an AI agent to autonomously capture knowledge from your conversations and project files.

graph TB
    Start([Session Work])
    Init[sc-init command]
    Update[sc-update command]
    InitAgent[AI Scans Source Code]
    UpdateAgent[AI Analyzes Session]
    SkillFile[.opencode/skills/project/SKILL.mdOpenCode Auto-Discovery]
    RefFiles[.opencode/skills/project/reference/*.mdDeep Dive Docs]
    NewSession([New Session Starts])
    Injector[Context Injector]
    
    Start --> Init
    Start --> Update
    Init --> InitAgent
    Update --> UpdateAgent
    InitAgent -->|writes| SkillFile
    InitAgent -->|writes| RefFiles
    UpdateAgent -->|updates| SkillFile
    UpdateAgent -->|updates| RefFiles
    
    NewSession --> Injector
    Injector -->|inject hint| SkillFile

---

📖 Table of Contents

• ⚙️ How It Works
• 📦 Installation
• ⚡ Commands
• ⚙️ Configuration
• 📁 File Structure
• 🛠️ Development

---

⚙️ How It Works

1. You work normally - Edit files, debug issues, and make architectural decisions.
2. First time setup - Run /sc-init once to scan your source code and generate comprehensive SKILL files.
3. Ongoing capture - When you reach a milestone, run /sc-update to extract knowledge from the current session.
4. AI Agent analyzes - A child AI session examines your conversation or project code to understand what changed and why.
5. Knowledge distilled - The agent autonomously writes or updates SKILL files in standard OpenCode format.
6. Next session starts - New sessions auto-discover your project SKILLs, giving the AI immediate context.

Manual control means you decide exactly when to preserve knowledge. The AI agent handles the heavy lifting of writing documentation.

---

📦 Installation

Navigate to your ~/.config/opencode directory:

# Using bun
bun add smart-codebase

# Or using npm
npm install smart-codebase

Add to your opencode.json:

{
  "plugin": ["smart-codebase"]
}

---

⚡ Commands

---