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.