learn-codebase

name	learn-codebase
description	Claude Code codebase custom rules generator. Scans frameworks, dependency structures, test frameworks, and builds customized project-rules.md and CLAUDE.md files

Learn Codebase — Automated Workspace Rules Configuration

When to activate

• Initializing a new git repository or checking out a new codebase.
• Setting up project rules when there is no existing CLAUDE.md or .claude/rules/.
• Integrating automated build or testing pipeline guides in the workspace.
• Enforcing custom coding guidelines tailored to JavaScript, TypeScript, Python, Rust, or Go ecosystems.

When NOT to use

• Small, single-file scripts where no configuration or strict code formatting is needed.
• Static media, asset repositories, or generic text projects.

Instructions

The learn-codebase skill runs npx claudient learn to inspect the project layout, configurations, and frameworks. It then writes tailored code conventions, lint checks, and testing commands directly to .claude/rules/project-rules.md.

                    ┌───────────────────┐
                    │  Scan Directory   │
                    └─────────┬─────────┘
                              │
            ┌─────────────────┴─────────────────┐
            ▼                                   ▼
   Ecosystem Files                     Ecosystem Files
(package.json / Cargo.toml)      (tsconfig.json / eslintrc)
            │                                   │
            └─────────────────┬─────────────────┘
                              ▼
                    ┌───────────────────┐
                    │ Compile Metadata  │
                    └─────────┬─────────┘
                              │
            ┌─────────────────┴─────────────────┐
            ▼                                   ▼
     CLAUDE.md File                   project-rules.md File
   (Root commands)                    (Specific conventions)

1. Build and Test Scoping

The command automatically maps dependency profiles:

• Node.js/JS: Checks scripts in package.json to extract build, dev, and test runners (Jest, Playwright, Vitest).
• Python: Scans imports inside requirements.txt or pyproject.toml to identify Flask/Django/FastAPI apps and tests (Pytest).
• Rust: Configures cargo dependencies, test command cargo test, and lint routines.
• Go: Builds go module pipelines using go test ./....

2. Tailored Rules Generation

Based on the languages discovered, the command builds strict instructions:

• TypeScript: Enforces strict typings, forbids type casting to any, and sets interface design rules.
• FastAPI: Details Pydantic data validation structures and router designs.
• React/Next.js: Outlines App Router/Page Router specifications, Client/Server component separations, and schema inputs.

---

Example

Running codebase learning on a Next.js TypeScript repository:

npx claudient learn

Output:

🔍 Scoping codebase at: /Users/tushar/Desktop/Claudient

Detected Languages:  JavaScript, TypeScript
Detected Frameworks: Next.js, React
Testing Suites:      Jest, Playwright
Configuration Files: package.json, tsconfig.json, .eslintrc.json

✅ Rule file generated: .claude/rules/project-rules.md
✅ CLAUDE.md generated at codebase root

🎉 Learn complete. Custom rules added to active workspace configs.

This enables Claude Code to read .claude/rules/project-rules.md in subsequent prompts to automatically match the TypeScript interface style, Next.js architecture, and run testing commands.