Jira-Ready User Stories · Concept / Not Affiliated with Impacter Pathway
Proactive Teacher Alerts
Approved for development. User stories below are structured for direct
import/entry into Jira — epic, story, priority, story points, acceptance criteria, and
labels included for each. Click any story text to edit it, or add a new
blank story at the bottom of the page.
Note: edits made here stay in this browser tab only and aren't saved back to the file. Copy anything worth keeping into the .html source or your Jira instance.
🔌
Workflow idea · Jira MCP
These stories were drafted here for review, but ideally this step wouldn't require
a manual copy/paste into Jira at all. With a Jira MCP server connected
to Kiro, these stories — epic, priority, points, acceptance criteria, and labels —
could be created directly in Jira from this same session, once the format is approved.
That's the kind of process-efficiency gain worth exploring on day one: agentic AI tools
doing the mechanical hand-off work, so PM time goes into the judgment calls (scope,
priority, risk) instead of data entry.
Epic: IP-TA11 stories3 story groups + settingsStatus: Approved
Epic · IP-TA
Proactive Teacher Alerts
Surface students whose scored evidence shows a meaningful change — without
requiring a teacher to browse a dashboard — and give them a clear, evidence-backed
next step, with full control over sensitivity and scope. See
problem-brief-teacher-alerts.html for full context and risk analysis.
Key
Story
Priority
Points
IP-TA-1
See a prioritized list of students needing attention
P1
5
IP-TA-2
See summary counts across alert states
P2
2
IP-TA-3
See weekly resolution KPI
P2
3
IP-TA-4
See students who improved since last week
P2
3
IP-TA-5
View the specific evidence behind an alert
P1
5
IP-TA-6
See an AI-suggested next step tied to the evidence
P1
8
IP-TA-7
See a student's other skill scores from the same response
P3
2
IP-TA-8
Mark an alert as addressed
P1
3
IP-TA-9
Add a private note to a student's alert record
P2
3
IP-TA-10
Control what triggers an alert
P1
5
IP-TA-11
Choose which skills generate alerts
P2
3
1
Alert Feed
Notice what needs attention without browsing
IP-TA-1 · Story
See a prioritized list of students needing attention
P15 pts
Click the story below to edit it
As a classroom teacher, I want to see a list of students whose recent responses show a meaningful change in a durable skill, so that I don't have to remember to check each student's dashboard individually.
Acceptance Criteria
✓Alert feed loads on app open and shows students sorted by urgency (Needs Review, then Watching).
✓Each alert card shows student name, flagged skill, a short evidence snippet, and time since flagged.
✓Feed updates when a new qualifying response is scored, without requiring a manual refresh.
✓Empty state is shown clearly when no students are currently flagged.
teacher-facingcore-loopmobile + web
IP-TA-2 · Story
See summary counts across alert states
P22 pts
As a classroom teacher, I want to see at-a-glance counts of students needing review, being watched, and on track, so that I can gauge overall class status before diving into individual alerts.
Acceptance Criteria
✓Three summary counts are shown at the top of the alert feed: Needs Review, Watching, On Track.
✓Counts update in real time as alerts are created, resolved, or dismissed.
✓Tapping a count filters the feed to that state.
teacher-facingnice-to-have
IP-TA-3 · Story
See weekly resolution KPI
P23 pts
As a classroom teacher, I want to see how many students moved off the watch list this week, so that I have a sense of whether interventions are working, not just a growing list of problems.
Acceptance Criteria
✓A KPI banner shows count of students resolved this week vs. last week's flagged total.
✓Calculation is based on rolling 7-day windows, refreshed daily.
✓KPI banner is hidden (not shown as "0") if there is insufficient history to calculate a comparison.
teacher-facingengagement
IP-TA-4 · Story
See students who improved since last week
P23 pts
As a classroom teacher, I want to see a distinct "improved" section showing which flagged students have since resolved, so that I get positive reinforcement for the platform, not just a stream of new problems.
Acceptance Criteria
✓An "Improved since last week" section appears above the active alert list when at least one resolution exists.
✓Each resolved card shows the skill, the score movement (e.g. L2 → L4), and the evidence that closed it out.
✓Resolved cards are visually distinct (success styling) from active red/amber alerts.
teacher-facingtrust & retention
2
Student Detail & Evidence
Understand why, before deciding what to do
IP-TA-5 · Story
View the specific evidence behind an alert
P15 pts
As a classroom teacher, I want to see the exact phrase, rubric level, and response timestamp behind a flagged skill, so that I trust the alert is grounded in real evidence, not an opaque score.
Acceptance Criteria
✓Detail view shows the flagged skill name, current rubric level, and trend vs. prior responses.
✓The exact quoted phrase that triggered the flag is shown verbatim, with response date and audio timestamp.
✓If the flag is based on absence of signal (not a low score), the UI clearly distinguishes "no evidence detected" from "scored low."
teacher-facingtrust & transparencycore-loop
IP-TA-6 · Story
See an AI-suggested next step tied to the evidence
P18 pts
As a classroom teacher, I want a concrete suggested next step generated from the flagged evidence, so that I'm not left with a flag and no idea what to actually do.
Acceptance Criteria
✓Suggested next step is broken into 2-4 concrete, sequenced actions, not a single vague sentence.
✓Suggestion language is reviewed against a "decision support, not diagnosis" content standard before release (legal/psychometrics sign-off required).
✓Suggestion references the specific evidence/language pattern detected, not generic skill-development advice.
✓If a Skill Coaching Library entry exists for this skill/level (future dependency), link to it instead of generating free-form AI text.
See a student's other skill scores from the same response
P32 pts
As a classroom teacher, I want to see the other skill scores from the same response that triggered an alert, so that I get a fuller picture of the student, not just the one flagged skill.
Acceptance Criteria
✓Detail view shows up to 3 other skill scores from the same response, with score value.
✓Tapping another skill navigates to that skill's own detail context.
teacher-facingnice-to-have
3
Closing the Loop
Act, and let the system learn whether it worked
IP-TA-8 · Story
Mark an alert as addressed
P13 pts
As a classroom teacher, I want to mark an alert as addressed, so that it stops showing as active and the system knows to re-check the student later rather than re-flag immediately.
Acceptance Criteria
✓"Mark addressed" action moves the alert out of the active feed and starts a re-check window (default 2 weeks, configurable — see IP-TA-10).
✓A confirmation toast appears summarizing the action taken.
✓If the same skill re-flags after the re-check window, the alert references the prior addressed date/outcome.
teacher-facingcore-loop
IP-TA-9 · Story
Add a private note to a student's alert record
P23 pts
As a classroom teacher, I want to add a private note when I address an alert, so that I have context for myself (or a counselor) if the pattern comes up again.
Acceptance Criteria
✓Note field accepts free text, is timestamped, and is attached to the specific alert/response, not just the student generally.
✓Notes are visible only to the teacher who wrote them and, if configured, school counselors/admins with permission.
✓Notes are included in data export/retention policy review (student record implications).
teacher-facingprivacy review needed
4
Trust & Control
Keep this decision-support, not a black box
IP-TA-10 · Story
Control what triggers an alert
P15 pts
As a teacher or admin, I want to control the sensitivity and specific conditions that generate an alert, so that I'm not overwhelmed by noise or missing signal because a default doesn't fit my classroom.
Acceptance Criteria
✓A sensitivity control (Fewer / Balanced / More alerts) adjusts thresholds across all trigger types at once.
✓Individual triggers (score drop, sustained decline, no evidence detected, named-adult mention drop) can be toggled independently.
✓Default settings ship as "Balanced" and are documented for district admin review before rollout.
✓Threshold defaults are defined jointly with the data/psychometrics team, not set unilaterally by product/engineering.
As a teacher or admin, I want to choose which of the 8 durable skills actively generate alerts, so that I can focus attention on what matters most for my class or program without noise from skills I'm not prioritizing.
Acceptance Criteria
✓All 8 skills are selectable/deselectable independently for alerting purposes.
✓Deselecting a skill for alerts does not affect underlying scoring or dashboard visibility — it only suppresses alert generation.
✓Setting is scoped per teacher by default, with an option for admin-level defaults across a school/district (future consideration, not required for v1).