codebase-search

Consult .codebase documentation before searching code in multi-module repositories.

Updated Jan 2, 2026

Search Tags:#architecture #documentation #codebase #navigation #project-context #code-search

Ready to run

npx skills add https://github.com/stravinest/house-hold-account --skill codebase-search-stravinest

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: codebase-search
Source: https://github.com/stravinest/house-hold-account/tree/main/.claude/skills/codebase-search
Command: npx skills add https://github.com/stravinest/house-hold-account --skill codebase-search-stravinest

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

이 스킬은 코드베이스 탐색을 시작하기 전에 .codebase/ 디렉토리의 문서를 먼저 참고하여 프로젝트의 구조와 맥락을 파악합니다.

Core Features & Use Cases

문서 우선 확인: .codebase/ARCHITECTURE.md, .codebase/DIRECTORY.md, .codebase/API.md 등 핵심 문서를 먼저 읽어 아키텍처와 모듈 간 관계를 이해합니다.
맥락 기반 탐색: 파악한 컨텍스트를 바탕으로 대상 파일 위치와 구현 위치를 효율적으로 찾습니다.
Use Case: 새로운 모듈이나 API를 탐색할 때, 검색 범위를 줄이고 의도된 파일을 빠르게 찾는 데 활용합니다.

Quick Start

먼저 .codebase/ 문서를 읽고 ARCHITECTURE.md, DIRECTORY.md, API.md를 확인한 뒤, 필요한 코드 검색을 시작합니다.

Frequently Asked Questions about codebase-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I navigate a multi-module repository before searching for code?▼

Navigating a multi-module repository requires consulting the `.codebase/` directory documentation such as ARCHITECTURE.md and DIRECTORY.md first. This identifies project architecture and module relationships to guide efficient code search and reduce exploration scope.

What is the best way to find the right API surface in a large codebase?▼

The best way to find the right API surface is by reading the `.codebase/API.md` file before executing a code search. This provides the intended API structure and context, allowing you to pinpoint target files efficiently without guessing directory locations.

When do I need to check `.codebase/` documentation for code exploration?▼

You need to check `.codebase/` documentation when exploring new modules or APIs across a multi-module repository. Reading files like MODULES.md and PATTERNS.md beforehand clarifies the architecture and intended implementation patterns before you search the codebase.

Can I use project context to narrow down code search scope in multi-module projects?▼

Yes, you can use project context to narrow down code search scope by leveraging `.codebase/DATABASE.md` and `.codebase/MODULES.md` first. Understanding these documented contexts directs you to the correct directory structure and implementation locations efficiently.

Why does searching code directly in a multi-module repository often miss the intended architecture?▼

Searching code directly misses the intended architecture because it skips the `.codebase/ARCHITECTURE.md` and `.codebase/PATTERNS.md` context. Without consulting these documents first, raw code search ignores the project's structural design and module boundaries, leading to inefficient exploration.