chore(adr): adopt ADR-0108 deep-dive deliverables rule (closes #38)#39
Merged
chore(adr): adopt ADR-0108 deep-dive deliverables rule (closes #38)#39
Conversation
…ase notes Closes #38. Every fork-local PR now ships the six deep-dive deliverables (research digest, decision matrix in the ADR, AGENTS.md invariant note, reproducer command, CHANGELOG fork-section entry, rebase note). Adapted from the sibling-repo policy, with three project-fit changes per user direction: - Naming: "cauda" (a personal-domain term that leaked from the porting agent) is replaced throughout with "lusoris" / "fork", matching the rest of this fork's naming (versioning, copyright, branch names). The GitHub issue body was also redacted on the same grounds. - Changelog: reuse the existing CHANGELOG.md "lusoris fork" section rather than introducing a parallel CHANGELOG-cauda.md that would drift. - Trigger scope: any fork-local PR (not only feature-like changes), with the existing backlog backfilled in the same adoption PR. New scaffolding: - docs/adr/0108-deep-dive-deliverables-rule.md - docs/research/{README.md,0000-template.md} (digest tree, empty index) - docs/rebase-notes.md (backfilled with 10 grouped workstream entries) - .github/PULL_REQUEST_TEMPLATE.md (six-deliverable checklist) - CLAUDE.md §12 rule 11 + AGENTS.md §12 rule 9 - docs/adr/README.md (new index row) - CHANGELOG.md (engineering-process bullet) Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
AGENTS.mdinvariant note, reproducer command,CHANGELOG.md"lusoris fork" entry, and rebase note.cauda→lusoris/forkeverywhere (and on issue chore: adopt 'deep-dive deliverables' rule — document lusoris-fork-local deltas on top of upstream #38 itself), matching this fork's existing naming (versioning, copyright, branch names).CHANGELOG.md"lusoris fork" section rather than a separateCHANGELOG-cauda.md.docs/research/(digest tree + template + empty index),docs/rebase-notes.md(10 grouped workstream entries backfilled — SIMD double-precision accumulation, CUDA ADM decouple-inline, SYCL pool/D3D11/picture-pool, DNN runtime,--precisionflag, Netflix golden gate, build pins, workspace relocations, license headers,.claude/agent tree).CLAUDE.md§12 gets rule 11;AGENTS.md§12 gets rule 9 (mirror); ADR README index gains the row for ADR-0108.Closes
Closes #38.
Deep-dive deliverables (ADR-0108) — for this PR
## Contextand## Alternatives considered.docs/adr/0108-deep-dive-deliverables-rule.md## Alternatives considered(5 rows: verbatim port, feature-like-only, no-rule, mega-doc, no-backfill).AGENTS.mdinvariant note — no rebase-sensitive invariants beyond the rule itself, which is captured by ADR-0108 + CLAUDE.md/AGENTS.md updates.CHANGELOG.md"lusoris fork" entry —### Changed→ "Engineering process".docs/rebase-notes.mdentry 0010 (".claude/agent scaffolding + ADR tree + AGENTS.md / CLAUDE.md") covers the policy-tree itself; the nine workstream backfills also land in this PR.Reproducer
```bash
1. Confirm ADR-0108 + scaffolding render in mkdocs without broken links
mkdocs build --strict
2. Confirm the new ADR file is indexed
grep -n "ADR-0108" docs/adr/README.md
3. Confirm the PR template now carries the six-deliverable section
grep -n "Deep-dive deliverables" .github/PULL_REQUEST_TEMPLATE.md
```
Test plan
docs/adr/0108-deep-dive-deliverables-rule.md— Status, Date, Deciders, Tags, References present; body reads as neutral English.docs/rebase-notes.md— 10 workstream entries with consistent format; ADR cross-links resolve..github/PULL_REQUEST_TEMPLATE.md— six-deliverable section + Reproducer code block render correctly.CLAUDE.md§12 andAGENTS.md§12 carry the new rule.lusoris/fork, notcauda.🤖 Generated with Claude Code