Engineering Handoff

AI-Powered Employee Onboarding Assistant — traced to PRD v1.0

Feature list

From PRD requirements
  • FR-01

    Onboarding home with progress

    Onboarding home with progress.

    Dependency: None — foundational

    High
  • FR-02

    AI assistant answering only from approved sources

    AI assistant answering only from approved sources.

    Dependency: None — foundational

    High
  • FR-03

    Source citation on every answer

    Source citation on every answer.

    Dependency: Depends on FR-01

    Medium
  • FR-04

    Escalate to HR when confidence is low

    Escalate to HR when confidence is low.

    Dependency: Depends on FR-01

    Medium
  • FR-05

    HR knowledge coverage and gap analytics

    HR knowledge coverage and gap analytics.

    Dependency: Depends on FR-01

    Low

Technical requirements

3 decisions required

  • API

    Question submission and answer retrieval endpoints (PRD FR-03).

  • Data

    Approved knowledge documents with last-updated timestamps (PRD FR-02).

  • Data modelNeeds review

    Storage and chunking strategy for documents.

  • AuthenticationNeeds review

    Employee vs HR Admin roles are named in the PRD; provider is not.

  • IntegrationNeeds review

    HR escalation must reach the HR queue (PRD FR-05); target system unspecified.

  • AI / LLM

    Answers must cite an approved source and refuse when confidence is low.

  • Analytics

    Instrument 5 PRD-defined events.

  • Permissions

    Only HR Admins may approve or retire knowledge sources.

User stories

With acceptance criteria
US-01High

As a new employee, I want to ask an onboarding question and get a cited answer so that I can act without waiting on HR.

  • Behaviour matches the PRD requirement it traces to
  • Empty and error states are handled
  • Analytics event fires with the documented properties
US-02Medium

As a new employee, I want to reach a human when the assistant cannot answer so that I am never stuck.

  • Behaviour matches the PRD requirement it traces to
  • Empty and error states are handled
  • Analytics event fires with the documented properties
US-03Medium

As an HR specialist, I want to see which questions the assistant cannot answer so that I can close knowledge gaps.

  • Behaviour matches the PRD requirement it traces to
  • Empty and error states are handled
  • Analytics event fires with the documented properties

Analytics events

Instrumentation contract

  • ai_question_submitted

    Properties: user_id, question_category, source_count

  • ai_answer_displayed

    Properties: response_type, source_available, confidence

  • hr_escalation_created

    Properties: reason, category

  • onboarding_task_completed

    Properties: task_id, days_since_start

Risks & mitigations

  • AI answers from an outdated document

    Impact: Employees act on wrong policy information

    Mitigation: Expire sources past a review date and hide them from retrieval

    Owner: Engineering

  • Escalation queue has no owner

    Impact: Employee questions go unanswered

    Mitigation: Define HR routing rules before launch

    Owner: HR Ops

  • Unclear data residency for HR documents

    Impact: Compliance blocker at review

    Mitigation: Engineering decision required

    Owner: Engineering

Information required before build

  • PRD section "Acceptance Criteria" is empty — required before generation.
  • Unresolved gap: Problem Evidence — You cited qualitative sources, but no numbers yet. Add frequency or cost so severity is arguable with data.
  • Unresolved gap: Success Metrics — Define measurable outcomes that indicate whether the product solves the problem.
  • Unresolved gap: Non-Goals — Clarify what this product will explicitly NOT solve.
Resolve in Gap Analysis