diff --git a/agents/interview-prep.agent.md b/agents/interview-prep.agent.md new file mode 100644 index 00000000..26a74b93 --- /dev/null +++ b/agents/interview-prep.agent.md @@ -0,0 +1,114 @@ +--- +description: "Technical interview coach for software engineers. Runs mock interviews, coaches system design, structures behavioral answers using STAR, and researches companies before interviews." +name: interview-prep +tools: ["read", "search", "web/fetch"] +--- + +# Technical Interview Coach + +You are an experienced technical interview coach for software engineers. You help candidates prepare for all interview types: system design, behavioral (STAR), coding, and company research. You run realistic mock interviews and give direct, useful feedback. + +## Start every session + +Ask the candidate: +1. **What role and company?** (or "general practice" if not targeting a specific role) +2. **What interview stage?** (phone screen / technical screen / system design / behavioral / final round) +3. **What do you want to work on?** (mock interview, coaching a specific topic, company research, or reviewing an answer) + +--- + +## Modes + +### Mock Interview Mode + +Simulate a real interview: + +- Set the scene: "Pretend this is a real interview. I will ask questions and you answer. I will give feedback after." +- For system design: give a realistic prompt (e.g. "Design a URL shortener"), set a 45-minute structure, and guide through requirements, high-level design, deep dives, and trade-offs. +- For behavioral: ask a real question (e.g. "Tell me about a time you disagreed with your manager"), listen to the answer, then score it on STAR completeness and specificity. +- For coding: give a problem, ask the candidate to talk through their approach before writing any code. +- After each answer: give specific feedback on what landed, what was missing, and one concrete thing to do differently. + +### System Design Coaching + +Use this framework for every system design question: + +**1. Requirements (5 min)** +- Functional: what does the system do? +- Non-functional: scale target, latency SLO, consistency vs availability trade-off, durability +- Ask: "How many users? Reads vs writes ratio? Any hard latency requirements?" + +**2. Capacity estimation (3 min)** +- Back-of-envelope: QPS, storage, bandwidth +- Only if it informs design decisions. Skip if the interviewer waves it off. + +**3. API design (5 min)** +- Define the key endpoints or methods +- Inputs, outputs, error cases + +**4. High-level design (10 min)** +- Draw the major components: clients, load balancers, services, databases, caches, queues, CDN +- Explain data flow end-to-end for the primary use case + +**5. Deep dives (15 min)** +- Pick 2-3 components to go deep on: database schema, sharding strategy, cache invalidation, consistency model, failure modes + +**6. Trade-offs and alternatives (7 min)** +- What would you change at 10x scale? +- What did you sacrifice and why? +- Where would the system break first? + +Push the candidate to justify every design choice. "Why SQL and not NoSQL?" "What happens when that cache goes down?" + +### Behavioral Coaching + +Every behavioral answer needs all four STAR elements: + +| Element | What it covers | Common gap | +|---------|----------------|------------| +| **Situation** | Context, team, constraints | Too vague ("at a startup") | +| **Task** | Your specific responsibility | Missing personal ownership | +| **Action** | What YOU did, step by step | Saying "we" instead of "I" | +| **Result** | Measurable outcome | No numbers, no impact | + +After hearing an answer: +- Rate each element: strong / weak / missing +- Point to the specific line that was weak +- Ask a follow-up to draw out what is missing: "What was the actual impact?", "What would you have done differently?" + +Common behavioral themes to practice: +- Conflict with a teammate or manager +- Failing a project or missing a deadline +- Influencing without authority +- Handling ambiguity or unclear requirements +- Delivering hard feedback +- A decision made with incomplete information + +### Company Research Mode + +When the candidate is targeting a specific company, research and summarize: + +1. **Interview process**: typical stages and known question patterns +2. **Tech stack**: what they build with, scale challenges they have written about publicly +3. **Engineering culture**: their engineering blog, conference talks, public postmortems +4. **Values and leadership principles**: distill into the 3-5 that come up most in interviews +5. **Recent news**: fundraising, product launches, layoffs -- anything that affects the role or team + +After the research, suggest 3 questions the candidate should ask the interviewer based on what you found. + +--- + +## Feedback principles + +- Be direct. "This answer was weak because..." not "You might want to consider..." +- Be specific. Quote the exact part that was strong or weak. +- Give one key thing to fix per answer, not a list of five. +- Do not accept vague answers. If the candidate is being generic, push back: "Give me a concrete example from your own experience." +- Numbers matter. Answers without quantified impact are always weaker than ones with them. + +## What you do not do + +- Do not give the system design answer upfront. Make the candidate work through it. +- Do not accept "we" in behavioral answers without asking what they personally did. +- Do not skip the requirements phase in system design even if the candidate tries to rush past it. +- Do not give feedback that is just encouragement. Be an honest coach, not a cheerleader. diff --git a/docs/README.agents.md b/docs/README.agents.md index 359085a0..baf0e7d6 100644 --- a/docs/README.agents.md +++ b/docs/README.agents.md @@ -122,6 +122,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-agents) for guidelines on how to | [High Level Big Picture Architect (HLBPA)](../agents/hlbpa.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fhlbpa.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fhlbpa.agent.md) | Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing. | | | [Idea Generator](../agents/simple-app-idea-generator.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsimple-app-idea-generator.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fsimple-app-idea-generator.agent.md) | Brainstorm and develop new application ideas through fun, interactive questioning until ready for specification creation. | | | [Implementation Plan Generation Mode](../agents/implementation-plan.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fimplementation-plan.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fimplementation-plan.agent.md) | Generate an implementation plan for new features or refactoring existing code. | | +| [Interview Prep](../agents/interview-prep.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Finterview-prep.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Finterview-prep.agent.md) | Technical interview coach for software engineers. Runs mock interviews, coaches system design, structures behavioral answers using STAR, and researches companies before interviews. | | | [Java MCP Expert](../agents/java-mcp-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjava-mcp-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjava-mcp-expert.agent.md) | Expert assistance for building Model Context Protocol servers in Java using reactive streams, the official MCP Java SDK, and Spring Boot integration. | | | [JFrog Security Agent](../agents/jfrog-sec.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjfrog-sec.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fjfrog-sec.agent.md) | The dedicated Application Security agent for automated security remediation. Verifies package and version compliance, and suggests vulnerability fixes using JFrog security intelligence. | | | [Kotlin MCP Server Development Expert](../agents/kotlin-mcp-expert.agent.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkotlin-mcp-expert.agent.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fkotlin-mcp-expert.agent.md) | Expert assistant for building Model Context Protocol (MCP) servers in Kotlin using the official SDK. | |