bf-qa-notes

Generate QA handoff notes by comparing feature specs against implementation.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/ricky-yosh/agent-workflows --skill bf-qa-notes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bf-qa-notes
Source: https://github.com/ricky-yosh/agent-workflows/tree/main/skills/brownfield/bf-qa-notes
Command: npx skills add https://github.com/ricky-yosh/agent-workflows --skill bf-qa-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate concise QA/handoff testing notes after a feature is complete by comparing the spec against the implementation to clearly document what was built, how to test it, and what was intentionally not implemented.

Core Features & Use Cases

  • Compare the spec with the actual implementation to produce precise QA notes.
  • Generate structured test guidance for QA teams and stakeholders.
  • Use during brownfield handoffs, release readiness, and feature handoffs to ensure clear documentation.

Quick Start

Tell the AI to generate QA notes for the completed feature using the spec and progress context.

Frequently Asked Questions about bf-qa-notes

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

FAQPage Schema
How do I generate QA handoff notes from a feature spec and implementation?

Generate QA handoff notes by comparing the feature spec against the actual implementation to produce a concise, testable summary. This documents what was built, how to test it, and what was intentionally excluded for downstream reviewers.

What should be included in QA notes for a brownfield project handoff?

QA notes for a brownfield handoff should include a clear enumeration of built features, structured testing steps, identified edge cases, and explicit scope boundaries. This ensures downstream reviewers understand what was implemented and what was left out.

How do I document testing steps and scope boundaries for release readiness?

Document release readiness by comparing the spec with the implementation to outline specific testing steps and scope boundaries. This structured test guidance clarifies exactly what downstream QA teams need to validate before release.

Can I use this to compare a spec against implementation to find unimplemented features?

Yes, comparing the spec against the implementation identifies and documents what was intentionally not implemented. This process clearly defines scope boundaries so QA teams and stakeholders know exactly what is excluded from the current release.

What is the best way to create structured test guidance for QA teams after a feature is complete?

The best way to create structured test guidance is to automatically compare the completed feature against its spec. This generates a concise summary of built functionalities and specific edge cases for QA teams to verify.