PS-03: Autonomous Developer Onboarding Agent
Defines a project brief for building an AI agent that autonomously onboards new developers through chat, personalizes steps, tracks progress, and notifies HR.
What this file does
Defines a project brief for building an AI agent that autonomously onboards new developers through chat, personalizes steps, tracks progress, and notifies HR.
When to use it
- You need to build an automated developer onboarding system
- You want a structured problem statement and requirements for an agentic onboarding tool
- You are designing a hackathon or prototype for HR tech
- You need a template for an AI agent project specification
Assumes this stack
PS-03: Autonomous Developer Onboarding Agent
Background
Onboarding a new developer is one of the most resource-intensive processes in a software organization. The hard part? It requires coordinating multiple tools, systems, and stakeholders just to get a new hire productive.
Developers must:
- Gain access to repositories
- Set up tools
- Read documentation
- Understand architecture
- Learn internal processes
- Complete compliance tasks
While companies use platforms like GitHub, Slack, Jira, and documentation systems like Notion or Confluence, the onboarding process still relies heavily on manual coordination. This leads to:
- Delayed productivity
- Repeated explanations
- Inconsistent onboarding experiences
- Incomplete checklists
- Poor visibility into onboarding progress
We need a smarter onboarding system — an intelligent agent that can autonomously guide new hires, personalize onboarding paths, track progress, and notify HR upon successful completion.
Problem Statement
Organizations lack an autonomous onboarding system that can guide new software developers through company processes, personalize their onboarding experience based on role and experience, track completion, and generate structured confirmation to HR — all using a structured company knowledge base.
Objective
Build an Advanced Agentic Onboarding Platform that:
- Guides new employees step-by-step via a chat-based interface (Mandatory)
- Personalizes onboarding based on:
- Role (Backend / Frontend / DevOps)
- Experience Level (Intern / Junior / Senior)
- Tech Stack (Python / Node / Java, etc.)
- Uses a provided structured knowledge base with retrieval (RAG-style)
- Completes an onboarding checklist
- Sends a structured completion email to HR (Mandatory)
Target Users
- New Interns
- Software Engineers (Junior to Senior)
- HR Teams
- Engineering Managers
- DevOps Teams
Expected Solution Features
1. Personalized Onboarding Flow
- Ask structured onboarding questions
- Identify the employee persona (role, tech stack, experience level)
- Dynamically generate a customized onboarding path
2. Knowledge Base Integration
- Retrieve relevant company documentation (policies, setup guides, engineering standards)
- Answer contextual queries accurately while referencing source documents
- Avoid hallucinated information
3. Checklist Tracking
- Maintain a structured onboarding checklist
- Track completed tasks
- Clearly indicate onboarding status (In Progress / Completed)
4. HR Notification System
Upon completion, send a structured summary email including:
- Employee name
- Role and team
- Completed items
- Pending tasks (if any)
- Timestamp of completion
- Optional confidence score
Constraints
- Must implement chat-based onboarding interface
- Must generate structured HR email
- Should avoid hallucination beyond knowledge base
- Focus on agent intelligence over number of integrations
- Integration APIs may be mocked
Example Workflows & Interactions
Example Interaction
User: "Hi, I'm Riya. I've joined as a Backend Intern working on Node.js."
Agent should:
- Identify persona
- Provide setup steps
- Share backend docs
- Guide environment setup
- Provide a small starter task
- Mark the checklist complete
- Send the HR completion email
Personalized Onboarding Flow Examples
| Persona | Onboarding Steps |
|---|---|
| Backend Intern (Node.js) | Set up Node environment → Clone repository → Run local server → Review backend architecture doc → Read API standards → Complete starter bug fix |
| Frontend Senior (React) | Review frontend architecture → Access design system → Understand deployment pipeline → Review PR guidelines |
Bonus (Optional)
- Provision or request access for GitHub, Slack, and Jira
- Send an automated Slack welcome message
- Assign Jira or GitHub starter tickets
- Automatically verify local environment setup
- Track checklist completion dynamically within the chat
- Update the internal knowledge base with new FAQs generated during onboarding
- Ingest PDFs instead of Markdowns in the vectorDB to align more with practical use
- Use Model Context Protocol (MCP) style architecture for modular design
Evaluation Criteria
| Criteria | Weight |
|---|---|
| Agent Intelligence – Personalization quality, logical onboarding sequencing, context awareness | 30% |
| Knowledge Retrieval Quality – Accurate document referencing, minimal hallucination | 20% |
| System Architecture – Modular design, agent workflow clarity, scalability | 20% |
| Completion Reporting – Professional HR email, structured reporting | 10% |
| Innovation – Novel interaction design, adaptive learning behavior | 10% |
| Bonus Integrations – GitHub / Slack / Jira automation, MCP usage | 10% |
Deliverables
- Working prototype
- 5–7 minute demo video
- Architecture diagram
- Presentation (max 10 slides)
- Sample onboarding walkthrough (Intern → Completed → HR email)
Provided Dataset / Resources
PS03`
What's inside
8 sections: background, problem, objective, features, constraints, workflows, evaluation criteria, deliverables.
Change this for your project
- Replace
PS03with your own dataset or knowledge base reference - Replace
monica-mewani/NovaBytewith your own repository name - Replace example persona
Backend Intern (Node.js)with your own roles and stacks
Where it goes
Save as AGENTS.md in your repository root. Read by Codex, Cursor and other agents that follow the AGENTS.md convention.
Worth borrowing
- Persona-based onboarding flow table mapping role to steps
- Weighted evaluation criteria table for judging agent quality
- Structured HR completion email specification with required fields
Related Documents
Browser-only development
Guides AI assistants on an Electron + React + TypeScript desktop app for browsing and organizing AI-generated images locally.
Claude Agents — Reference & Recommendations
Catalogues 40+ Claude agents and marketing skills for building a cat adoption charity landing page, with a ready-to-paste prompt and backend API reference.
Golden DKG Prototype -- Master Plan
Defines an 8-phase implementation plan for a Rust prototype of the Golden non-interactive DKG protocol using BLS12-381 and tokio.
Swarms Examples Index
Lists 60+ example scripts for building single and multi-agent systems with the Swarms framework, organized by category and use case.