audit-work-integrity

Audit repository branches, PRs, and issues for workflow integrity gaps.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/ourchitecture/idp --skill audit-work-integrity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-work-integrity
Source: https://github.com/ourchitecture/idp/tree/main/.agents/skills/audit-work-integrity
Command: npx skills add https://github.com/ourchitecture/idp --skill audit-work-integrity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits repository workflow integrity by evaluating the relationships between branches, pull requests, issues, and canonical worktrees to surface gaps and drift before they impact delivery.

Core Features & Use Cases

  • Detect orphan branches without an open PR targeting the base branch.
  • Verify PR-to-issue linkage, ensure in-progress issues have active PRs, and flag duplicates.
  • Produce a structured, actionable report with findings, a readiness score, and remediation steps, plus optional post-output to an issue for traceability.

Quick Start

Run audit-work-integrity against your repository to generate a findings report and remediation plan.

Frequently Asked Questions about audit-work-integrity

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

FAQPage Schema
How do I audit GitHub branches and pull requests for workflow integrity gaps?

To audit GitHub branches and pull requests, you can run an integrity audit that maps branches to open PRs and issues, enforcing strict policy checks to detect orphan branches and missing linkages before delivery. It produces a deterministic report with a final score and remediation guidance.

What is an orphan branch and how do I detect branches without an open PR?

An orphan branch is a branch lacking an open pull request targeting the base branch. You detect branches without an open PR by auditing repository worktrees, mapping active branches against current pull requests, and flagging any branches that lack a corresponding PR.

How do I verify pull request to issue linkage across my repository?

To verify pull request to issue linkage, audit your repository's open PRs and issues to ensure in-progress issues have active PRs. The audit maps PRs to their corresponding issues, flags missing links, and identifies duplicate PRs targeting the same issue.

Can I post automated repository audit findings directly to a GitHub issue?

Yes, you can post automated repository audit findings directly to a specified GitHub issue. The audit generates a structured report with findings by severity, a readiness score, and remediation steps, then optionally posts this output to an issue for traceability.

Does the repository audit work with the gh CLI or does it require API tokens?

The repository audit applies MCP-first data gathering with fallback gh commands to map branches, PRs, and issues. This means it prioritizes MCP tools but falls back to standard gh CLI commands, requiring no separate API token setup beyond your existing gh authentication.

Can I include recently closed pull requests and issues in the workflow audit?

Yes, you can include recently closed pull requests and issues in the workflow audit. The audit optionally incorporates recently closed items alongside open PRs and branches, providing broader historical context to accurately evaluate repository drift and workflow gaps.