Onboard Dev Agent

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

1. 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

1. 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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: wednesday-solutions
• Source: wednesday-solutions/ai-agent-skills
• License: MIT
• Homepage: https://www.npmjs.com/package/@wednesday-solutions-eng/ai-agent-skills

Install and usage instructions live in the source repository linked above.