autows-docs

name	autows-docs
description	Consult and maintain AutoWS documentation. Use BEFORE exploring AutoWS source code — when investigating, planning, or modifying files under WarpSpecialization/, partition scheduling, warp_specialize ops, WSCodePartition, WSDataPartition, WSTaskPartition, WSMemoryPlanner, or related passes. Also use AFTER making non-trivial changes to AutoWS code to keep docs in sync.

AutoWS Documentation

AutoWS has comprehensive design docs that live alongside the source code at:

third_party/nvidia/hopper/lib/Transforms/WarpSpecialization/docs/

CRITICAL: Read docs BEFORE reading source

When investigating or planning changes to AutoWS code, always read the relevant docs first before exploring the source files. The docs explain the design intent, invariants, and relationships between passes — information that is difficult to reconstruct from code alone. Reading docs first will:

• Give you the correct mental model before diving into implementation details
• Identify which files are relevant so you search less
• Surface invariants and edge cases that aren't obvious from code

How to find the right doc

Use the file map below to match your task to the relevant doc(s):

If you're working on...	Read this doc first
Overall pipeline, pass ordering	docs/Overview.md
Task ID assignment (Hopper)	docs/TaskPartitionAndPropagation.md
Splitting ops across warp groups	docs/DataPartition.md
Channel insertion, async copies, barriers	docs/CodePartition.md
Code specialization / cloning into regions