Skip to content

feat(me): align lifecycle skills with upstream practices - #651

Merged
baleen37 merged 1 commit into
mainfrom
gentle-otter-turing
May 12, 2026
Merged

feat(me): align lifecycle skills with upstream practices#651
baleen37 merged 1 commit into
mainfrom
gentle-otter-turing

Conversation

@baleen37

@baleen37 baleen37 commented May 12, 2026

Copy link
Copy Markdown
Owner

Summary

  • Align /test, /review, and /ship lifecycle skills with upstream testing, review, and launch-readiness practices
  • Strengthen local skill cross-links for runtime verification, security review, test coverage, and release decisions
  • Add the implementation plan used for the lifecycle skill alignment work

Changes

  • /test: emphasizes failing repros, observable behavior, focused-first verification, and runtime checks
  • /review: adds severity rules, security escalation, simplification guidance, and findings-only subagent review guidance
  • /ship: strengthens CI/check, rollback, observability, staged rollout, and GO/NO-GO defaults

Tests

  • pre-commit run markdownlint --files plugins/me/skills/test/SKILL.md plugins/me/skills/review/SKILL.md plugins/me/skills/ship/SKILL.md docs/superpowers/plans/2026-05-12-lifecycle-skills-upstream-alignment.md
  • bats tests/ (71 tests)

Summary by CodeRabbit

  • Documentation
    • Enhanced code review workflow guidance with explicit severity definitions and security audit criteria
    • Expanded testing procedures with improved verification steps and success metrics
    • Strengthened deployment processes with detailed GO/NO-GO decision framework, observability requirements, and rollback procedures

Review Change Stack

@coderabbitai

coderabbitai Bot commented May 12, 2026

Copy link
Copy Markdown
📝 Walkthrough

Walkthrough

This PR introduces a structured implementation plan for upstream alignment of three agentic-worker lifecycle skills (test, review, ship) and applies that plan directly to their skill documentation. The changes strengthen testing evidence requirements, add severity/security escalation rules to review, and expand ship readiness gates with explicit rollback and observability specifications.

Changes

Lifecycle Skills Upstream Alignment

Layer / File(s) Summary
Implementation plan document
docs/superpowers/plans/2026-05-12-lifecycle-skills-upstream-alignment.md
New plan document defines goal, architecture scope, and four ordered tasks to strengthen /test (TDD/evidence/gates), /review (severity/blocker/security), /ship (rollback/observability/GO-NO-GO), plus repository verification (markdownlint, bats, git diff) and self-review checklist.
Test skill documentation updates
plugins/me/skills/test/SKILL.md
Skill documentation expanded to prioritize failing repros before implementation, require real-runtime verification for UI/browser changes, add numbered workflow steps with test confirmation/broader-suite execution, and enhance test-engineer subagent checklist with ordering, assertion quality, and flakiness verification.
Review skill documentation updates
plugins/me/skills/review/SKILL.md
Skill documentation reformatted with explicit Severity section (Blocking vs Non-blocking), expanded security-auditor trigger checklist (secrets/auth/authz/injection/dependencies/config), enhanced subagent payload requirements with evidence expectations, and post-subagent deduplication/prioritization rules.
Ship skill documentation updates
plugins/me/skills/ship/SKILL.md
Skill documentation expanded across three phases: Phase A clarifies parallel agent execution in a single turn; Phase B adds six-part merge checklist (Code Quality, Security, Performance, Accessibility, Infrastructure, Documentation) with infrastructure rollback triggers and documentation/post-launch verification; Phase C adds Observability/rollout section (monitoring/alerts, staged rollout, post-launch verification) and structured rollback plan (trigger conditions + procedure); rules tightened to require rollback details for all GO decisions, broaden NO-GO defaults for missing rollback or unverifiable risk, and mandate observability coverage (ownership, staged rollout/feature-flag plan, post-launch verification).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • baleen37/bstack#639: Both PRs modify plugins/me/skills/ship/SKILL.md to strengthen release-readiness, rollback, and observability guidance.
  • baleen37/bstack#650: Both PRs modify the same lifecycle skill documents (plugins/me/skills/{test,review,ship}/SKILL.md), with the main PR refining and expanding those skills.
  • baleen37/bstack#618: The main PR's updates to plugins/me/skills/ship/SKILL.md directly refine the same /ship skill content and workflow that this PR introduced.

Poem

🐰 A rabbit hops through skills aligned,
Test, review, and ship—all redesigned!
With rollback plans and gates so tight,
The lifecycle flows from dark to light.
Now observability shines bright,
As production launches get it right! ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title directly and clearly summarizes the main change: aligning the lifecycle skills (/test, /review, /ship) with upstream practices, which is the core focus of all modifications in the changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch gentle-otter-turing

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@baleen37
baleen37 enabled auto-merge (squash) May 12, 2026 06:53
auto-merge was automatically disabled May 12, 2026 06:54

Repository rule violations found

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@plugins/me/skills/ship/SKILL.md`:
- Around line 100-104: Update Rule 1 in SKILL.md to state that the three "Phase
A personas" must run in parallel under the Agent harness, and add an explicit
exception clause that if an Agent tooling/harness is unavailable the operator
MAY run persona steps sequentially as a fallback — but only when the operator
documents the deviation, the increased risk, and obtains explicit user consent;
also update any fallback guidance text to reference this exception so there is
no ambiguity between "never sequentially" and the fallback path.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: ffcc99df-76b8-4d0a-8032-5d4efc11db1b

📥 Commits

Reviewing files that changed from the base of the PR and between efc1172 and ddabf90.

📒 Files selected for processing (4)
  • docs/superpowers/plans/2026-05-12-lifecycle-skills-upstream-alignment.md
  • plugins/me/skills/review/SKILL.md
  • plugins/me/skills/ship/SKILL.md
  • plugins/me/skills/test/SKILL.md

Comment on lines 100 to +104
1. The three Phase A personas run in parallel — never sequentially.
2. Personas do not call each other. The main agent merges in Phase B.
3. The rollback plan is mandatory before any GO decision.
4. If any persona returns a Critical finding, the default verdict is NO-GO unless the user explicitly accepts the risk.
5. **Skip the fan-out only if all of the following are true:** the change touches 2 files or fewer, the diff is under
3. The rollback plan is mandatory before any GO decision, including rollback trigger and procedure.
4. Default to NO-GO for any Critical security finding, failing required test/build/check/CI status, missing rollback
plan, or unverifiable production risk. Only override if the user explicitly accepts the risk.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major | ⚡ Quick win

Resolve the parallelism rule contradiction.

Line 100 says “never sequentially,” but the fallback guidance allows sequential execution when Agent tooling is unavailable. This creates conflicting operator instructions. Clarify Rule 1 with an explicit exception for non-Agent harnesses so the procedure is unambiguous.

Suggested wording update
-1. The three Phase A personas run in parallel — never sequentially.
+1. In Claude Code (Agent tool available), run all three Phase A personas in parallel in a single assistant turn.
+   If the harness lacks an Agent tool, run persona passes sequentially and treat outputs as parallel inputs for Phase B synthesis.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@plugins/me/skills/ship/SKILL.md` around lines 100 - 104, Update Rule 1 in
SKILL.md to state that the three "Phase A personas" must run in parallel under
the Agent harness, and add an explicit exception clause that if an Agent
tooling/harness is unavailable the operator MAY run persona steps sequentially
as a fallback — but only when the operator documents the deviation, the
increased risk, and obtains explicit user consent; also update any fallback
guidance text to reference this exception so there is no ambiguity between
"never sequentially" and the fallback path.

@baleen37
baleen37 merged commit 3397d05 into main May 12, 2026
5 checks passed
@baleen37
baleen37 deleted the gentle-otter-turing branch May 12, 2026 06:56
baleen-release-app Bot pushed a commit that referenced this pull request May 12, 2026
# [17.8.0](v17.7.0...v17.8.0) (2026-05-12)

### Features

* **me:** align lifecycle skills with upstream practices ([#651](#651)) ([3397d05](3397d05))
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.

1 participant