Skip to content

docs: expand ADRs 0001–0007 with verified APA 7th citations - #33

Draft
seonghobae wants to merge 1 commit into
mainfrom
cursor/expand-adr-apa-citations-c388
Draft

docs: expand ADRs 0001–0007 with verified APA 7th citations#33
seonghobae wants to merge 1 commit into
mainfrom
cursor/expand-adr-apa-citations-c388

Conversation

@seonghobae

@seonghobae seonghobae commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Status

Draft. Not Ready. Not to merge.

This pull request is documentation-only. Leave it as Draft. Do not mark Ready for review. Do not APPROVE. Do not merge.

Unstacked on live main (31fca92). Not based on open product PRs #26 or #30.

Summary

Expand the governing Architecture Decision Records so each accepted decision has Context, Decision, and Consequences plus an APA 7th-edition bibliography. Existing Decision intent is unchanged. README is untouched (customer/operator facing; not a bot manual). No product code, tests, workflows, CODEOWNERS, Semgrep, or package runtime changes.

Files changed

  • docs/adr/0001-source-authority.md
  • docs/adr/0002-model-proposals.md
  • docs/adr/0003-renderer-isolation.md
  • docs/adr/0004-authoritative-symbol-tree.md
  • docs/adr/0005-transport-neutral-lsp.md
  • docs/adr/0006-provider-neutral-orchestrator.md
  • docs/adr/0007-automation-authority.md
  • docs/adr/README.md
  • CHANGELOG.md

Verified sources (opened official records)

Cited only after opening the official record. Omitted candidates that could not be opened or that this repository does not use.

Source Official record opened Used in
Language Server Protocol 3.18 https://microsoft.github.io/language-server-protocol/specifications/lsp/3.18/specification/ ADR-0003, 0004, 0005
JSON-RPC 2.0 (updated 2013-01-04) https://www.jsonrpc.org/specification ADR-0005
NIST FIPS 180-4 Secure Hash Standard (August 2015) https://doi.org/10.6028/NIST.FIPS.180-4 → official PDF ADR-0001, 0002, 0006
PlantUML language site https://plantuml.com/ ADR-0001, 0003
PlantUML Language Reference Guide https://plantuml.com/guide ADR-0001, 0004
PlantUML command line (-pipe, -nometadata, -stdrpt; beta CLI not treated as final) https://plantuml.com/command-line ADR-0003
PlantUML security profiles including SANDBOX https://plantuml.com/security ADR-0003
PlantUML class diagram https://plantuml.com/class-diagram ADR-0004
PlantUML sequence diagram https://plantuml.com/sequence-diagram ADR-0004
RFC 8259 JSON (December 2017) https://doi.org/10.17487/RFC8259 → RFC Editor catalog ADR-0002, 0005, 0006
RFC 3986 URI generic syntax (2005) https://doi.org/10.17487/RFC3986 → RFC Editor catalog ADR-0005
GitHub about protected branches https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches ADR-0007

Opened but not cited

  • OASIS SARIF 2.1.0 Plus Errata 01 (https://docs.oasis-open.org/sarif/sarif/v2.1.0/errata01/os/sarif-v2.1.0-errata01-os-complete.html) — already named in research/operations docs; the renderer decision does not implement SARIF export.
  • W3C SVG — omitted because the renderer contract describes SVG/PNG validation but does not cite the W3C Recommendation.
  • OpenAPI — omitted; not used by the repository.
  • NIST CSRC FIPS 180-4 HTML catalog (/pubs/fips/180-4/upd1/final) — fetch timed out; the DOI-resolved official FIPS PDF was opened instead.

Out of scope

Verification

  • git diff origin/main --name-only is only the nine files listed above.
  • node --test tests/documentation-contract.test.js — 5 passed, 0 failed.

This description is the deliverable. Do not treat a PR review comment as the handoff. Leave Draft. Do not mark Ready. Do not APPROVE. Do not merge.

Open in Web Open in Cursor 

Add Context, Decision, and Consequences to the governing ADRs while
preserving each accepted decision. Cite only official records that were
opened for this change (DOI or publisher catalog URL).

Co-authored-by: Seongho Bae <seonghobae@users.noreply.github.com>
@coderabbitai

coderabbitai Bot commented Aug 24, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

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.

2 participants