cobalt-new-checkout

name	cobalt-new-checkout
description	Guides the agent through setting up a new checkout of the Cobalt repository. Use when cloning and building Cobalt for the first time in a new workspace.

Skill: Cobalt New Checkout Setup

Orchestrates environment analysis, workspace validation, persistent state recording, and post-checks execution across checked out working directories.

Workspace Architecture Topology

Projects operating through gclient need structured directory bounds:

workspace/
  ├── .gclient                    <- Declarative dependencies configuration
  ├── .setup_checkpoints.json     <- Persistent execution checkpoints state
  ├── tools/
  │   └── depot_tools/            <- Native chromium build utilities
  └── src/                        <- Repository checkout root
      └── .agent/
          └── skills/
              └── cobalt-new-checkout/
                  └── scripts/
                      └── cobalt_new_checkout.py  <- Setup automation orchestrator

[!IMPORTANT] Script logic executes mutations inside the directory enclosing the src/ project code root. Verify runtime constraints allow write tasks inside matching paths.

---

Sequential Execution Milestones

AI Assistants run actions by completing 5 primary configuration milestones:

graph TD
    P1[Phase I: Runtime Environment Check] --> P2[Phase II: Depot Tools Bootstrap]
    P2 --> P3[Phase III: Git Identity Verification]
    P3 --> P4[Phase IV: System Sync & Configuration]
    P4 --> P5[Phase V: Validation Post-Checks]

Phase I: Verification of Prerequisite Runtime Context

Validate execution dependencies and script parameters:

• Ensure python3 availability.
• Check project repository root holds initialized .git state tracking.
• Check required arguments inside non-interactive executions (like ).