devenv-refine-requirements

Updates requirements documents while preserving ID and dependency integrity.

Updated Jul 4, 2024
One-click install
npx skills add https://github.com/workinprogress-ai/devenv --skill devenv-refine-requirements
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: devenv-refine-requirements
Source: https://github.com/workinprogress-ai/devenv/tree/main/copilot/skills/devenv-refine-requirements
Command: npx skills add https://github.com/workinprogress-ai/devenv --skill devenv-refine-requirements

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill manages the evolution of requirements documents when stakeholder priorities shift, new scenarios emerge, or implementation discoveries expose gaps, ensuring that changes are applied without breaking historical context or dependency links.

Core Features & Use Cases

  • Surgical Requirement Updates: Revise acceptance criteria and add new requirements while preserving existing IDs and dependency edges.
  • Revision History Tracking: Automatically logs all deletions, modifications, and priority shifts to maintain a clear audit trail.
  • Consistency Auditing: Detects and flags contradictions between new and existing requirements, and identifies stale documentation or episodes.

Quick Start

Invoke the devenv-refine-requirements skill by providing the file path to the specific requirements document you need to update.

Frequently Asked Questions about devenv-refine-requirements

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

FAQPage Schema
How do I update existing requirements documentation without breaking dependency links?

To update requirements documentation without breaking dependency links, apply surgical revisions that preserve existing IDs and dependency edges while incorporating new stakeholder feedback and implementation findings into the evolving project document.

What is the best way to maintain an audit trail when shifting stakeholder priorities?

Maintaining an audit trail when shifting stakeholder priorities requires automatically logging all deletions, modifications, and priority shifts to ensure a clear revision history of evolving requirements documentation.

How do I detect contradictions between new and existing requirements?

To detect contradictions between new and existing requirements, perform a consistency audit that flags conflicting changes and identifies stale documentation or episodes during the requirements refinement process.

Can I add new acceptance criteria while preserving historical context in requirements documents?

Yes, you can add new acceptance criteria and revise existing ones while preserving historical context, as the refinement process ensures consistency across linked artifacts and validates against existing requirement constraints.

When should I refine requirements instead of rewriting the entire document?

You should refine requirements instead of rewriting when new scenarios emerge, implementation discoveries expose gaps, or stakeholder priorities shift, requiring updates that maintain strict ID and dependency integrity without losing historical context.