OnboardHero

\documentclass[11pt,a4paper]{article}

% Packages \usepackage[utf8]{inputenc} \usepackage[margin=1in]{geometry} \usepackage{hyperref} \usepackage{xcolor} \usepackage{titlesec} \usepackage{enumitem} \usepackage{tikz} \usetikzlibrary{shapes.geometric, arrows.meta, positioning, calc}

% Color Definitions \definecolor{primarycolor}{RGB}{30, 58, 138} % Dark Blue \definecolor{secondarycolor}{RGB}{15, 118, 110} % Teal \definecolor{lightgrey}{RGB}{245, 247, 250}

% Hyperlink Setup \hypersetup{ colorlinks=true, linkcolor=primarycolor, urlcolor=secondarycolor }

% Section Styling \titleformat{\section} {\color{primarycolor}\normalfont\Large\bfseries} {\thesection}{1em}{} \titleformat{\subsection} {\color{secondarycolor}\normalfont\large\bfseries} {\thesubsection}{1em}{}

\setlength{\parskip}{0.5em} \setlength{\parindent}{0pt}

\begin{document}

% Header / Title Section \begin{center} {\huge \bfseries \color{primarycolor} OnboardHero} \[0.5em] {\large \bfseries \color{secondarycolor} Adaptive Employee Onboarding & Knowledge Transfer Agent} \[0.3em] \rule{\textwidth}{1pt} \end{center}

\section{Concept Overview} Onboarding a new employee or handing over codebases/projects involves constant repetitive micro-tasks: answering the same 20 setup questions, guiding developers through environment setup, generating localized documentation, and verifying tool access.

\textbf{OnboardHero} uses the \textbf{Strands Agents SDK} to create an interactive, multi-agent assistant that turns static wiki pages and internal codebases into active, step-by-step interactive onboarding workflows. Instead of dumping links on a new hire, the agent walks them through setup, executes verification scripts, tests their environment, and escalates to a human mentor only when stuck.

\section{Key Capabilities Leveraged from Strands Agents SDK}

\begin{itemize}[leftmargin=*] \item \textbf{Agent-to-Agent (A2A) Orchestration:} \begin{itemize} \item \textbf{Architect Agent:} Reads company repositories/Confluence docs and constructs a custom setup checklist based on the user's role (e.g., Frontend vs. Backend). \item \textbf{Terminal/Environment Agent:} Runs safe diagnostic tools locally to verify software dependencies (e.g., checking Node versions, Docker status, environment variables). \item \textbf{Buddy/Triage Agent:} Answers daily FAQ questions using RAG and routes unresolved issues to team mentors. \end{itemize}

\item \textbf{Model Context Protocol (MCP) Integration:} Connects via MCP to local File Systems, GitHub/GitLab, Slack/Teams, and Notion/Confluence to fetch real-time context.

\item \textbf{Strands Hook System for Safety:} Restricts the Terminal Sub-agent from running destructive bash commands by intercepting tool calls with an interactive approval prompt.

\item \textbf{Structured Output Schemas:} Enforces standard JSON structures for generating onboarding step status, progress tracking, and daily summaries for engineering managers.

\end{itemize}

\section{Workflow Architecture}

\begin{center} \begin{tikzpicture}[ node distance=1.2cm and 1.0cm, font=\sffamily\small, box/.style={draw=primarycolor, fill=lightgrey, rounded corners=3pt, align=center, thick, inner sep=6pt}, arrow/.style={-Stealth, thick, draw=secondarycolor} ]

% Nodes
\node [box] (query) {\textbf{New Hire / User Query}};
\node [box, below=of query] (triage) {\textbf{Triage Buddy Agent}};

\node [box, below left=of triage, xshift=-0.5cm] (architect) {\textbf{Architect Agent}\\ \footnotesize (Reads Code/Docs via MCP)};
\node [box, below right=of triage, xshift=0.5cm] (env) {\textbf{Environment Agent}\\ \footnotesize (Runs Local Check via Tools)};

\node [box, below right=of architect, xshift=0.5cm, yshift=-0.3cm] (hook) {\textbf{Strands Safety Hook}\\ \footnotesize (Approve Tool Call)};
\node [box, below=of hook] (action) {\textbf{Action / UI Update}};

% Arrows
\draw [arrow] (query) -- (triage);
\draw [arrow] (triage) -| (architect);
\draw [arrow] (triage) -| (env);
\draw [arrow] (architect) |- (hook);
\draw [arrow] (env) |- (hook);
\draw [arrow] (hook) -- (action);

\end{tikzpicture} \end{center}

\section{Step-by-Step Hackathon Build Plan}

\begin{enumerate}[leftmargin=*] \item \textbf{Initialize Strands Agents:} Create a multi-agent system in Python/TypeScript with specialized roles: \begin{itemize} \item \texttt{TriageAgent} (main entry point & RAG Q&A) \item \texttt{SetupAgent} (step-by-step checklist generator) \item \texttt{DiagnosticAgent} (system verifier tool caller) \end{itemize}

\item \textbf{Build Custom Tools (\texttt{@tool}):}
\begin{itemize}
    \item \texttt{check\_env\_variable(var\_name)}: Checks local environment status.
    \item \texttt{run\_diagnostic\_script(command)}: Runs safe local shell checks (e.g., \texttt{docker ps}, \texttt{git status}).
    \item \texttt{ping\_mentor(slack\_channel, question)}: Triggers a message if the user is blocked for more than 2 attempts.
\end{itemize}

\item \textbf{Integrate MCP Servers:}
Connect Strands' \texttt{MCPClient} to a local Git repository server or Notion API to query live setup instructions.

\item \textbf{Add Safety Intercepts:}
Use Strands Hooks on \texttt{run\_diagnostic\_script} to ensure commands like \texttt{rm -rf} or arbitrary web requests are automatically blocked.

\item \textbf{Demo Interface:}
Create a clean CLI or web UI (Streamlit/Next.js) displaying:
\begin{itemize}
    \item Live agent-to-agent message passing.
    \item Visual progress bar of onboarding steps.
    \item Interactive ``Approve Command'' popups when the environment agent checks system state.
\end{itemize}

\end{enumerate}

\end{document}