README.md and the handbook: the by-hand setup steps dry-run the scaffold without the --visibility and --elected-by that setup passes

One README and handbook change; one blob regeneration covers both lines.

From the v1.1.0 triage of the v1.0.0 known limits on #461. One pull request covers the lines below.

Lines

README's by-hand setup steps dry-run the scaffold without the --visibility and --elected-by setup passes. Where: README.md:530-532; setup-project.py:1868-1885. Effort S; all. On main 3121945: A false doc the user recovers from: scaffold_args always passes --visibility and --elected-by and the plan runs them with --dry-run, while README:530 under "These are the commands that flow runs" shows neither. (source)

Rides along (backlog; tick it here if the same change covers it)

README.md (:1081-1084) and docs/handbook.html (:1388) say update-shape.py apply --add refuses a path that is already pinned, one the target's lists do not name and one the root already has a file at, and omit update-add-symlink (#269, on main) and, once #346 lands, update-add-not-a-directory, so a reader meets a refusal no document names; the README is at its line cap and the handbook records its blob, so the clause is a README edit plus a handbook regeneration #429

Order: After #519.

Each line above is marked → this issue on its tracking issue. Tick it there too when this closes.

The lines as written on the tracking issues

AT-scaffold N4: README's by-hand version of what setup runs (README.md:531-533) dry-runs scaffold-project.py --org <your-org> --project Atlas --dry-run without the --visibility and --elected-by of the real run on the next line, while setup's own dry run passes both (setup-project.py:1587-1604), so the plan a person reads names a different elector than the real run writes. (#483's accuracy pass may correct this first.)
— #461, body

CLAIMED — lane openRepoShape-3, session b30e8b49-f249-4668-adb1-1dbfa93c09e1@Eagle, 2026-10-14T22:33:17Z, for #550

Logged in lanes/log/openRepoShape-3.md at f3febd3d7173a352c0b3b5ded00bbdabc86ec843.

The three reads (lane-collision-protocol Rule 1):

1. existing `CLAIMED —` comments on opensoft/openRepoShape#550:
   none
2. `gh pr list --repo opensoft/openRepoShape --state all --search "#550"`, kept where the row or its body names `#550`:
   none
3. `git ls-remote --heads git@github.com:opensoft/openRepoShape` branches naming `550` as a whole token:
   none

README.md and the handbook: `apply --add`'s refusal for a file where …

README.md and the handbook: the by-hand setup commands dry-run the sc…

merge: origin/main fb786c1 (eleven landed PRs since 7d9bec9, #579's b…

tests/test_setup_by_hand_commands.py: `what_setup_runs` asserts the r…

setup-project.py: paste lines quote each path, the scaffold's NEXT ST…

Navigation Menu

Repository navigation

README.md and the handbook: the by-hand setup steps dry-run the scaffold without the `--visibility` and `--elected-by` that setup passes #550

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

README.md and the handbook: the by-hand setup steps dry-run the scaffold without the --visibility and --elected-by that setup passes #550

Description

Activity

brettheap commented on Oct 14, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions

README.md and the handbook: the by-hand setup steps dry-run the scaffold without the `--visibility` and `--elected-by` that setup passes #550