# Codebase Navigation

> codebase-navigation

- Skill: `abdullah1854-claudesuperskills/codebase-navigation` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add abdullah1854-claudesuperskills/codebase-navigation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/abdullah1854-claudesuperskills/codebase-navigation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: abdullah1854 (https://skillmd.com/u/abdullah1854-claudesuperskills)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/abdullah1854-claudesuperskills/codebase-navigation

---

# codebase-navigation

Project structure exploration and mapping. Analyzes codebase architecture, identifies patterns, maps dependencies, and creates mental models. Use when: onboarding to new project, understanding architecture, finding relevant code.

## Metadata
- **Version**: 1.0.0
- **Category**: analysis
- **Source**: workspace


## Tags
`navigation`, `exploration`, `architecture`, `mapping`, `structure`

## MCP Dependencies
None specified

## Inputs
- `scope` (string) (optional): Scope: full, directory, file, function
- `path` (string) (optional): Path to analyze
- `focus` (string) (optional): Focus area: structure, dependencies, patterns, all

## Chain of Thought
1. Identify entry points (package.json, main files). 2. Map directory structure and conventions. 3. Identify key patterns (MVC, modules, services). 4. Trace dependency graph. 5. Find configuration files. 6. Document architecture insights.


## Workflow
No workflow defined

## Anti-Hallucination Rules
None specified

## Verification Checklist
None specified

## Usage

```typescript
// Execute via MCP Gateway:
gateway_execute_skill({ name: "codebase-navigation", inputs: { ... } })

// Or via REST API:
// POST /api/code/skills/codebase-navigation/execute
// Body: { "inputs": { ... } }
```



## Code

```typescript
// Codebase Navigation Skill
const scope = inputs.scope || 'full';
const focus = inputs.focus || 'all';

const explorationSteps = {
  structure: [
    '1. List root directory structure',
    '2. Identify src/lib/app directories',
    '3. Map module organization',
    '4. Find entry points',
    '5. Locate configuration files'
  ],
  dependencies: [
    '1. Read package.json/requirements.txt',
    '2. Map internal imports',
    '3. Identify shared modules',
    '4. Trace dependency chains',
    '5. Find circular dependencies'
  ],
  patterns: [
    '1. Identify architectural patterns (MVC, Clean, etc.)',
    '2. Find design patterns in use',
    '3. Map naming conventions',
    '4. Identify testing patterns',
    '5. Document code style'
  ]
};

console.log(`## Codebase Navigation - ${scope}

### Focus: ${focus}

### Exploration Steps:
${focus === 'all' ? 
  Object.entries(explorationSteps).map(([k, v]) => `#### ${k}\\n${v.join('\\n')}`).join('\\n\\n') :
  explorationSteps[focus]?.join('\\n') || 'Invalid focus area'}

### Quick Commands:
- \`tree -L 3 -I node_modules\` - Directory structure
- \`grep -r "import" --include="*.ts" | head -50\` - Import analysis
- \`find . -name "*.config.*"\` - Configuration files
- \`cat package.json | jq '.dependencies'\` - Dependencies

### Key Files to Check:
- README.md - Project overview
- package.json / requirements.txt - Dependencies
- tsconfig.json / pyproject.toml - Build config
- .env.example - Environment variables
- CLAUDE.md - AI instructions
`);
```

---
Created: Tue Dec 23 2025 00:30:24 GMT+0800 (Singapore Standard Time)
Updated: Tue Dec 23 2025 00:30:24 GMT+0800 (Singapore Standard Time)