issue-purpose-alignment

Validate issue purpose against arc42 goals and quality attributes.

Updated Jan 5, 2025
One-click install
npx skills add https://github.com/pkuppens/pkuppens --skill issue-purpose-alignment
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: issue-purpose-alignment
Source: https://github.com/pkuppens/pkuppens/tree/main/skills/issue-workflow/issue-purpose-alignment
Command: npx skills add https://github.com/pkuppens/pkuppens --skill issue-purpose-alignment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps ensure that an issue's purpose stays aligned with project goals and quality attributes, preventing drift during idea clarification and refinement.

Core Features & Use Cases

  • Validate issue purpose against defined goals and quality attributes (arc42 §1, §10).
  • Surface misalignment and recommend narrowing scope or splitting into follow-up issues.
  • Support governance workflows by guiding teams to maintain alignment throughout the issue lifecycle.

Quick Start

Draft your issue and run this skill to verify alignment with project goals.

Frequently Asked Questions about issue-purpose-alignment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if an issue aligns with project goals and quality attributes?▼

To check issue alignment, validate the issue purpose against defined arc42 goals and quality attributes. This process detects scope drift during idea clarification and refinement, recommending narrowing scope or splitting follow-ups to maintain project governance.

What is issue purpose alignment in software governance?▼

Issue purpose alignment is the validation of an issue purpose against project goals and quality attributes. It prevents scope drift during refinement by surfacing misalignments early and recommending actionable narrowing or splitting of follow-up issues.

When should I validate issue alignment during the issue lifecycle?▼

Validate issue alignment during idea clarification and issue refinement stages. Running alignment checks at these early phases detects drift relative to arc42 goals and quality criteria before development begins, ensuring governance throughout the lifecycle.

Can I use arc42 quality attributes to detect issue scope drift?▼

Yes, you can use arc42 quality attributes to detect issue scope drift. Validating an issue purpose against arc42 section 1 and section 10 criteria surfaces misalignments and recommends narrowing scope or splitting into follow-up issues for alignment.

What's the best way to handle misaligned issues in project governance?▼

The best way to handle misaligned issues is to validate the issue purpose against project goals and quality attributes, then apply actionable recommendations like narrowing the scope or splitting the issue into focused follow-ups to restore alignment.

Do I need defined arc42 documentation to validate issue alignment?▼

You need defined arc42 goals and quality attributes to validate issue alignment effectively. The skill checks an issue purpose against arc42 section 1 and section 10 criteria, requiring existing project governance documentation to surface misalignments accurately.