Skip to content

Add personas to the specification template #684

@DiegoObethBatista

Description

@DiegoObethBatista

Why Personas: They make specs concrete by tying every feature to real roles and permissions. Without them, security gets fuzzy and tests drift into abstract “user does X” cases.

Why?

  • Security: who can view, edit, approve, delete. No generic “user” role.
  • Functionality: every feature must tie to someone real. If it doesn’t serve a persona, it’s probably scope creep.
  • Testing: scenarios become real-world examples, so TDD isn’t just “a user does X” but “a Case Worker updates a case but cannot approved
  • Conflicts: if roles need different outcomes, we see it early.

How to fit them in:

  • Add a short Personas section: role, goal, context, constraints, permissions.
  • Tag each requirement with one or more personas. Example: FR-003 [Case Worker, Ops Manager].
  • Write at least one scenario per persona (normal path + exception).
  • Add a simple table to check coverage. If a requirement serves nobody, cut it.

Metadata

Metadata

Assignees

Labels

enhancementtemplatesRelated to template definition and not the CLI.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions