Back to skills
extension
Category: Development & EngineeringNo API key required

loom-docs-merge-conflicts

Resolve git merge conflicts in compound-managed LOOM docs (LOOM_CHANGELOG.md, LOOM_ROADMAP.md) without breaking BEGIN/END fences.

personAuthor: jakexiaohubgithub
<!-- BEGIN:compound:skill-managed -->

Purpose

Resolve merge conflicts in compound-managed LOOM docs without breaking compound fences.

When To Use

  • You see <<<<<<<, =======, or >>>>>>> in LOOM_CHANGELOG.md or LOOM_ROADMAP.md.
  • A merge/rebase touched compound-managed blocks and left conflicts.

Procedure

  • Open the conflicted file and locate every conflict hunk.
  • Preserve the compound fences exactly:
    • Keep <!-- BEGIN:compound:... --> and <!-- END:compound:... --> lines unchanged.
    • Do not duplicate or reorder fence lines.
  • For conflicted list entries inside fences:
    • Prefer keeping both sides' entries, then dedupe exact duplicates.
    • Maintain consistent bullet formatting: - <timestamp> <note>.
    • Keep ordering stable (typically newest-first if the file already uses that pattern).
  • Remove all conflict marker lines (<<<<<<<, =======, >>>>>>>) after selecting the final content.
  • Sanity check:
    • No conflict markers remain.
    • Markdown renders as a single list (no nested accidental - - unless the file intentionally uses it).
    • The file contains exactly one BEGIN and one END for each compound block.
  • Run docs sync to refresh derived indexes/managed blocks (so downstream agents don’t learn from broken docs).
<!-- END:compound:skill-managed -->

Manual notes

This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here.