Back to V8

V8 Workflow Skill

agents/skills/v8-workflow/SKILL.md

15.0.2421.3 KB
Original Source

V8 Workflow Skill

This skill defines the standard process for setting up and managing your development environment in V8.

1. Task Initialization (Isolation Strategy)

Before starting any feature or bug fix, you MUST decide on a strategy:

  • Isolated Strategy (Recommended): Create a dedicated git worktree and branch. This prevents cross-contamination between tasks. Use create_worktree.sh.

  • Reuse Strategy: Work in the current directory and branch.

    • Use this only if the user explicitly requests to continue previous work or prefers a single-branch workflow.
  • Issue Reset: If starting a new task without a worktree, always ask before resetting the git cl issue.

2. Environment Setup

Once the branch is ready, ensure your local environment is configured for V8 development:

  • depot_tools: Ensure it is in your PATH.
    • export PATH=$PATH:$HOME/depot_tools
  • Output Directory: Use standard V8 output directories (e.g., out/x64.debug).

3. Available Tools

  • create_worktree.sh: Automates the git worktree isolation and setup process. Use this at the start of every new task.
  • cleanup_worktree.sh: Safely removes task worktrees and prunes remnants once a CL is landed or abandoned.