| name | star-story-extraction |
| description | Auto-invoke after task completion to extract interview-ready STAR stories from completed work. |
STAR Story Extraction
"Every feature you build is an interview answer waiting to be told."
Purpose
Transform completed work into compelling interview stories using the STAR method. These stories demonstrate real problem-solving ability.
The STAR Method
| Component | Question | Focus |
|---|
| Situation | "What was the context?" | Set the scene, explain the problem |
| Task | "What were YOU responsible for?" | YOUR specific role and responsibility |
| Action | "What did YOU do?" | Specific technical actions YOU took |
| Result | "What was the outcome?" | Impact, metrics, improvements |
Extraction Flow
Step 1: Identify the Story Type
What kind of problem did you solve?
| Story Type | Good For Questions Like |
|---|
| Technical challenge | "Tell me about a difficult bug you solved" |
| Feature implementation | "Describe a feature you're proud of" |
| Performance optimization | "How did you improve system performance?" |
| Security fix | "Tell me about a security issue you addressed" |
| Refactoring | "Describe a time you improved code quality" |
| Learning curve | "Tell me about a time you learned something quickly" |
Step 2: Guide Through STAR
Situation (2-3 sentences)
"What was the context? What problem or challenge existed before you started?"
Good elements:
- Business context (why it mattered)
- Technical constraints
- Scale/impact of the problem
Avoid:
- Too much background
- Irrelevant details
- Blaming others
Task (1-2 sentences)
"What were YOU specifically responsible for? What was your role?"
Good elements:
- Clear ownership
- Specific scope
- Why you were the one to do it
Avoid:
- "We did this" (use "I")
- Vague responsibilities
Action (The meat - 3-5 sentences)
"Walk me through the specific steps YOU took. Be technical."
Good elements:
- Specific technologies used
- Problem-solving approach
- Trade-offs considered
- Technical decisions made
Avoid:
- Glossing over the how
- Buzzword soup
- "I just implemented it"
Result (1-2 sentences)
"What was the outcome? Can you quantify the impact?"
Good elements:
- Metrics where possible (50% faster, 0 bugs in production)
- Business impact
- What you learned
Avoid:
- "It worked" (too vague)
- No mention of impact
Story Quality Checklist
Story Template
# STAR Story: [Feature/Problem Name]
**Date:** [When completed]
**Type:** [Technical Challenge / Feature / Performance / Security / Refactor]
## Situation
[The context. What problem existed? Why did it matter?]
## Task
[YOUR specific responsibility. What were YOU asked to do?]
## Action
[The specific steps YOU took. Be technical. Show your thought process.]
## Result
[The outcome. Metrics if possible. What impact did it have?]
---
## Interview Variations
This story can answer:
- "Tell me about a time you [X]"
- "Describe a challenging [Y] you worked on"
- "How did you approach [Z]?"
## Key Technical Points to Mention
- [Technology/pattern 1]
- [Technology/pattern 2]
- [Decision/trade-off made]
Example: Good vs Bad STAR
Bad Story
"I built a login form. It had validation. It worked."
Problems: No context, no challenge, no depth, no impact.
Good Story
Situation: Our SaaS application was experiencing a 40% drop-off during signup because the existing form had poor UX and no real-time validation, frustrating users.
Task: I was responsible for rebuilding the entire authentication flow, focusing on reducing friction while maintaining security.
Action: I implemented a multi-step form with real-time validation using React Hook Form for performance. I added JWT authentication with secure refresh token rotation to handle long sessions. The key challenge was balancing security (short token expiry) with UX (no jarring logouts), which I solved by implementing silent refresh 5 minutes before expiry.
Result: Sign-up completion improved by 35%, and we've had zero authentication-related security incidents since launch. The pattern I built is now used across our other products.
Socratic Story Questions
Guide the junior with these:
- Finding the story: "What was the hardest part of this feature?"
- Adding depth: "Walk me through your debugging process when X happened."
- Showing ownership: "What decision did YOU make that shaped this?"
- Quantifying results: "How would you measure the impact of this work?"
- Interview connection: "If an interviewer asked about [topic], how would this story fit?"
Common Story Mistakes
| Mistake | Fix |
|---|
| "We built..." | Use "I implemented..." |
| Too long (10+ minutes) | Cut to 2-3 minutes |
| No technical depth | Add specific technologies and decisions |
| No result | Always end with impact |
| Only happy path | Include challenges overcome |
Save Location
Stories are saved to:
mentorspec/career/stories/[date]-[feature-name].md
Example: mentorspec/career/stories/2026-01-15-jwt-auth.md
