Fluid/fluidpop-v1
1
0
Fork 0
Code Issues 17 Pull requests Projects Releases Packages Wiki Activity Actions

docs(adr): open ADR-001..ADR-015 as draft architectural decisions #10

Merged
navigator merged 1 commit from feature/initial-adrs into main 2026-05-24 05:24:23 -03:00
Conversation 3 Commits 1 Files changed 15 +405
navigator commented 2026-05-24 03:25:52 -03:00
Owner
Copy link

Bootstraps the 15 ADRs called out in PLAN.md Section 8.1.

Each is Status: Proposed and carries Context, Decision, Consequences, and Alternatives fields populated from PLAN.md. Status transitions to Accepted once the team commits to each decision.

Chip-level: ADR-001 (4 Gemminis), ADR-002 (16x16 systolic), ADR-003 (intra-chip xbar), ADR-004 (256 KiB scratchpad), ADR-005 (1x DDR5/chip), ADR-006 (2x Rocket cores), ADR-007 (open PDK target).

Board-level: ADR-008 (designated master), ADR-009 (PopLink fabric, supersedes PCIe Gen4), ADR-010 (2D torus 2x4), ADR-011 (non-coherent memory), ADR-012 (power envelope), ADR-013 (OAM 2.0), ADR-014 (BGA pin budget).

Foundry strategy: ADR-015 (two-tier IHP130 Edu + SMIC N+2 Pro).

Tests: N/A (docs-only). CI build.yml runs shellcheck on infra/forgejo/provision.sh and skips sbt compile (no build.sbt yet, fallback in workflow). Per GitOps workflow, ready for approve + merge once CI green.

Bootstraps the 15 ADRs called out in PLAN.md Section 8.1. Each is **Status: Proposed** and carries Context, Decision, Consequences, and Alternatives fields populated from PLAN.md. Status transitions to **Accepted** once the team commits to each decision. **Chip-level:** ADR-001 (4 Gemminis), ADR-002 (16x16 systolic), ADR-003 (intra-chip xbar), ADR-004 (256 KiB scratchpad), ADR-005 (1x DDR5/chip), ADR-006 (2x Rocket cores), ADR-007 (open PDK target). **Board-level:** ADR-008 (designated master), ADR-009 (PopLink fabric, supersedes PCIe Gen4), ADR-010 (2D torus 2x4), ADR-011 (non-coherent memory), ADR-012 (power envelope), ADR-013 (OAM 2.0), ADR-014 (BGA pin budget). **Foundry strategy:** ADR-015 (two-tier IHP130 Edu + SMIC N+2 Pro). Tests: N/A (docs-only). CI build.yml runs shellcheck on infra/forgejo/provision.sh and skips sbt compile (no build.sbt yet, fallback in workflow). Per GitOps workflow, ready for approve + merge once CI green.
docs(adr): open ADR-001..ADR-015 as draft architectural decisions
Some checks failed
build / scalafmt-check (push) Failing after 58s
Details
build / sbt-compile (push) Failing after 2s
Details
build / shell-lint (push) Failing after 5s
Details
build / scalafmt-check (pull_request) Failing after 3s
Details
build / sbt-compile (pull_request) Failing after 2s
Details
build / shell-lint (pull_request) Failing after 2s
Details
7152786332 
Initial draft of 15 ADRs covering chip-level (001-007), board-level (008-014), and foundry-strategy (015) decisions per PLAN.md Section 8.1.

Status: Proposed. Each ADR has Context, Decision, Consequences, and Alternatives fields populated from PLAN.md.
fluidpop-bot approved these changes 2026-05-24 05:20:40 -03:00
Dismissed
fluidpop-bot left a comment
Collaborator
Copy link

15 ADRs docs-only PR; approving per GitOps loop

15 ADRs docs-only PR; approving per GitOps loop
navigator force-pushed feature/initial-adrs from 7152786332
Some checks failed
build / scalafmt-check (push) Failing after 58s
Details
build / sbt-compile (push) Failing after 2s
Details
build / shell-lint (push) Failing after 5s
Details
build / scalafmt-check (pull_request) Failing after 3s
Details
build / sbt-compile (pull_request) Failing after 2s
Details
build / shell-lint (pull_request) Failing after 2s
Details
to b3dc44b740
All checks were successful
build / scalafmt-check (push) Successful in 4s
Details
build / sbt-compile (push) Successful in 3s
Details
build / shell-lint (push) Successful in 8s
Details
build / scalafmt-check (pull_request) Successful in 3s
Details
build / sbt-compile (pull_request) Successful in 3s
Details
build / shell-lint (pull_request) Successful in 8s
Details
2026-05-24 05:23:08 -03:00 Compare
fluidpop-bot approved these changes 2026-05-24 05:23:29 -03:00
Dismissed
fluidpop-bot left a comment
Collaborator
Copy link

Rebased onto main with CI fix; re-approving

Rebased onto main with CI fix; re-approving
navigator force-pushed feature/initial-adrs from b3dc44b740
All checks were successful
build / scalafmt-check (push) Successful in 4s
Details
build / sbt-compile (push) Successful in 3s
Details
build / shell-lint (push) Successful in 8s
Details
build / scalafmt-check (pull_request) Successful in 3s
Details
build / sbt-compile (pull_request) Successful in 3s
Details
build / shell-lint (pull_request) Successful in 8s
Details
to 76d1f32ace
All checks were successful
build / scalafmt-check (push) Successful in 3s
Details
build / sbt-compile (push) Successful in 3s
Details
build / shell-lint (push) Successful in 8s
Details
build / scalafmt-check (pull_request) Successful in 3s
Details
build / sbt-compile (pull_request) Successful in 3s
Details
build / shell-lint (pull_request) Successful in 8s
Details
2026-05-24 05:24:05 -03:00 Compare
fluidpop-bot approved these changes 2026-05-24 05:24:19 -03:00
fluidpop-bot left a comment
Collaborator
Copy link

Rebased onto main 61e49c2; re-approving for final merge

Rebased onto main 61e49c2; re-approving for final merge
Sign in to join this conversation.
Reviewers
No reviewers
fluidpop-bot
Labels
Clear labels   
adr

Architecture Decision Record

  
agent:blocked-ci

CI failed on the PR

  
agent:blocked-human

Operator escalated; awaiting Marcos input

  
agent:blocked-resolver

Resolver crashed, returned empty, or timed out

  
agent:done

PR merged; issue auto-closed

  
agent:in-progress

Resolver claimed and running

  
agent:no-touch

Human-reserved; swarm Opener/Dispatcher skip

  
agent:pinged

Operator already escalated; suppress repeat pings

  
agent:pr-open

Resolver opened a PR; awaiting review/merge

  
agent:queued

Issue ready for swarm Resolver to claim

  
agent:wip

PR work-in-progress; Approver skips

  
area:board

PCB / mechanical / cooling

  
area:funding

PACID / grants / RFQs

  
area:infra

Dev env, CI, containers

  
area:phy

Physical layer / SerDes

  
area:poplink

PopLink protocol

  
area:rtl

Chisel/RTL work

  
area:software

Driver / runtime / frameworks

  
area:supply-chain

Foundry, OSAT, PCB, components

  
area:verification

Test, formal, coverage

  
ci-failed

auto-merge.sh detected CI failure

  
ci-timeout

auto-merge.sh hit CI timeout

  
docs

Documentation

  
do-not-merge

Hard hold; PR Approver skips

  
human-approved

Marcos approved via Telegram; release governance hold

  
needs-human-approval

Touches governance path; awaits Marcos label human-approved

  
needs-rebase

PR is not mergeable; rebase needed

  
needs-triage

Issue from untrusted author; Marcos triage needed

  
phase:1

Phase 1 (Section 6 of PLAN.md)

  
ready-for-review

Resolver done; PR Approver triages

  
review:findings

PR semantic review flagged blocking findings

  
review:pass

PR semantic review passed; safe for pr-approver

  
risk:tripwire

Section 0.5 tripwire fired

  
swarm:quarantined

Escalation tripwire fired; resolver tried off-limits paths

No labels
adr
agent:blocked-ci
agent:blocked-human
agent:blocked-resolver
agent:done
agent:in-progress
agent:no-touch
agent:pinged
agent:pr-open
agent:queued
agent:wip
area:board
area:funding
area:infra
area:phy
area:poplink
area:rtl
area:software
area:supply-chain
area:verification
ci-failed
ci-timeout
docs
do-not-merge
human-approved
needs-human-approval
needs-rebase
needs-triage
phase:1
ready-for-review
review:findings
review:pass
risk:tripwire
swarm:quarantined
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Fluid/fluidpop-v1!10
No description provided.