Files
josh-sync/docs/adr
Slim B 8ab07b83ab Update docs, changelog, examples, and add ADRs for v1.2
- Add v1.1.0 and v1.2.0 changelog entries
- Add exclude field to config reference and example config
- Add ADRs documenting all major design decisions
- Fix step numbering in reverse_sync()
- Fix action.yml to copy VERSION file
- Add dist/ and .env to .gitignore
- Use refs/tags/ format for Nix flake tag refs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-14 21:28:40 +03:00
..

Architecture Decision Records

This directory contains Architecture Decision Records (ADRs) for josh-sync. Each ADR documents a significant design decision, its context, the alternatives considered, and the rationale for the chosen approach.

Index

ADR Title Status
001 Josh-proxy for bidirectional sync Accepted
002 State storage on orphan git branch Accepted
003 Force-with-lease for forward sync Accepted
004 Always-PR policy for reverse sync Accepted
005 Git trailer for loop prevention Accepted
006 Inline exclude in josh-proxy URL Accepted
007 Reconciliation merge for filter changes Accepted
008 First-parent ordering in reconciliation merges Accepted
009 Tree comparison as sync skip guard Accepted
010 Onboard workflow with checkpoint/resume Accepted