Skip to content

Update quality-playbook skill to v1.6.1 - #5996

Closed
andrewstellman wants to merge 2 commits into
github:stagedfrom
andrewstellman:add-quality-playbook-1.6.1
Closed

andrewstellman wants to merge 2 commits into
github:stagedfrom
andrewstellman:add-quality-playbook-1.6.1

Conversation

@andrewstellman

Copy link
Copy Markdown
Contributor

Update quality-playbook skill to v1.6.1

This PR updates the Quality Playbook skill from v1.5.6 to v1.6.1.
It replaces the bundled v1.5.6 files in skills/quality-playbook/ with a
single SKILL.md that installs the current toolkit from pip or npm, so
the registry no longer carries a copy of the reference files that goes
stale with each release.

What it is

Run a complete quality engineering audit on any codebase. Derives behavioral requirements from the code, generates spec-traced functional tests, runs a three-pass code review with regression tests, executes a multi-model spec audit (Council of Three), and produces a consolidated bug report with TDD-verified patches. Finds the 35% of real defects that structural code review alone cannot catch. Works with any language. Trigger on 'quality playbook', 'spec audit', 'Council of Three', 'fitness-to-purpose', or 'coverage theater'.

Distribution

The full Quality Playbook toolkit is published on pip + npm as
quality-playbook (v1.6.1). The SKILL.md added here gives users
a one-line install (pip install quality-playbook or
npx quality-playbook install --into <repo> --ai-tool <tool>) plus
the canonical quality-playbook install --into <repo> --ai-tool <tool>
command, which copies the skill files into the adopter's AI-tool
skills directory (auto-detecting .claude/, .github/, .cursor/,
.continue/, .codex/, .windsurf/, .cline/, .aider/).

The skill ships SKILL.md plus six support directories (references/,
phase_prompts/, agents/, ai_context/, schemas/, scripts/):
about 76 files, with an 89KB SKILL.md. That is larger than a typical
in-repo skill, so the SKILL.md in this PR links back to
https://github.com/andrewstellman/quality-playbook as the canonical source instead of inlining the assets.

Verification

The maintainer can verify the skill by running:

pip install quality-playbook==1.6.1
quality-playbook install --into ./test-target-repo --ai-tool claude
ls ./test-target-repo/.claude/skills/quality-playbook/   # or similar

Then in the target repo's AI agent, say "run the quality playbook"
and the skill activates.

Checklist (per github/awesome-copilot CONTRIBUTING.md)

  • I have read CONTRIBUTING.md and followed the submission
    guidelines.
  • This PR targets the staged branch (not main).
  • Contribution type: update to an existing skill (skills/quality-playbook/).
  • SKILL.md frontmatter has name, description, and license.
  • name matches the folder name (quality-playbook).
  • description is clear and non-empty.
  • npm start run locally: skill:validate passes and the
    top-level README.md is regenerated; both are staged in this PR.
  • Canonical repo + license linked.

License note for maintainers

The Quality Playbook toolkit ships under Apache 2.0 (see
LICENSE.txt in the canonical repo). The frontmatter license: field
in this PR's SKILL.md is set to Apache-2.0. If the registry
requires license: MIT for all skill entries, please flag and we will
re-evaluate licensing options with the QPB maintainers.

Canonical source

Maintained at https://github.com/andrewstellman/quality-playbook.

Copilot AI dynamic review requested due to automatic review settings October 30, 2026 16:13

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🔵 Needs a closer look

The remaining agent still copies the old skill layout, so the resource deletions leave it without required phase and iteration instructions; its installation flow must be updated or those resources retained.

No open issues 🎉

What changed in this PR

This PR moves Quality Playbook toward upstream package distribution for v1.6.1, removing bundled v1.5.6 resources from the skill catalog to avoid maintaining stale copies.

Changes:

  • Removes bundled audit references, verification guidance, and requirements protocols.
  • Removes phase prompts and bundled orchestration agents.
  • Removes the bundled Apache license file as part of the distribution change.
File Description
skills/​quality-playbook/​references/​verification.md Removes bundled verification checklist.
skills/​quality-playbook/​references/​spec_audit.md Removes bundled multi-model audit protocol.
skills/​quality-playbook/​references/​schema_mapping.md Removes schema-mapping guidance.
skills/​quality-playbook/​references/​run_state_schema.md Removes run-state schema documentation.
skills/​quality-playbook/​references/​requirements_review.md Removes requirements review template.
skills/​quality-playbook/​references/​requirements_refinement.md Removes requirements refinement protocol.
skills/​quality-playbook/​references/​requirements_pipeline.md Removes requirements generation pipeline.
skills/​quality-playbook/​references/​orchestrator_protocol.md Removes shared orchestration rules.
skills/​quality-playbook/​references/​iteration.md Removes iteration strategy guidance.
skills/​quality-playbook/​references/​functional_tests.md Removes functional testing guidance.
skills/​quality-playbook/​references/​exploration_patterns.md Removes bug-discovery patterns.
skills/​quality-playbook/​references/​defensive_patterns.md Removes defensive-code analysis guidance.
skills/​quality-playbook/​references/​constitution.md Removes quality constitution template.
skills/​quality-playbook/​references/​code-only-mode.md Removes code-only audit documentation.
skills/​quality-playbook/​references/​challenge_gate.md Removes bug-validation protocol.
skills/​quality-playbook/​phase_prompts/​single_pass.md Removes single-pass prompt.
skills/​quality-playbook/​phase_prompts/​README.md Removes phase-prompt documentation.
skills/​quality-playbook/​phase_prompts/​phase6.md Removes verification prompt.
skills/​quality-playbook/​phase_prompts/​phase5.md Removes reconciliation and TDD prompt.
skills/​quality-playbook/​phase_prompts/​phase4.md Removes spec-audit prompt.
skills/​quality-playbook/​phase_prompts/​phase3.md Removes code-review prompt.
skills/​quality-playbook/​phase_prompts/​phase2.md Removes artifact-generation prompt.
skills/​quality-playbook/​phase_prompts/​phase1.md Removes exploration prompt.
skills/​quality-playbook/​phase_prompts/​iteration.md Removes iteration invocation prompt.
skills/​quality-playbook/​LICENSE.txt Removes bundled Apache license text.
skills/​quality-playbook/​agents/​quality-playbook.agent.md Removes bundled general orchestrator.
skills/​quality-playbook/​agents/​quality-playbook-claude.agent.md Removes bundled Claude orchestrator.
skills/​quality-playbook/​agents/​calibration_orchestrator.md Removes calibration-cycle orchestrator template.

Review effort: Balanced (auto)

andrewstellman added a commit to andrewstellman/quality-playbook that referenced this pull request Oct 30, 2026
The orchestrator agent's "skill not installed" section told users to
copy SKILL.md, references/ and phase_prompts/ by hand from paths that
do not exist in a clone (.github/skills/quality_gate/quality_gate.py).
It now gives the npx and pipx installer commands, which is also what
the awesome-copilot copy of the agent needs now that the registry
carries only SKILL.md (Copilot review of github/awesome-copilot#5996).

submit_awesome_copilot.py: the trimmed SKILL.md describes what the
installer actually copies (SKILL.md, quality_gate.py, references/,
phase_prompts/, agents/, ai_context/, bin/), and the --submit commit
message says Update rather than Add.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RpebcGAbi7m53eiRJV8BRV
The agent told users to copy skills/quality-playbook/* from an
awesome-copilot clone, which now holds only SKILL.md. It now installs
the skill with npx or pipx, and its orchestration text is the v1.6.1
agent's. SKILL.md: the installed layout sentence now matches what the
installer copies. docs/README.*.md: regenerated by npm start
(left out of the first commit by mistake).

@aaronpowell aaronpowell left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please retarget this PR to main. AGENTS.md says pull requests should target main, not staged; gh pr view currently reports staged as the base branch.

@aaronpowell

Copy link
Copy Markdown
Contributor

Closing due to staleness

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants