# Workflow Contracts

> Skill for the Workflow-contracts area of paddock. 51 symbols across 11 files.

- Skill: `racecraft-lab/workflow-contracts` (Agent Skill)
- Install (CLI): `npx skillmds@latest add racecraft-lab/workflow-contracts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/racecraft-lab/workflow-contracts/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: racecraft-lab (https://skillmd.com/u/racecraft-lab)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/racecraft-lab/workflow-contracts

---


# Workflow-contracts

51 symbols | 11 files | Cohesion: 84%

## When to Use

- Working with code in `src/`
- Understanding how validateWorkflowContract, createWorkflowContractAjv, workflowContractError work
- Modifying workflow-contracts-related functionality

## Key Files

| File | Symbols |
|------|---------|
| `scripts/workflow-contracts/workflow-contract-cli.ts` | parseWorkflowContractCliArgs, parseFlags, main, tsModule, openWorkflowContractDatabase (+3) |
| `src/lib/workflow-contracts/validator.ts` | validateWorkflowContract, validateTemplate, validateVariables, validateTracker, validateStringArray (+2) |
| `src/lib/workflow-contracts/hash.ts` | sha256, stableStringify, computeContractHash, computeTemplateHashes, stabilize (+2) |
| `src/lib/workflow-contracts/exporter.ts` | exportWorkflowContractMarkdown, buildExportContract, readLatestSnapshot, overlayRuntimeFields, runtimeToTemplate (+1) |
| `src/lib/workflow-contracts/recovery.ts` | recoverLastKnownGood, applyRecovery, parseCanonicalTemplateSlugs, runtimeToTemplate, parseJson |
| `src/lib/workflow-contracts/importer.ts` | upsertTemplate, importWorkflowContract, selectRuntimeTemplates, selectOwnedRuntimeTemplates |
| `src/lib/workflow-contracts/diff.ts` | diffWorkflowTemplates, isWorkflowContractOwned, templateMatchesRuntime, parseJson |
| `src/lib/workflow-contracts/yaml-loader.ts` | loadWorkflowContractFromFile, loadWorkflowContractFromString, rejectUnsafeYamlSyntax, normalizePromptLineEndings |
| `src/lib/workflow-contracts/diagnostics.ts` | createWorkflowContractRun, countDiff, recordWorkflowContractErrors |
| `src/lib/workflow-contracts/errors.ts` | workflowContractError, redactDetails |

## Entry Points

Start here when exploring this area:

- **`validateWorkflowContract`** (Function) — `src/lib/workflow-contracts/validator.ts:17`
- **`createWorkflowContractAjv`** (Function) — `src/lib/workflow-contracts/schema.ts:2`
- **`workflowContractError`** (Function) — `src/lib/workflow-contracts/errors.ts:23`
- **`sha256`** (Function) — `src/lib/workflow-contracts/hash.ts:13`
- **`stableStringify`** (Function) — `src/lib/workflow-contracts/hash.ts:17`

## Key Symbols

| Symbol | Type | File | Line |
|--------|------|------|------|
| `validateWorkflowContract` | Function | `src/lib/workflow-contracts/validator.ts` | 17 |
| `createWorkflowContractAjv` | Function | `src/lib/workflow-contracts/schema.ts` | 2 |
| `workflowContractError` | Function | `src/lib/workflow-contracts/errors.ts` | 23 |
| `sha256` | Function | `src/lib/workflow-contracts/hash.ts` | 13 |
| `stableStringify` | Function | `src/lib/workflow-contracts/hash.ts` | 17 |
| `computeContractHash` | Function | `src/lib/workflow-contracts/hash.ts` | 21 |
| `computeTemplateHashes` | Function | `src/lib/workflow-contracts/hash.ts` | 25 |
| `exportWorkflowContractMarkdown` | Function | `src/lib/workflow-contracts/exporter.ts` | 6 |
| `redactDetails` | Function | `src/lib/workflow-contracts/errors.ts` | 9 |
| `recoverLastKnownGood` | Function | `src/lib/workflow-contracts/recovery.ts` | 5 |
| `applyRecovery` | Function | `src/lib/workflow-contracts/recovery.ts` | 51 |
| `upsertTemplate` | Function | `src/lib/workflow-contracts/importer.ts` | 96 |
| `createWorkflowContractRun` | Function | `src/lib/workflow-contracts/diagnostics.ts` | 18 |
| `importWorkflowContract` | Function | `src/lib/workflow-contracts/importer.ts` | 7 |
| `selectRuntimeTemplates` | Function | `src/lib/workflow-contracts/importer.ts` | 87 |
| `selectOwnedRuntimeTemplates` | Function | `src/lib/workflow-contracts/importer.ts` | 91 |
| `diffWorkflowTemplates` | Function | `src/lib/workflow-contracts/diff.ts` | 3 |
| `isWorkflowContractOwned` | Function | `src/lib/workflow-contracts/diff.ts` | 41 |
| `recordWorkflowContractErrors` | Function | `src/lib/workflow-contracts/diagnostics.ts` | 43 |
| `parseWorkflowContractCliArgs` | Function | `scripts/workflow-contracts/workflow-contract-cli.ts` | 10 |

## How to Explore

1. `gitnexus_context({name: "validateWorkflowContract"})` — see callers and callees
2. `gitnexus_query({query: "workflow-contracts"})` — find related execution flows
3. Read key files listed above for implementation details