Summary
Extract shared story quality conventions into a standalone story-quality.instructions.md that both the Agile Coach agent and ADO sprint planning (gap analysis work item generation) can reference when creating or evaluating work items.
Currently, story quality patterns are distributed across three files:
- Agile Coach (
agile-coach.agent.md) — title patterns, acceptance criteria format, Definition of Done notes, open questions template
- ADO Interaction Templates (
ado-interaction-templates.instructions.md) — work item description templates with acceptance criteria formatting
- Product Manager Advisor (
product-manager-advisor.agent.md) — story quality assurance checklist (scope, sizing, evidence source, completeness dimensions)
These patterns overlap but are not consistent. A shared instructions file would establish a single source of truth for story quality conventions referenceable by any agent that creates or evaluates work items.
Part of #774. Follow-up from review comment.
Changes
New Files
.github/instructions/shared/story-quality.instructions.md
- Title conventions (action-oriented, verb-first, concise)
- Description format guidance (who, what, why, evidence source)
- Acceptance criteria quality rules (binary, testable, checklist-style, 5-10 items typical)
- Definition of Done checklist conventions (tests, docs, observability, migration)
- Scope and sizing guidance (single concern, one-week boundary, explicit exclusions)
- Open questions / risks / dependencies section conventions
Modified Files
.github/agents/project-planning/agile-coach.agent.md — reference shared conventions via #file: instead of inline definitions
.github/instructions/ado/ado-backlog-sprint.instructions.md — reference shared conventions for gap analysis work item generation
collections/project-planning.collection.yml — add story-quality.instructions.md entry
Acceptance Criteria
Summary
Extract shared story quality conventions into a standalone
story-quality.instructions.mdthat both the Agile Coach agent and ADO sprint planning (gap analysis work item generation) can reference when creating or evaluating work items.Currently, story quality patterns are distributed across three files:
agile-coach.agent.md) — title patterns, acceptance criteria format, Definition of Done notes, open questions templateado-interaction-templates.instructions.md) — work item description templates with acceptance criteria formattingproduct-manager-advisor.agent.md) — story quality assurance checklist (scope, sizing, evidence source, completeness dimensions)These patterns overlap but are not consistent. A shared instructions file would establish a single source of truth for story quality conventions referenceable by any agent that creates or evaluates work items.
Part of #774. Follow-up from review comment.
Changes
New Files
.github/instructions/shared/story-quality.instructions.mdModified Files
.github/agents/project-planning/agile-coach.agent.md— reference shared conventions via#file:instead of inline definitions.github/instructions/ado/ado-backlog-sprint.instructions.md— reference shared conventions for gap analysis work item generationcollections/project-planning.collection.yml— addstory-quality.instructions.mdentryAcceptance Criteria
story-quality.instructions.mdcreated with conventions extracted from Agile Coach, Interaction Templates, and Product Manager Advisor