Skip to content

Commit 0340b4a

Browse files
committed
Update living docs for the .github/CLAUDE.md retirement
Drop the retired path from the generated-tree inventory and the file contract; record its retired ownership. Remove the rollout step that re-adds the obsolete symlink rule. Frozen gate records pinned to bdfffb9 stay untouched. Signed-off-by: Alexey Zhokhov <[email protected]>
1 parent b5232ac commit 0340b4a

3 files changed

Lines changed: 7 additions & 6 deletions

File tree

‎docs/content/development/rust-policy-rollout.mdx‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -236,9 +236,10 @@ unmoved `*_tests.rs`.
236236

237237
### Step 7 — Reconciliation + merge
238238

239-
- Re-add Velnor-specific adapter-local rules (CLAUDE symlink,
240-
AGENTS caps, required-files) as decided in Slice 1 notes;
241-
confirm overlap/dangling rules stay dropped.
239+
- Re-add Velnor-specific adapter-local rules (AGENTS caps,
240+
required-files) as decided in Slice 1 notes; the retired
241+
`.github/CLAUDE.md` path stays dropped, never re-added.
242+
Confirm overlap/dangling rules stay dropped.
242243
- Full check green: 37/37 native + 0 gaps. Branch CI green.
243244
Merge `rust-policy-rollout` → `main` (explicit instruction only).
244245

‎docs/implemented/classification.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,8 @@ review; the row must name a verification rule that actually runs.
1616
| Version-policy mirror + inventory | `.velnor/version-policy.toml`, `.velnor/freshness-inventory.json` | repo maintainers | `repo_policy_mirror_matches_compiled_catalog`; `scripts/check-freshness.sh` |
1717
| Alint baseline | none — no `.alint-baseline.json` at HEAD | repo maintainers | §5 limits are hard errors; no grandfathering ([update-procedure.md](update-procedure.md)) |
1818
| Test fixtures (committed inputs) | `fixtures/**` | owning crate's tests | Excluded from Alint's walked index (`.alint.yml` `ignore:`); each fixture dir carries a `README.md` stating intent |
19-
| Generated CI tree | `.github/workflows/ci.yml`, `.github/actionlint.yaml`, `.github/AGENTS.md`, `.github/CLAUDE.md` | generator (`velnor-actions` binary, generator version in header marker) | First-line version marker, no dates; regen must be byte-identical (RQ-1.9); validated by actionlint+zizmor before replace; inventory/condition edits are security-sensitive and review-gated (repo `CODEOWNERS` + branch protection — D7: the merge cannot distinguish regen from tampering, review is the trust root) |
19+
| Generated CI tree | `.github/workflows/ci.yml`, `.github/actionlint.yaml`, `.github/AGENTS.md` | generator (`velnor-actions` binary, generator version in header marker) | First-line version marker, no dates; regen must be byte-identical (RQ-1.9); validated by actionlint+zizmor before replace; inventory/condition edits are security-sensitive and review-gated (repo `CODEOWNERS` + branch protection — D7: the merge cannot distinguish regen from tampering, review is the trust root) |
20+
| Retired generator-owned paths | `.github/CLAUDE.md` | generator (retired, never re-emitted) | No longer emitted; the preserve-copy skips retired paths so the whole-tree swap deletes stale copies on regen |
2021
| Generator preview output | `$RUNNER_TEMP/.../.github/**` (never committed) | ephemeral, CI job | Byte-compared against in-place render; outside repo root |
2122
| Vendored code | none in V1 | — | No vendored sources exist. If added, each needs a row: upstream, pinned revision, sync procedure |
2223
| Build artifacts | `target/`, `mutants.out/` (gitignored, never committed) | ephemeral | Not classified: never reviewed, never shipped |

‎docs/proposed/generated-file-contract.md‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,6 @@ preserves other repository-owned entries as specified in §3:
1010
```text
1111
.github/
1212
├── AGENTS.md
13-
├── CLAUDE.md -> AGENTS.md
1413
├── actionlint.yaml
1514
├── release-plz-bootstrap.toml # consumer-v1 only, release enabled
1615
├── release-plz.toml # consumer-v1 only, release enabled
@@ -43,7 +42,7 @@ block (least privilege for its role); see [workflow
4342
|---|---|---|---|
4443
| .github/actionlint.yaml | velnor-actions-actionlint | velnor-actions-orchestrator | Exact generated path; replaced on generation |
4544
| .github/AGENTS.md | velnor-actions-workflow-renderer | velnor-actions-orchestrator | Exact generated path; version marker; replaced on generation |
46-
| .github/CLAUDE.md | velnor-actions-workflow-renderer | velnor-actions-orchestrator | Exact generated symlink to AGENTS.md; replaced on generation |
45+
| .github/CLAUDE.md | velnor-actions-workflow-renderer | velnor-actions-orchestrator | Retired: never emitted; stays generator-owned so regeneration deletes stale copies |
4746
| .github/workflows/** | velnor-actions-workflow-renderer | velnor-actions-orchestrator | Reserved generator-owned namespace; every path is replaced or retired on successful generation |
4847
| .github/release-plz*.toml | velnor-actions-workflow-renderer | velnor-actions-orchestrator | Exact generated release-plz config paths; retired when no longer emitted |
4948
| .github/actions/<logical>/action.yml | velnor-actions-workflow-renderer | velnor-actions-orchestrator | Generated shared action path is owned when its first line has a Velnor generated marker; replaced or retired with dispatch output |

0 commit comments

Comments
 (0)