Skip to content

Codebase Mentor logo: an open book with code brackets and a guiding path

CODEBASE MENTOR BY JESTATS

Your repo's design.
In your agent's context.

Set up once. Give your agent the design constraints, examples, and tests
it needs to make changes that fit your repository.

Get started View on GitHub

Claude Code · Codex · IBM Bob · Open skills
No extra API key or service needed for skills.

Capture the important context

Draft a short repo map from source, then answer up to three questions about the design decisions source cannot explain.

Guide everyday changes

Native project instructions point agents to the relevant subsystem guide, valid examples, and constraints before substantive work.

Keep context useful

When relevant claims drift, review a focused correction. Existing documents and human rationale stay under your control.

Set up your repository

Install for your agent, open your repository, and ask:

Set up Codebase Mentor for this repo.

Mentor reads existing instructions, documentation, source, and tests. It reuses or drafts an ONBOARDING.md, adds up to three focused guides where deeper context is missing, and connects your selected agents through small project instruction entries. It asks up to three targeted questions across the whole setup.

Then start a fresh session and ask for an ordinary change. Check that your agent reads the relevant context and verifies its claims against source. “Is Mentor set up correctly here?” reports configured files separately from observed use; configuration alone does not prove activation.

You can also use the mentor directly without setup or a map: “Use Codebase Mentor to trace one important execution path in this repo.” To draft documents without changing project instructions, ask for a draft only.

Install where you already work

Install the native plugin directly from Codebase Mentor’s repository, which includes the codebase-mentor marketplace.

Run inside Claude Code:

/plugin marketplace add jestatsio/codebase-mentor
/plugin install codebase-mentor@codebase-mentor

Run with a current Codex CLI:

codex plugin marketplace add jestatsio/codebase-mentor
codex plugin add codebase-mentor@codebase-mentor

Or add jestatsio/codebase-mentor in the Codex app's plugin interface and choose Codebase Mentor from Codebase Mentor by JEStats.

From the repository you want to understand:

curl -fsSL https://raw.githubusercontent.com/jestatsio/codebase-mentor/main/install.sh | bash -s -- --agent bob --project

Installs both skills in .bob/skills/.

All installation options, updates, and troubleshooting →

Already installed from jestats-plugins or as direct skills? Follow switching installation methods to keep one copy per agent.

The doc is the map. Source is the truth.

A short ONBOARDING.md points your agent toward the right source and scoped subsystem guides. It records constraints, examples, tests, and attributed rationale. The mentor protocol asks the agent to verify behavior and distinguish documented decisions from unresolved questions.

Architecture and change guidance require source evidence read in the current session.

Missing evidence stays visible. Proposed maintenance changes need review unless already authorized. A small task should need only the context relevant to that task.

These are instructions to your agent, not a guarantee of correctness. Review the cited source before acting. The original case study explains what was evaluated and its limits.

Built to share with your team

An open source tool from JEStats. Created by Eric Hare. MIT licensed.