Compliance Fix Worker
NOTE: Startup and cleanup are handled by worker-base. This skill defines the WORK PROCEDURE.
When to Use This Skill
Features that involve:
- Fixing test failures (unit, framework, integration, audit)
- Updating configuration files (agent-skill-matrix.json, routing tables, settings.json)
- Resolving validation failures (validate:full, metrics:ci, format:check)
- Fixing compliance gaps (missing skills in agent arrays, hardcoded counts, ghost entries)
- Backward compatibility fixes (dual skill name support)
Work Procedure
Read the feature description carefully. Identify every file that needs changing and every test that must pass.
Run the SPECIFIC failing tests first to capture exact error messages:
node --test <specific-test-file>
Record the exact assertion failures.
Write or update tests BEFORE fixing (TDD red-green):
- If the fix requires new test cases (e.g., testing both compressor names), add them first
- Confirm they fail (red)
- Then implement the fix
Implement the fix. Follow CTO directives from AGENTS.md strictly:
- Directive 1: Both
context-compressor AND token-saver-context-compression must be accepted
- Read existing patterns in similar files before writing new code
- Use
safeParseJSON for all JSON parsing
Run targeted tests to confirm your fix works:
node --test <specific-test-file>
Run broader test suites to check for regressions:
pnpm test
pnpm test:framework
If either shows new failures, debug and fix before proceeding.
Run validators relevant to your changes:
pnpm validate:full
pnpm validate:routing
pnpm metrics:ci
pnpm format:check
Commit with a descriptive message.
Example Handoff
{
"salientSummary": "Fixed agent-skill-matrix.json: added 31 missing agents, injected token-saver-context-compression into all 119 always arrays. Updated pre-tool-unified.read-safety.cjs to accept both compressor names. Updated agent count test from 110 to 119. Ran pnpm test (9000 pass/0 fail), pnpm test:framework (3250 pass/0 fail), pnpm validate:full (exit 0).",
"whatWasImplemented": "Added 31 missing agents to agent-skill-matrix.json with correct category assignments and always arrays. Modified read-safety hook lines 168-169 to accept both 'context-compressor' and 'token-saver-context-compression'. Updated expected count constant in agent-search-compliance.test.cjs from 110 to 119.",
"whatWasLeftUndone": "",
"verification": {
"commandsRun": [
{
"command": "node --test tests/hooks/pre-tool-unified-read-safety.test.cjs",
"exitCode": 0,
"observation": "All 18 tests pass including both compressor name cases"
},
{
"command": "node --test tests/audit/agent-search-compliance.test.cjs",
"exitCode": 0,
"observation": "Agent count matches 119, all compliance checks pass"
},
{ "command": "pnpm test", "exitCode": 0, "observation": "9000+ tests, 0 failures" },
{ "command": "pnpm test:framework", "exitCode": 0, "observation": "3250+ tests, 0 failures" },
{ "command": "pnpm validate:full", "exitCode": 0, "observation": "All validators pass" }
],
"interactiveChecks": []
},
"tests": {
"added": [
{
"file": "tests/hooks/pre-tool-unified-read-safety.test.cjs",
"cases": [
{ "name": "accepts token-saver-context-compression", "verifies": "backward compat" }
]
}
],
"coverage": "All read-safety, compliance, and routing tests pass"
},
"discoveredIssues": []
}
When to Return to Orchestrator
- A fix requires changing files outside the feature's scope
- A test failure has an unclear root cause after 15 minutes of investigation
- A CTO directive is ambiguous for the specific case encountered
- Fixing one area introduces failures in another that can't be resolved within this feature
1---2name: compliance-fix-worker3description: Fixes test failures, compliance gaps, and validation issues in the agent-studio ecosystem4metadata:5 source: https://skillmd.com/skills/oimiragieo/compliance-fix-worker6---78# Compliance Fix Worker910NOTE: Startup and cleanup are handled by `worker-base`. This skill defines the WORK PROCEDURE.1112## When to Use This Skill1314Features that involve:1516- Fixing test failures (unit, framework, integration, audit)17- Updating configuration files (agent-skill-matrix.json, routing tables, settings.json)18- Resolving validation failures (validate:full, metrics:ci, format:check)19- Fixing compliance gaps (missing skills in agent arrays, hardcoded counts, ghost entries)20- Backward compatibility fixes (dual skill name support)2122## Work Procedure23241. **Read the feature description carefully.** Identify every file that needs changing and every test that must pass.25262. **Run the SPECIFIC failing tests first** to capture exact error messages:2728 ```29 node --test <specific-test-file>30 ```3132 Record the exact assertion failures.33343. **Write or update tests BEFORE fixing** (TDD red-green):35 - If the fix requires new test cases (e.g., testing both compressor names), add them first36 - Confirm they fail (red)37 - Then implement the fix38394. **Implement the fix.** Follow CTO directives from AGENTS.md strictly:40 - Directive 1: Both `context-compressor` AND `token-saver-context-compression` must be accepted41 - Read existing patterns in similar files before writing new code42 - Use `safeParseJSON` for all JSON parsing43445. **Run targeted tests** to confirm your fix works:4546 ```47 node --test <specific-test-file>48 ```49506. **Run broader test suites** to check for regressions:5152 ```53 pnpm test54 pnpm test:framework55 ```5657 If either shows new failures, debug and fix before proceeding.58597. **Run validators** relevant to your changes:6061 ```62 pnpm validate:full63 pnpm validate:routing64 pnpm metrics:ci65 pnpm format:check66 ```67688. **Commit** with a descriptive message.6970## Example Handoff7172```json73{74 "salientSummary": "Fixed agent-skill-matrix.json: added 31 missing agents, injected token-saver-context-compression into all 119 always arrays. Updated pre-tool-unified.read-safety.cjs to accept both compressor names. Updated agent count test from 110 to 119. Ran pnpm test (9000 pass/0 fail), pnpm test:framework (3250 pass/0 fail), pnpm validate:full (exit 0).",75 "whatWasImplemented": "Added 31 missing agents to agent-skill-matrix.json with correct category assignments and always arrays. Modified read-safety hook lines 168-169 to accept both 'context-compressor' and 'token-saver-context-compression'. Updated expected count constant in agent-search-compliance.test.cjs from 110 to 119.",76 "whatWasLeftUndone": "",77 "verification": {78 "commandsRun": [79 {80 "command": "node --test tests/hooks/pre-tool-unified-read-safety.test.cjs",81 "exitCode": 0,82 "observation": "All 18 tests pass including both compressor name cases"83 },84 {85 "command": "node --test tests/audit/agent-search-compliance.test.cjs",86 "exitCode": 0,87 "observation": "Agent count matches 119, all compliance checks pass"88 },89 { "command": "pnpm test", "exitCode": 0, "observation": "9000+ tests, 0 failures" },90 { "command": "pnpm test:framework", "exitCode": 0, "observation": "3250+ tests, 0 failures" },91 { "command": "pnpm validate:full", "exitCode": 0, "observation": "All validators pass" }92 ],93 "interactiveChecks": []94 },95 "tests": {96 "added": [97 {98 "file": "tests/hooks/pre-tool-unified-read-safety.test.cjs",99 "cases": [100 { "name": "accepts token-saver-context-compression", "verifies": "backward compat" }101 ]102 }103 ],104 "coverage": "All read-safety, compliance, and routing tests pass"105 },106 "discoveredIssues": []107}108```109110## When to Return to Orchestrator111112- A fix requires changing files outside the feature's scope113- A test failure has an unclear root cause after 15 minutes of investigation114- A CTO directive is ambiguous for the specific case encountered115- Fixing one area introduces failures in another that can't be resolved within this feature