agentsclimarketplace

Trestle compliance pipeline

Skill oscal-compass-lab/compliance-trestle-skills/skills/trestle-compliance-pipeline

Use this skill for end-to-end compliance pipelines with Compliance Trestle. Topics include GRC personas, artifact ownership, multi-repository coordination, two-phase component definition authoring, CI/CD pipeline integration, and the Compliance-to-Policy (C2P) bridge. Use it for compliance pipelines, personas, artifact ownership, multi-repo workflows, component definition dual-mapping (control-to-rule, rule-to-check), C2P, or end-to-end workflow design.From its SKILL.md

Install
npx -y skills add oscal-compass-lab/compliance-trestle-skills --skill trestle-compliance-pipeline

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 18 stars18 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

13.5 KB, as published. Nobody here has run it

End-to-End Compliance Pipeline

This skill describes the full compliance pipeline. The pipeline starts with regulation authoring. The pipeline ends with assessment results. Topics include persona ownership, multi-repository coordination, and the Compliance-to-Policy (C2P) bridge. The bridge connects OSCAL artifacts to runtime policy validation.

GRC Personas and Artifact Ownership

Each compliance artifact has a primary owner persona. Artifacts flow downstream to consumers:

PersonaPrimary ArtifactKey Trestle CommandsDownstream Consumer
RegulatorsCatalogcatalog-generate, catalog-assembleCompliance Officers
Compliance Officers / CISOProfileprofile-generate, profile-assemble, xlsx-to-oscal-profileControl Providers, System Owners
Control Providers (vendors)Component Definition (Service)csv-to-oscal-cd, component-generate, component-assembleControl Assessors, System Owners
Control Assessors (PVP vendors)Component Definition (Validation)csv-to-oscal-cd (with Check_Id column)CPAC / C2P
System Owners / CIOSystem Security Planssp-generate, ssp-assemble, ssp-filterAssessors, Auditors
AssessorsAssessment Resultsxccdf-result-to-oscal-ar, tanium-result-to-oscal-arCISO, System Owners
OperationsRemediation (POA&M)create, split, merge (JSON workflow)Auditors

Key principle: Each persona manages its artifact independently. Artifacts flow downstream through Git-based propagation. This supports separation of duties. This also supports independent versioning.

Per-Persona Authoring Workflows

Regulators: Catalog Authoring

Regulators publish security controls as catalogs. Examples: NIST 800-53, PCI-DSS, ISO 27001.

# Import existing catalog or create new one
trestle import -f nist-800-53-catalog.json -o nist-800-53

# Generate markdown for human editing
trestle author catalog-generate --name nist-800-53 --output md_catalogs/nist-800-53

# Edit control markdown files (one per control, grouped by family)
# Then reassemble
trestle author catalog-assemble --markdown md_catalogs/nist-800-53 --output nist-800-53

Compliance Officers: Profile Authoring

Compliance Officers select and tailor controls from catalogs into organization-specific baselines.

# Generate profile markdown from existing profile
trestle author profile-generate --name my-baseline --output md_profiles/my-baseline

# Edit markdown: adjust parameter values, add guidance sections
# Then reassemble
trestle author profile-assemble --markdown md_profiles/my-baseline --output my-baseline

# Or convert directly from spreadsheet
trestle task xlsx-to-oscal-profile

Profiles can import from more than one catalog. Profiles can also import from other profiles. This creates layered baselines. Example: FedRAMP High inherits from NIST 800-53 and adds FedRAMP-specific parameters.

Control Providers: Two-Phase Component Definition

Control Providers (vendors, service providers) declare how their products implement controls. This is a two-phase process. Phase 1 uses structured rule data in CSV. Phase 2 uses narrative responses in markdown.

Phase 1: Rules with CSV spreadsheet:

# CSV contains: Rule_Id, Rule_Description, Component_Title, Component_Type,
#               Control_Id_List, Parameter_Id, Parameter_Value_Alternatives, ...
trestle task csv-to-oscal-cd

The CSV captures structured mappings: which controls map to which technical rules and parameters. Vendors manage this in spreadsheet tools and commit the CSV to Git.

Phase 2: Responses with markdown:

# Generate markdown from the component definition created in Phase 1
trestle author component-generate --name my-service --output md_compdefs/my-service

# Edit markdown: write prose responses describing HOW controls are implemented
# Then reassemble
trestle author component-assemble --markdown md_compdefs/my-service --output my-service

The markdown captures narrative prose: implementation descriptions, rationale, and status.

Why two phases? Manage structured data in spreadsheets. Structured data includes rules, parameters, and control mappings. Edit narrative prose as markdown. Narrative prose includes implementation descriptions. The two-phase pattern separates these tasks.

System Owners: SSP Authoring

System Owners combine profiles and component definitions into a System Security Plan.

# Generate SSP markdown from profile + component definitions
trestle author ssp-generate --profile my-baseline --compdefs service-a,service-b --output md_ssp/my-system

# Edit markdown: fill in system-specific implementation details, set ssp-values
# Then reassemble
trestle author ssp-assemble --markdown md_ssp/my-system --output my-system

# Filter SSP to a specific profile (for different audit scopes)
trestle author ssp-filter --name my-system --profile fedramp-high --output my-system-fedramp

The Component Definition Bridge

The component definition is the bridge artifact. It connects regulatory controls to automated assessment. It operates at two layers with two distinct component types.

Layer 1: Service Components (Control-to-Rule)

Service components map regulation controls to technology-specific rules and parameters:

Control (example: AC-2)  -->  Rule (example: rule-account-types)  -->  Parameter (example: timeout=15min)
  • Owner: Product vendors, service providers
  • CSV columns: Rule_Id, Rule_Description, Control_Id_List, Parameter_Id, Component_Type=Service
  • Purpose: Declares WHAT rules implement a control for a specific technology

Layer 2: Validation Components (Rule-to-Check)

Validation components map rules to PVP check identifiers:

Rule (example: rule-account-types)  -->  Check_Id (example: test_github.GitHubOrgs.test_members_is_not_empty)
  • Owner: Assessment tool vendors, PVP providers, compliance engineers
  • CSV columns: Rule_Id, Check_Id, Check_Description, Component_Type=Validation
  • Purpose: Declares HOW a rule is validated by a specific assessment tool

End-to-End Traceability

Together, the two layers create full traceability:

Regulation Control (NIST AC-2)
    --> Service Rule (rule-account-types)
        --> Validation Check (test_github.GitHubOrgs.test_members_is_not_empty)
            --> Assessment Result (pass/fail)
                --> Control Posture (satisfied/not-satisfied)

This chain supports automated status computation. Start from PVP assessment results. Follow the mappings back through the component definitions. Then get the control status.

Multi-Repository Coordination

Repository Topology

Large organizations separate artifacts by ownership boundaries:

catalog-repo (Regulators)
    |
    v  imports
profile-repo (Compliance Officers)
    |
    v  references
compdef-repo (Vendors / Control Providers)
    |
    v  combined into
ssp-repo (System Owners)

Each repository has independent:

  • Versioning: Catalogs change on regulatory cycles. Profiles change on policy review cycles.
  • Access control: Only authorized personas can merge to main.
  • CI/CD pipelines: Each repo validates and assembles its own artifacts.

Change Propagation Pattern

When an upstream artifact changes, downstream repositories can receive automated PRs:

  1. Upstream merge triggers the CI/CD pipeline.
  2. The pipeline runs trestle author *-assemble to produce updated OSCAL JSON.
  3. CI/CD creates a PR in each downstream repository that imports this artifact.
  4. Downstream owners review and merge. That merge triggers their own assembly pipelines.

Example: A new control is added to the catalog. The profile repo gets a PR to include it. After merge, the compdef repo gets a PR to add rule mappings. After that merge, the SSP repo gets a PR for new control responses.

When to Use Multi-Repo vs Single-Repo

FactorSingle RepoMulti-Repo
Team sizeSmall team (1-5 people)Multiple teams / organizations
OwnershipSame team owns all artifactsDifferent teams own different artifacts
Release cadenceAll artifacts change togetherArtifacts change independently
Access controlSame permissions for allDifferent access per artifact type
ComplexitySimple, lower overheadHigher overhead, better separation

Recommendation: Start with a single repo. Split when ownership boundaries become clear or when independent versioning is needed.

CI/CD Pipeline Integration

Pipeline Stages

Pre-commit          -->  PR Merge           -->  Post-Merge
trestle validate        trestle author          Propagate to
                        *-assemble              downstream repos
                        (conditional write)

Pre-commit / PR validation:

# Validate all models in workspace
trestle validate -a

# Or validate specific model
trestle validate -t catalog -n my-catalog

PR merge / assembly:

# Assemble only writes if content changed (prevents unnecessary git churn)
trestle author catalog-assemble --markdown md_catalogs/my-catalog --output my-catalog
trestle author profile-assemble --markdown md_profiles/my-baseline --output my-baseline
trestle author component-assemble --markdown md_compdefs/my-service --output my-service
trestle author ssp-assemble --markdown md_ssp/my-system --output my-system

Post-merge propagation:

  • If the assembled JSON changed, trigger downstream repository updates.
  • Downstream repos import the new version and run their own assembly.

Write Once, Use Multiple Times

A core principle from the COMPASS architecture is write once, use many times. Write each compliance artifact once. Then reuse it in more than one context:

  • One catalog serves multiple profiles (FedRAMP High, Moderate, Low all import from NIST 800-53)
  • One component definition serves multiple SSPs (same service deployed in different systems)
  • One set of PVP checks validates the same rules across environments (dev, staging, prod)

This avoids duplication. This keeps artifacts consistent across the compliance program.

Compliance-to-Policy (C2P)

C2P is a separate tool. It is not part of Trestle. C2P bridges OSCAL compliance artifacts to runtime policy validation. It also maps results back to OSCAL assessment results.

What C2P Does

OSCAL Component Definition
    --> C2P generate_pvp_policy -->  PVP-specific policy config
                                        --> PVP executes checks
    <-- C2P generate_pvp_result <--  PVP-native results
OSCAL Assessment Results

C2P reads the component definition rule-to-check mappings and:

  1. Generates PVP policy: Configures the PVP with the right checks and parameters
  2. Collects PVP results: Reads native PVP output after execution
  3. Produces OSCAL Assessment Results: Maps check pass/fail back to control posture

Trestle's Role in the C2P Pipeline

Trestle authors the OSCAL artifacts that C2P consumes:

  • csv-to-oscal-cd creates the component definitions with rule and check mappings
  • component-generate / component-assemble adds narrative responses
  • Assessment results from C2P can be imported back: trestle import -f assessment-results.json

Trestle does not run PVP checks. C2P runs those checks.

Supported PVP Types

PVP TypePolicy StyleExamples
DeclarativeDesired-state manifestsKubernetes (OCM, GateKeeper, Kyverno)
ImperativeStep-by-step scriptsAuditree (Python), Ansible playbooks
  • Declarative PVPs: C2P generates Kubernetes policy CRDs from component definitions
  • Imperative PVPs: C2P generates configuration files (example: auditree.json) with parameters

C2P Workflow Summary

# 1. Author component definitions with Trestle (rules + checks)
trestle task csv-to-oscal-cd

# 2. C2P generates PVP-specific configuration
#    (C2P reads component-definition.json, outputs PVP config)

# 3. PVP executes checks against target systems
#    (Auditree runs fetchers + checks, OCM distributes policies to clusters)

# 4. C2P collects results and produces OSCAL Assessment Results
#    (C2P reads PVP output, outputs assessment-results.json)

# 5. Import results back into Trestle workspace
trestle import -f assessment-results.json -o latest-scan

Additional Resources

  • personas-reference.md: Full persona details, CPAC topologies, C2P plugin interface, Auditree project structure
  • examples.md: Worked pipeline walkthroughs with complete command sequences

Cross-References

  • trestle-authoring-workflow: Generate/edit/assemble cycle details, multi-repo coordination
  • trestle-task-system: csv-to-oscal-cd configuration, CSV column reference, dual component definition CSV pattern
  • trestle-control-implementation: SSP control response writing, rules supply chain
  • trestle-oscal-models: OSCAL model types, relationships, and persona ownership

Keep looking

Skills are one crate of 611,178. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.