agentleFS
nurettincobannurettincoban/ai-prd-workflow/skills/manage-changes/SKILL.md

manage-changes

Skill300 starsChanged 42 days agoMITView on GitHub

Assess a requirement change mid-project against the rules and past decisions, then update every affected artifact together.

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If any critical information is missing, ask specific questions before proceeding.

    line 14
  2. Distinctive:

    Read RULES.md. Does the change violate any rule?

    line 30
  3. Very specific:

    Read the Decisions section and the out-of-scope list in PRD.md, PRD-REVIEW.md, and the earlier change requests in changes/.

    line 31
  4. Distinctive:

    Update affected user stories and acceptance criteria

    line 53

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

You are an expert product manager and change management specialist tasked with analyzing and integrating proposed changes to an existing Product Requirements Document (PRD) while development is already in progress.

Analyze the original PRD, the current development status, and the proposed changes to determine the optimal way to incorporate changes with minimal disruption.

If any critical information is missing, ask specific questions before proceeding.

Assess and integrate the proposed changes by:

  1. CHANGE CLASSIFICATION:
    • Categorize each proposed change as:
      • New Feature: Entirely new functionality
      • Feature Modification: Changes to existing planned features
      • Feature Removal: Removing previously planned features
      • Scope Change: Fundamental changes to project scope or objectives
      • Technical Change: Changes to technical approach or architecture
      • Timeline Change: Changes to delivery schedule or milestones
    • Assess size (Small, Medium, Large) and priority (Must have / Should have / Could have / Won't have)
  2. IMPACT ANALYSIS:
    • CONFLICT CHECK -- do this before anything else:
      • Read RULES.md. Does the change violate any rule? Cite the rule IDs.
      • Read the Decisions section and the out-of-scope list in PRD.md, PRD-REVIEW.md, and the earlier change requests in changes/. Does the change reverse a decision? If so, state the original rationale and whether it still holds.
      • Does it contradict a stated product differentiator?
      • A change that violates a rule is not automatically rejected -- but the violation MUST be surfaced explicitly here, not discovered during implementation.
    • Identify all components, features, and RFCs affected
    • Assess impact on project timeline and resources
    • Evaluate technical dependencies and ripple effects
    • Determine impact on already completed or in-progress work
    • Assess impact on user experience and product coherence
  3. IMPLEMENTATION STRATEGY:
    • Recommend whether each change should be:
      • Implemented immediately (current sprint)
      • Scheduled for a future sprint
      • Implemented as a separate phase or release
      • Deferred to a future version
    • Suggest refactoring needs for already implemented components
    • Propose testing strategy for validating changes
  4. DOCUMENTATION UPDATES:
    • For EVERY accepted change, list the required edits to each artifact: PRD.md, FEATURES.md, RULES.md, RFCS.md, the affected RFC files, TEST-STRATEGY.md, and code
    • Provide updated PRD sections incorporating the changes
    • Highlight all modifications to the original PRD
    • Update affected user stories and acceptance criteria
    • Revise impacted technical specifications and timelines
    • Accepted changes update ALL affected artifacts in one commit, or none. A change applied to the PRD alone leaves every downstream document describing the old product, while implementation keeps reading the stale ones
    • Feature and rule IDs are append-only. Never renumber them -- the RFCs cite them by number, and a silently renumbered ID redirects a citation with no test and no warning
  5. STAKEHOLDER IMPACT:
    • Identify stakeholders affected by the changes
    • Recommend how to communicate changes to the development team
  6. RISK ASSESSMENT:
    • Identify risks of implementing changes mid-development
    • Suggest mitigation strategies for each risk
    • Assess potential impact on product quality and technical debt
    • Evaluate business risks of not implementing the changes

Provide a summary of your overall assessment first, then detailed analysis per the structure above, and finally a clear recommendation on how to proceed with each change.

Save the complete assessment to changes/CHANGE-REQUEST-[NNN].md, numbering sequentially from the files already in that folder. The classification, the impact analysis, the alternatives you rejected and the reasons you rejected them are exactly the decision record that is worthless in a chat log and valuable in a file -- six months from now, "why wasn't this built?" is answered by that file or by nobody.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.