mcpField
C
compliance-policy-check

compliance-policy-check

github.com/oimiragieoAgent workflows4458 installsUpdated 17w ago
Repository

About compliance-policy-check

compliance-policy-check is a policy-assessment skill for plans and designs, intended for regulated or high-risk changes. It returns a PASS, CONDITIONAL, or FAIL decision with findings and remediation guidance without modifying code.

Key features

  1. 01Assess plans against framework policies
  2. 02Check security and quality constraints
  3. 03Return PASS, CONDITIONAL, or FAIL
  4. 04Provide findings and remediation tasks
  5. 05Recheck compliance after changes

Use cases

  1. 01Review a plan before high-risk implementation
  2. 02Check a design for policy alignment
  3. 03Identify mitigations for conditional approval
  4. 04Verify fixes after major changes

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/oimiragieo/agent-studio --skill compliance-policy-check

After installing, type/compliance-policy-checkin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

commands/
compliance-policy-check.md
hooks/
post-execute.cjs
pre-execute.cjs
references/
research-requirements.md
rules/
compliance-policy-check.md
schemas/
input.schema.json
output.schema.json
scripts/
main.cjs
templates/
implementation-template.md

Details

From the project README

Compliance Policy Check

Overview

Evaluate a design/plan against framework policy and rule constraints before execution. Use this for regulated or high-risk changes.

When to Use

  • Before creator workflows for new artifacts
  • Before HIGH/EPIC implementation phases
  • During reflection when repeated policy violations are observed

Iron Laws

  1. NEVER execute or modify code during compliance checks — this skill assesses policy alignment only; any implementation must happen separately after compliance is confirmed.
  2. ALWAYS run compliance check before HIGH/EPIC implementation — high-risk changes that bypass compliance checks create undetected policy drift that compounds over time into systemic violations.
  3. ALWAYS report findings with specific remediation tasks and owning agent — vague "policy violation" reports without actionable remediation steps don't produce fixes; every FAIL and CONDITIONAL must include a concrete task.
  4. NEVER report PASS on partial compliance — a plan that satisfies 80% of policies is a CONDITIONAL, not a PASS; partial compliance masks the remaining violations and gives false confidence.
  5. ALWAYS recheck after remediation, not just once — a single compliance check before implementation is insufficient; verify again after major changes to confirm remediations are complete.

Workflow

Step 1: Gather Policy Context
  • Read relevant files in .claude/rules/
  • Read applicable workflow/agent constraints
  • Read enforcement hook docs if needed
Step 2: Evaluate Proposed Change

Assess against:

  1. Creator guard and artifact lifecycle rules
  2. Routing and specialist-first requirements
  3. Security and quality gate requirements
  4. Memory/search/token-saver policy expectations
Step 3: Produce Decision

Return one policy decision:

  • PASS: policy-aligned
  • CONDITIONAL: allowed with required mitigations
  • FAIL: not policy-compliant

Use this output shape:

{
  "decision": "PASS|CONDITIONAL|FAIL",
  "policyFindings": ["..."],
  "requiredMitigations": [],
  "evidencePaths": ["..."],
  "recommendedNextStep": "..."
}

Output Protocol

For CONDITIONAL and FAIL, include precise remediation tasks and ownership (agent type).

Anti-Patterns

Anti-PatternWhy It FailsCorrect Approach
Implementing code during compliance checkConflates assessment with implementationAssess only; implementation happens separately after PASS
Skipping compliance for "small" changesSmall changes introduce policy violations silentlyRun compliance check proportionally for all HIGH/EPIC work
Reporting PASS on partial complianceMasks unresolved violations; gives false confidenceReport CONDITIONAL with specific remediation required
Vague violation reports without remediationViolations aren't fixed without clear next stepsInclude agent, task, and target file for every FAIL/CONDITIONAL
Only checking once before implementationPost-change compliance drift goes undetectedRecheck compliance after major implementation changes

Memory Protocol

Record recurring policy drift patterns in .claude/context/memory/issues.md and stabilized controls in .claude/context/memory/decisions.md.

Comments

Markdown supported