القائمة
Verify that all pipeline documents referenced by merged changes are in terminal status. Checks proposals, plans, and ADRs to ensure release readiness before tagging.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Validate that a pull request follows principled conventions: references a plan or proposal, has correct labels, includes required sections in the description, and links to relevant documents. Use in CI or before merging to enforce PR quality.
Generate a structured pull request description from a DDD plan task. Reads the plan, task manifest, and implementation branch to produce a PR body with references to the originating proposal, plan, ADRs, and related tasks. Use when opening a PR for plan-driven work.
Process open GitHub issues through the principled pipeline. Lists untriaged issues, normalizes their metadata, ingests them into the documentation pipeline, and reports a summary. Operates as the batch entry point — delegates to /ingest-issue for each individual issue.
Implementation orchestration strategy for the Principled framework. Consult when working with DDD plan execution, git worktrees for task isolation, task manifests, or the decompose-spawn-validate-merge lifecycle. Covers worktree management, sub-agent patterns, task state machines, and manifest schema.
Top-level orchestrator for DDD plan execution. Decomposes a plan into tasks, iterates through phases respecting dependencies, spawns worktree-isolated agents, validates implementations, and merges results. Runs inline to coordinate multiple sub-agent spawns. Use for automated end-to-end plan execution.
Audit ADR coverage across modules. Identifies modules with no architectural governance, orphaned ADRs referencing removed modules, and stale architecture docs. Classifies findings by severity.
| name | release-ready |
| description | Verify that all pipeline documents referenced by merged changes are in terminal status. Checks proposals, plans, and ADRs to ensure release readiness before tagging. |
| allowed-tools | Read, Bash(gh *), Bash(git *), Bash(ls *), Bash(bash plugins/*), Bash(wc *) |
| user-invocable | true |
Verify that all proposals, plans, and ADRs referenced by commits since the last release are in terminal status. A passing check means the release is ready to proceed.
/release-ready [--tag <version>] [--since <tag>] [--strict]
| Argument | Required | Description |
|---|---|---|
--tag <version> | No | The version being prepared (for reporting only) |
--since <tag> | No | Git tag to use as starting point. Auto-detects latest if absent |
--strict | No | Treat non-terminal documents as hard failures instead of warnings |
gh CLI recommended for enriched PR reference resolution (optional)Verify prerequisites. Check that gh is available:
bash scripts/check-gh-cli.sh
If not available, proceed with commit-based reference resolution only.
Determine the starting tag. If --since is provided, use it. Otherwise, find the most recent tag:
git describe --tags --abbrev=0
Check readiness. Run the readiness checker:
bash scripts/check-readiness.sh --since <tag> [--strict]
This collects all pipeline references from commits since the tag and checks each referenced document's frontmatter status.
Evaluate terminal status. For each referenced document:
accepted, rejected, or superseded = terminalcomplete or abandoned = terminalaccepted, deprecated, or superseded = terminalDocuments in non-terminal status (draft proposals, active plans, proposed ADRs) are flagged.
Report results. Output a structured readiness report:
Release Readiness Check (since v0.3.1):
PASS proposal RFC-001 Principled Docs Plugin accepted
PASS plan Plan-000 Principled Docs Plugin complete
WARN plan Plan-006 Principled Release Plugin active
PASS decision ADR-001 Pure Bash Frontmatter accepted
Summary: 3 passed, 1 warning, 0 failed
In --strict mode, warnings become failures and the skill exits non-zero.
scripts/check-gh-cli.sh --- Verify gh CLI availability and auth status (copy from principled-github canonical)scripts/check-readiness.sh --- Check pipeline document statuses against terminal criteria