diff-engine

Change comparison rules, severity, identity matching, or change correlation. Use when diffs look wrong, a capability needs a new ComparisonRule, or clustering/timeline is involved.

Jump to install

Repository: hoangsonww/Diffuse-Native-Apps
Last source activity: August 20, 2026 at 04:16
Detected SKILL.md language: English
Stars: 1
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/hoangsonww/Diffuse-Native-Apps --skill diff-engine

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

name	diff-engine
description	Change comparison rules, severity, identity matching, or change correlation. Use when diffs look wrong, a capability needs a new ComparisonRule, or clustering/timeline is involved.

Diff engine

The engine is generic. Capabilities declare ComparisonRule and ChangeSeverity on property descriptors. Do not add if capability == .docker branches.

ValueComparator is the only place two readings are judged "the same".
Identity matching is EntityIdentity (normalized value + kind + optional scope). Path identities use EntityIdentity.path.
diff(A, A) is empty. Reverse diffs swap added/removed counts. Property tests in Packages/DiffuseDiff/Tests and Tests/Invariants guard this.
Severity can escalate on a major version jump; do not special-case tools by name.
Correlation (ChangeCorrelator) groups by time window, not by inference.

Read Documentation/DiffEngine.md and Documentation/adr/0003-schema-driven-diff.md.

After changes: swift test --filter DiffuseDiffTests and swift test --filter DiffuseInvariantTests.

Back to search Back to installation

screenshots

Regenerate docs/screenshots from the live apps. Use when UI changed and README/docs images are stale, or the user asks for new screenshots.

2026-09-03

native-apps

Change Mac, iOS, iPad, or Watch UI that sits on DiffuseUI. Use when a screen, widget, complication, or menu-bar extra is involved.

2026-08-22

coverage

Generate first-party Swift package coverage (llvm-cov HTML, lcov, text summary). Use when the user asks for coverage, after expanding Tests/, or before claiming test work is done.

2026-08-20

View all from this repository

name	diff-engine
description	Change comparison rules, severity, identity matching, or change correlation. Use when diffs look wrong, a capability needs a new ComparisonRule, or clustering/timeline is involved.

Diff engine

The engine is generic. Capabilities declare ComparisonRule and ChangeSeverity on property descriptors. Do not add if capability == .docker branches.

ValueComparator is the only place two readings are judged "the same".
Identity matching is EntityIdentity (normalized value + kind + optional scope). Path identities use EntityIdentity.path.
diff(A, A) is empty. Reverse diffs swap added/removed counts. Property tests in Packages/DiffuseDiff/Tests and Tests/Invariants guard this.
Severity can escalate on a major version jump; do not special-case tools by name.
Correlation (ChangeCorrelator) groups by time window, not by inference.

Read Documentation/DiffEngine.md and Documentation/adr/0003-schema-driven-diff.md.

After changes: swift test --filter DiffuseDiffTests and swift test --filter DiffuseInvariantTests.

diff-engine

Source facts

Install options

Review the source files

Diff engine

More from this repository

Diff engine

More from this repository