Smart Codebase

Smart-Codebase

[English](README.md) | [简体中文](README.zh-cn.md)

**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.md
OpenCode Auto-Discovery]
    RefFiles[.opencode/skills/project/reference/*.md
Deep 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 se