Menu
Run the full CI pipeline locally, mirroring the checks in .github/workflows/ci.yml. Use to verify everything passes before pushing.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
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 | check-ci |
| description | Run the full CI pipeline locally, mirroring the checks in .github/workflows/ci.yml. Use to verify everything passes before pushing. |
| allowed-tools | Bash(shfmt *), Bash(shellcheck *), Bash(find *), Bash(npx markdownlint-cli2 *), Bash(npx prettier *), Bash(bash plugins/*), Bash(echo *), Bash(jq *), Bash(python3 *) |
| user-invocable | true |
Run the full CI pipeline locally, mirroring the checks in .github/workflows/ci.yml.
/check-ci
Run each check in sequence. Stop and report if any check fails.
find . -name '*.sh' -not -path './node_modules/*' | xargs shfmt -i 2 -bn -sr -d
find . -name '*.sh' -not -path './node_modules/*' | xargs shellcheck --shell=bash
npx markdownlint-cli2 '**/*.md'
npx prettier --check '**/*.md'
bash plugins/principled-docs/skills/scaffold/scripts/check-template-drift.sh
bash plugins/principled-implementation/scripts/check-template-drift.sh
bash plugins/principled-github/scripts/check-template-drift.sh
bash plugins/principled-quality/scripts/check-template-drift.sh
bash plugins/principled-release/scripts/check-template-drift.sh
bash plugins/principled-docs/skills/scaffold/scripts/validate-structure.sh --root
Verify .claude-plugin/marketplace.json is valid JSON and all plugin source directories exist.
Verify every plugin in plugins/*/ and external_plugins/*/ has a valid .claude-plugin/plugin.json.
For each docs/decisions/*.md with status: accepted, feed its path to check-adr-immutability.sh and verify exit code 2 (block). Also test a non-decision file and verify exit code 0 (allow).
For each docs/proposals/*.md with terminal status, feed its path to check-proposal-lifecycle.sh and verify exit code 2. For draft proposals, verify exit code 0.
Feed .impl/manifest.json path to check-manifest-integrity.sh and verify exit code 0 (advisory). Feed an unrelated path and verify exit code 0 (silent passthrough).
Feed gh pr create --title "test" --body "test" command to check-pr-references.sh and verify exit code 0 (advisory). Feed an unrelated command and verify exit code 0 (silent passthrough).
Feed gh pr review 42 and gh pr merge 42 commands to check-review-checklist.sh and verify exit code 0 (advisory). Feed an unrelated command and verify exit code 0 (silent passthrough).
Feed git tag v1.0.0 command to check-release-readiness.sh and verify exit code 0 (advisory). Feed git tag -l and verify exit code 0 (silent passthrough). Feed an unrelated command and verify exit code 0 (silent passthrough).
Report pass/fail for each step. If all pass, confirm the repo is CI-clean. If any fail, list the failures and suggest fixes.