Skip to content

feat: Add Codebase Onboarding Engineer#388

Open
varshithdupati wants to merge 1 commit intomsitarzewski:mainfrom
varshithdupati:add-codebase-onboarding-engineer
Open

feat: Add Codebase Onboarding Engineer#388
varshithdupati wants to merge 1 commit intomsitarzewski:mainfrom
varshithdupati:add-codebase-onboarding-engineer

Conversation

@varshithdupati
Copy link
Copy Markdown

What does this PR do?

Agent Information (adding a new agent)

Agent Name: Codebase Onboarding Engineer
Category: engineering
Specialty: Helps new developers understand unfamiliar codebases quickly by reading source code, tracing code paths, and stating only facts grounded in the code.

Motivation

Onboarding into an unfamiliar codebase is a common developer pain point.

Traditional LLM behavior is often useful, but it is not constrained enough for fast, factual codebase onboarding. It can mix explanation with assumptions, suggestions, or redesign ideas when the developer's immediate need is simply to understand what the code actually does.

This agent is designed to fill that gap. It is onboarding-first, read-only, and grounded in source code. Its job is to help new developers build a trustworthy mental model of a repository by tracing real code paths and explaining structure without drifting into recommendations.

Testing

  • Linted with ./scripts/lint-agents.sh engineering/engineering-codebase-onboarding-engineer.md
  • Tested against 2-3 personal and external codebases
  • Verified that the agent stays focused on factual, code-grounded onboarding and explanation

Checklist

  • Follows agent template structure
  • Includes personality and voice
  • Has concrete code/template examples
  • Defines success metrics
  • Includes step-by-step workflow
  • Proofread and formatted correctly
  • Tested in real scenarios

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant