Instruction file imported from Rawlings/autoremediator (.github/instructions/report-evidence-evolution.instructions.md). Copyright stays with the author.

Report and Evidence Evolution

Name: report-evidence-evolution
Author: Rawlings

Scope

Changes to report fields, CI summaries, or evidence output must remain deterministic and backward-aware.

Stability Rules

Preserve schemaVersion: "1.0" unless formal migration is approved.
Prefer additive fields over renames/removals.
Keep machine-readable summary fields stable (strategyCounts, dependencyScopeCounts, unresolvedByReason).
Ensure unresolved/failure semantics remain explicit.

Required Updates

When report/evidence fields change:

Update shared types.
Update affected API/CLI/MCP/OpenAPI surfaces.
Update docs references in api-sdk.md, cli.md, and policy-and-safety.md.
Update changelog entries with user-visible impact.

Guardrails

Never hide failures by coercing unresolved outcomes into success.
Do not introduce silent field semantics changes.
Keep CI-facing outputs deterministic and machine-readable.

Verification

Ensure tests cover new/changed report semantics.
Ensure docs describe field intent and expected values.

{ "ocm": "1", "id": "rawlings-autoremediator-report-evidence-evolution-instructions", "kind": "skill", "name": "report-evidence-evolution", "description": "Stability and evolution rules for remediation reports, CI summaries, and evidence artifacts.", "publisher": "Rawlings", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-instructions" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Stability and evolution rules for remediation reports, CI summaries, and evidence artifacts." ], "primary": false, "metadata": { "source": { "provider": "github-instructions", "repository": "https://github.com/Rawlings/autoremediator", "path": ".github/instructions/report-evidence-evolution.instructions.md", "ref": "52aa7e7be300339f26441be9d98be8fa0cf7bab3", "url": "https://github.com/Rawlings/autoremediator/blob/52aa7e7be300339f26441be9d98be8fa0cf7bab3/.github/instructions/report-evidence-evolution.instructions.md", "key": "Rawlings/autoremediator/.github/instructions/report-evidence-evolution.instructions.md" }, "applies_to": "packages/core/src/{platform,api,cli,mcp,openapi}/**/*.ts,packages/docs/content/{api-sdk,cli,policy-and-safety,changelog}.md" }, "instructions": "# Report and Evidence Evolution\n\n## Scope\n\nChanges to report fields, CI summaries, or evidence output must remain deterministic and backward-aware.\n\n## Stability Rules\n\n- Preserve `schemaVersion: \"1.0\"` unless formal migration is approved.\n- Prefer additive fields over renames/removals.\n- Keep machine-readable summary fields stable (`strategyCounts`, `dependencyScopeCounts`, `unresolvedByReason`).\n- Ensure unresolved/failure semantics remain explicit.\n\n## Required Updates\n\nWhen report/evidence fields change:\n\n- Update shared types.\n- Update affected API/CLI/MCP/OpenAPI surfaces.\n- Update docs ", "cost": { "context_tokens": 260 } }

report-evidence-evolution

About

Report and Evidence Evolution

Scope

Stability Rules

Required Updates

Guardrails

Verification

Use it

Manifest

Reviews