Skip to content

Add optional in-app persona review for generated documents #60

Description

@warnes

Summary

Add an optional runtime workflow step that lets the application invoke persona-based review of generated resume and related document outputs and return structured feedback to the user.

This is an in-app feature request, separate from the development-only fixture-based review workflow.

Problem

The application can generate final resume artifacts and can generate related documents such as cover letters, but it does not currently offer an integrated step where persona reviewers inspect the generated documents and provide structured feedback inside the workflow.

That leaves a gap between successful file generation and user-facing confidence about presentation quality.

Scope

In scope:

  • Add an optional post-generation review step in the application workflow.
  • Allow selected personas to review generated document outputs.
  • Return structured, user-visible findings and recommendations.
  • Keep the review clearly scoped to generated-document qualities such as appearance, layout, structure, readability, ATS presentation, and submission readiness.

Out of scope:

  • Replacing the existing content-customization, rewrite-review, or spell-check stages.
  • Unreviewed automatic edits to generated files.
  • Writing changes back to master CV data outside approved master-data or harvest flows.

Proposed Direction

  • Expose a review action after preview/final generation or in the final File Review stage.
  • Pass the generated artifact set, or normalized renderings of it, to selected personas.
  • Return results in a structured schema such as severity, persona, finding, rationale, and recommended next action.
  • Let the user decide whether to ignore feedback, request another generation pass, or re-enter the appropriate review stage.

Acceptance Criteria

  • Users can trigger persona review after generated files exist for the current session.
  • The workflow supports at least a small initial persona set relevant to document review, such as graphical designer, hiring manager, and HR/ATS.
  • Persona feedback is displayed separately from normal generation success status.
  • Findings are structured enough to drive follow-up actions, for example layout refinement or regeneration.
  • The feature does not silently modify generated artifacts without user approval.
  • Session state persists persona review results for the current workflow.

Notes

This issue is intentionally distinct from the development-only task of generating fixture-based outputs and running persona review as a QA workflow. This issue is about adding a user-facing application capability.

Metadata

Metadata

Assignees

No one assigned

    Labels

    backlogFuture work backlogenhancementNew feature or request

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions