Skip to content

Commit 75ddc7d

Browse files
rldyourmndclaude
andcommitted
docs(flow): define ry-repair consumer mode for config repositories
In the rldyour control plane or an adapter configuration repository, when the goal is converging the installed system, /ry-repair now runs in consumer mode: update the checkout FROM GitHub (ff-only pull and submodule update), run the check and system-apply paths, and never author changes into the repository (no commits, no doc/contract/memory edits, no fullrepo publication). Fast-forward failures or detected repository drift are reported and switch to authoring repair only on explicit owner instruction. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 9d33027 commit 75ddc7d

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

  • plugins/rldyour-flow/skills/ry-repair

plugins/rldyour-flow/skills/ry-repair/SKILL.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,18 @@ Normalize a repository so Codex, Claude Code, and OpenCode can work from the sam
1111

1212
For rldyour AI CLI configuration repositories, `/ry-repair` also owns deterministic install/update/sync convergence: local repository state, system Claude/Codex/OpenCode configs, Serena memories, and GitHub/fullrepo state must be checked through the root `config/ry-repair-sync-contract.json` and `scripts/ry_repair_sync.py` contract before being reported as synchronized.
1313

14+
## Mode Selection
15+
16+
- **Work project**: run the full authoring repair workflow below.
17+
- **rldyour control plane or adapter config repo, goal = converge the installed
18+
system**: run consumer mode instead - update the checkout FROM GitHub
19+
(`git pull --ff-only`, `git submodule update --init --recursive`), then
20+
`python3 scripts/ry_repair_sync.py --check` and `--apply --install-system`.
21+
In consumer mode do NOT author changes into the repository: no commits, no
22+
doc/contract/memory edits, no fullrepo publication. If fast-forward fails or
23+
validators reveal repository drift, report it and switch to authoring repair
24+
only on explicit owner instruction.
25+
1426
## Workflow
1527

1628
1. Detect repository type, active branch/worktree, submodules, CI surface, and effective project policy from `RLDYOUR_PROJECT_POLICY`, `.rldyour/project-policy.local.json`, `.rldyour/project-policy.json`, or built-in defaults.

0 commit comments

Comments
 (0)