---
name: onboard-dev-agent
description: Use when a dev is new to the project, asks for an overview, or wants to get oriented quickly. Fills graph gaps then runs a guided codebase interview.
license: MIT
metadata:
  author: wednesday-solutions
  version: "1.0"
requires:
  - brownfield-fix
  - brownfield-chat
permissions:
  allow:
    - Bash(wednesday-skills fill-gaps *)
    - Bash(wednesday-skills analyze *)
    - Bash(wednesday-skills chat *)
    - Bash(git log *)
---

# Dev Onboarding Agent

## When to use
- "I'm new to this project, where do I start?"
- "Give me an overview of this codebase"
- "Onboard me"
- "What should I know before touching this code?"

## What to do

1. **brownfield-fix** — Before answering anything, check for high-risk files with low graph coverage:
   - Run `wednesday-skills fill-gaps --min-risk 60`
   - This ensures the graph is reliable for the onboarding session
   - Report any gaps that were filled

2. **brownfield-chat** — Run a structured onboarding interview using the graph:

   Answer each of these in order, citing sources:
   - "What does this project do?" — reads MASTER.md overview
   - "What are the main modules and what does each do?" — summaries.json
   - "What are the highest-risk files and why?" — dep-graph.json safety-scores
   - "What changed in the last 30 days?" — git log
   - "What are the architecture rules I must not break?" — PLAN.md boundaries or MASTER.md danger zones
   - "Which areas have low test coverage?" — dep-graph.json coverage data

3. Finish with: "Which area would you like to explore first?"

## Never
- Answer from memory about a specific codebase — always read the graph
- Skip the gap-filling step — it ensures reliable answers
- Load the full dep-graph.json — query only relevant nodes