---
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 |
|-----------|----------|-------|
| **S**ituation | "What was the context?" | Set the scene, explain the problem |
| **T**ask | "What were YOU responsible for?" | YOUR specific role and responsibility |
| **A**ction | "What did YOU do?" | Specific technical actions YOU took |
| **R**esult | "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

- [ ] Uses "I" not "we" (shows ownership)
- [ ] Includes specific technologies
- [ ] Demonstrates problem-solving
- [ ] Shows technical depth
- [ ] Has measurable result if possible
- [ ] Is 2-3 minutes when spoken
- [ ] Answers the implied "why hire you?"

---

## Story Template

```markdown
# 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:

1. **Finding the story:** "What was the hardest part of this feature?"
2. **Adding depth:** "Walk me through your debugging process when X happened."
3. **Showing ownership:** "What decision did YOU make that shaped this?"
4. **Quantifying results:** "How would you measure the impact of this work?"
5. **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`