Skip to content

chore(adr): adopt ADR-0108 deep-dive deliverables rule (closes #38)#39

Merged
lusoris merged 1 commit intomasterfrom
chore/deep-dive-deliverables-rule
Apr 18, 2026
Merged

chore(adr): adopt ADR-0108 deep-dive deliverables rule (closes #38)#39
lusoris merged 1 commit intomasterfrom
chore/deep-dive-deliverables-rule

Conversation

@lusoris
Copy link
Copy Markdown
Owner

@lusoris lusoris commented Apr 18, 2026

Summary

  • Adopts the six deep-dive deliverables rule (ADR-0108) for every fork-local PR — research digest, decision matrix in the ADR, AGENTS.md invariant note, reproducer command, CHANGELOG.md "lusoris fork" entry, and rebase note.
  • Three project-fit adaptations from the sister-repo policy (per user direction):
  • New scaffolding: 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, --precision flag, Netflix golden gate, build pins, workspace relocations, license headers, .claude/ agent tree).
  • PR template grows a new "Deep-dive deliverables (ADR-0108)" section with the six checkboxes and a Reproducer code block.
  • 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

  • Research digest — no digest needed: trivial — this PR is the rule's adoption; the rationale lives in ADR-0108's ## Context and ## Alternatives considered.
  • Decision matrixdocs/adr/0108-deep-dive-deliverables-rule.md ## Alternatives considered (5 rows: verbatim port, feature-like-only, no-rule, mega-doc, no-backfill).
  • AGENTS.md invariant note — no rebase-sensitive invariants beyond the rule itself, which is captured by ADR-0108 + CLAUDE.md/AGENTS.md updates.
  • Reproducer / smoke-test command — see Reproducer below.
  • CHANGELOG.md "lusoris fork" entry### Changed → "Engineering process".
  • Rebase notedocs/rebase-notes.md entry 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

  • CI: docs-only change — confirm mkdocs strict build, link check, and lint jobs are green.
  • Manual: open docs/adr/0108-deep-dive-deliverables-rule.md — Status, Date, Deciders, Tags, References present; body reads as neutral English.
  • Manual: open docs/rebase-notes.md — 10 workstream entries with consistent format; ADR cross-links resolve.
  • Manual: open .github/PULL_REQUEST_TEMPLATE.md — six-deliverable section + Reproducer code block render correctly.
  • Manual: confirm CLAUDE.md §12 and AGENTS.md §12 carry the new rule.
  • Manual: re-read issue chore: adopt 'deep-dive deliverables' rule — document lusoris-fork-local deltas on top of upstream #38 on GitHub — body uses lusoris / fork, not cauda.

🤖 Generated with Claude Code

…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>
@lusoris lusoris merged commit d60e63a into master Apr 18, 2026
22 of 23 checks passed
@lusoris lusoris deleted the chore/deep-dive-deliverables-rule branch April 18, 2026 11:24
@github-actions github-actions Bot mentioned this pull request Apr 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

chore: adopt 'deep-dive deliverables' rule — document lusoris-fork-local deltas on top of upstream

1 participant