'Chase Latta (Gerrit)' via owners-override

unread,

Mar 20, 2026, 11:03:44 AM (2 days ago) Mar 20

to Owners Override

Attention needed from Owners Override and Puneetha Ramachandra

Puneetha Ramachandra has uploaded the change for review

Chase Latta would like Owners Override to review this change authored by Puneetha Ramachandra.

Commit message

[docs] Add CIDER_AGENT.md

This file provides essential instructions and troubleshooting steps for
AI agents operating within the Fuchsia Cog workspace. It is intended to
serve as a quick reference guide to ensure agents configure the
workspace properly and use the correct commands for tasks.

Change-Id: Ibb1f70c0f741ed7943c9d88f5175a7044843f0c2

Change diff

diff --git a/CIDER_AGENT.md b/CIDER_AGENT.md
new file mode 100644
index 0000000..9b323fc
--- /dev/null
+++ b/CIDER_AGENT.md
@@ -0,0 +1,32 @@
+# Cider Agent Guidelines for Fuchsia (Cog Workspace)
+
+This document contains essential instructions and troubleshooting steps for AI
+agents operating within the Fuchsia Cog workspace. For comprehensive details on
+Fuchsia development, please always refer to @GEMINI.md
+
+## 1. Running `fx` Commands
+* The safest and most reliable way to run `fx` is to invoke it directly using
+  its path: `.jiri_root/bin/fx` (or `//.jiri_root/bin/fx` from the repo root).
+* Using `scripts/fx` or just `fx` might fail depending on the PATH
+  configuration. You may temporarily add `.jiri_root/bin` to your `$PATH`
+  during your session if needed.
+
+## 2. Workspace Initialization (Cog)
+* If `.jiri_root` is not present or you are encountering fundamental workspace
+  configuration issues, the Cog workspace might not be properly initialized.
+* The workspace setup script is located at
+  `scripts/cog/setup_cog_workspace.py`.
+* **Important:** This setup script only needs to be run **once** per workspace.
+  You do not need to run it repeatedly.
+
+## 3. Configuring the Build
+* Before building or running tests, ensure your build configuration is set up
+  correctly.
+* See `GEMINI.md` for more details on `fx set`, `fx build`, and building
+  specific targets.
+
+## 4. Additional Reference
+* For broader guidelines regarding C++/Rust development, writing tests, finding
+  FIDL methods, formatting commit messages, and managing Git in a multi-repo
+  environment (`jiri`), please consult the `GEMINI.md` file located at the root
+  of the Fuchsia directory.
diff --git a/OWNERS b/OWNERS
index 89894fd..e05d4c6 100644
--- a/OWNERS
+++ b/OWNERS
@@ -59,3 +59,4 @@
 per-file .ignore = *
 
 per-file GEMINI.md = file:.gemini/OWNERS
+per-file CIDER_AGENT.md = file:.gemini/OWNERS

Change information

Files:

A CIDER_AGENT.md
M OWNERS

Change size: S

Delta: 2 files changed, 33 insertions(+), 0 deletions(-)

Open in Gerrit

Related details

Attention is currently required from:

Owners Override
Puneetha Ramachandra

Submit Requirements:

Code-Owners
Code-Review
No-Unresolved-Comments
Review-Enforcement

Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings.

Gerrit

--
You received this message because you are subscribed to the Google Groups "owners-override" group.
To unsubscribe from this group and stop receiving emails from it, send an email to owners-overri...@fuchsia.dev.
To view this discussion visit https://groups.google.com/a/fuchsia.dev/d/msgid/owners-override/04e2e82bbc8c6cd4a8e0e514e4e6f64c70d4885a-HTML%40fuchsia-review.googlesource.com.

unsatisfied_requirement

satisfied_requirement

open

diffy

'Chase Latta (Gerrit)' via owners-override

unread,

Mar 20, 2026, 11:03:49 AM (2 days ago) Mar 20

to Puneetha Ramachandra, Owners Override, Adam Barth, Nick Van der Auwermeulen, Jiaming Li

Attention needed from Owners Override and Puneetha Ramachandra

Chase Latta voted and added 1 comment

Votes added by Chase Latta

Code-Review

+2

1 comment

Patchset-level comments

File-level comment, Patchset 4 (Latest):

Chase Latta . resolved

Puneetha, I added owners-...@fuchsia.dev to the reviewers which will trigger that process.

Open in Gerrit

Related details

Attention is currently required from:

Owners Override
Puneetha Ramachandra

Submit Requirements:

Code-Owners
Code-Review
No-Unresolved-Comments
Review-Enforcement

Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings.

Gerrit

--
You received this message because you are subscribed to the Google Groups "owners-override" group.
To unsubscribe from this group and stop receiving emails from it, send an email to owners-overri...@fuchsia.dev.

To view this discussion visit https://groups.google.com/a/fuchsia.dev/d/msgid/owners-override/04e2e82bbc8c6cd4a8e0e514e4e6f64c70d4885a-EmailReviewComments-HTML%40fuchsia-review.googlesource.com.

unsatisfied_requirement

satisfied_requirement

open

diffy

'Puneetha Ramachandra (Gerrit)' via owners-override

unread,

Mar 20, 2026, 11:09:30 AM (2 days ago) Mar 20

to Owners Override, Adam Barth, Nick Van der Auwermeulen, Chase Latta, Jiaming Li

Attention needed from Owners Override

Puneetha Ramachandra added 1 comment

Patchset-level comments

File-level comment, Patchset 4 (Latest):

Puneetha Ramachandra . resolved

@aba...@google.com I think this needs an owners override vote.

Puneetha Ramachandra

Done

Open in Gerrit

Related details

Attention is currently required from:

Owners Override

Submit Requirements:

Code-Owners
Code-Review

Review-Enforcement

Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings.

Gerrit

--
You received this message because you are subscribed to the Google Groups "owners-override" group.
To unsubscribe from this group and stop receiving emails from it, send an email to owners-overri...@fuchsia.dev.

To view this discussion visit https://groups.google.com/a/fuchsia.dev/d/msgid/owners-override/6afc02ebbf686709ba395c41e830660345aa7f52-EmailReviewComments-HTML%40fuchsia-review.googlesource.com.

unsatisfied_requirement

satisfied_requirement

open

diffy

'Adam Barth (Gerrit)' via owners-override

unread,

Mar 20, 2026, 11:36:31 AM (2 days ago) Mar 20

to Puneetha Ramachandra, Owners Override, Nick Van der Auwermeulen, Chase Latta, Jiaming Li

Attention needed from Owners Override and Puneetha Ramachandra

Adam Barth voted

Code-Review	+2
Owners-Override	+1

Open in Gerrit

Related details

Attention is currently required from:

Owners Override
Puneetha Ramachandra

Submit Requirements:

Code-Owners

Code-Review
Review-Enforcement

Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings.

Gerrit

--
You received this message because you are subscribed to the Google Groups "owners-override" group.
To unsubscribe from this group and stop receiving emails from it, send an email to owners-overri...@fuchsia.dev.

To view this discussion visit https://groups.google.com/a/fuchsia.dev/d/msgid/owners-override/30cbd11c4ed6dbc2defb7d2a9fc671efeaf3b926-EmailReviewComments-HTML%40fuchsia-review.googlesource.com.

satisfied_requirement

open

diffy

'CQ Bot (Gerrit)' via owners-override

unread,

Mar 20, 2026, 11:37:22 AM (2 days ago) Mar 20

to Puneetha Ramachandra, Adam Barth, Owners Override, Nick Van der Auwermeulen, Chase Latta, Jiaming Li

CQ Bot submitted the change

Change information

Commit message:

[docs] Add CIDER_AGENT.md

This file provides essential instructions and troubleshooting steps for
AI agents operating within the Fuchsia Cog workspace. It is intended to
serve as a quick reference guide to ensure agents configure the
workspace properly and use the correct commands for tasks.

Change-Id: Ibb1f70c0f741ed7943c9d88f5175a7044843f0c2

Reviewed-on: https://fuchsia-review.googlesource.com/c/fuchsia/+/1546841

Fuchsia-Auto-Submit: Puneetha Ramachandra <pune...@google.com>

Reviewed-by: Nick Van der Auwermeulen <nickv...@google.com>

Reviewed-by: Adam Barth <aba...@google.com>

Owners-Override: Adam Barth <aba...@google.com>

Reviewed-by: Chase Latta <chase...@google.com>

Reviewed-by: Jiaming Li <liji...@google.com>

Commit-Queue: Puneetha Ramachandra <pune...@google.com>

Files:

A CIDER_AGENT.md
M OWNERS

Change size: S

Delta: 2 files changed, 33 insertions(+), 0 deletions(-)

Branch: refs/heads/main

Submit Requirements:

Code-Review: +2 by Chase Latta, +2 by Nick Van der Auwermeulen, +2 by Adam Barth, +2 by Jiaming Li

Open in Gerrit

Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings.

Gerrit

--

You received this message because you are subscribed to the Google Groups "owners-override" group.
To unsubscribe from this group and stop receiving emails from it, send an email to owners-overri...@fuchsia.dev.

To view this discussion visit https://groups.google.com/a/fuchsia.dev/d/msgid/owners-override/934de7eb250f3f1087136f750a54af522fc7ba00-HTML%40fuchsia-review.googlesource.com.

open

diffy

satisfied_requirement

'GI Roller (Gerrit)' via owners-override

unread,

Mar 20, 2026, 11:46:32 AM (2 days ago) Mar 20

to Puneetha Ramachandra, CQ Bot, Adam Barth, Owners Override, Nick Van der Auwermeulen, Chase Latta, Jiaming Li

Message from GI Roller

Change has been successfully rolled: https://turquoise-internal-review.googlesource.com/1205587

Open in Gerrit

Related details

Attention set is empty

Submit Requirements:

Code-Owners
Code-Review
Review-Enforcement

Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings.

Gerrit

--
You received this message because you are subscribed to the Google Groups "owners-override" group.
To unsubscribe from this group and stop receiving emails from it, send an email to owners-overri...@fuchsia.dev.

To view this discussion visit https://groups.google.com/a/fuchsia.dev/d/msgid/owners-override/d4abad8169e3e0fbe0d0c6e113533792bb11c158-EmailReviewComments-HTML%40fuchsia-review.googlesource.com.

satisfied_requirement

open

diffy

Reply all

Reply to author

Forward

[S] Change in fuchsia/fuchsia[main]: [docs] Add CIDER_AGENT.md

'Chase Latta (Gerrit)' via owners-override

Puneetha Ramachandra has uploaded the change for review

Commit message

Change diff

Change information

Related details

'Chase Latta (Gerrit)' via owners-override

Chase Latta voted and added 1 comment

Votes added by Chase Latta

1 comment

Related details

'Puneetha Ramachandra (Gerrit)' via owners-override

Puneetha Ramachandra added 1 comment

Related details

'Adam Barth (Gerrit)' via owners-override

Adam Barth voted

Related details

'CQ Bot (Gerrit)' via owners-override

CQ Bot submitted the change

Change information

'GI Roller (Gerrit)' via owners-override

Message from GI Roller

Related details