check in AGENTS.md, xtask (#26)

* check in AGENTS.md, xtask

* fmt

* PR fixup

Author: schell

.cargo/config.toml

@@ -0,0 +1,6 @@
+[alias]
+xtask = "run --package xtask --"
+
+[env]
+CARGO_WORKSPACE_DIR = { value = "", relative = true }
+

.gitignore

@@ -19,6 +19,3 @@ target
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 #.idea/
-
-# Don't include AI agent files
-AGENTS.md

AGENTS.md

@@ -1,7 +1,7 @@
 # wgsl-rs
 
 Rust-to-WGSL transpiler using proc macros.
-Workspace with `wgsl-rs`, `wgsl-rs-macros`, and `example` crates.
+Workspace with `wgsl-rs`, `wgsl-rs-macros`, `example`, and `xtask` crates.
 
 ## Commands
 
@@ -15,6 +15,21 @@ cargo run -p example           # Run the example
 cargo expand -p example        # Expand the example which uses the `wgsl` macro, showing the generated WGSL_MODULE
 ```
 
+### xtask - development tools for agents
+
+This repo contains a `cargo xtask` that provides agents with some
+shorthand commands for common development tasks.
+
+`cargo xtask wgsl-spec` provides access to the WGSL specification without
+overwhelming an agent's context window.
+
+```bash
+cargo xtask wgsl-spec toc                        # List WGSL spec table of contents
+cargo xtask wgsl-spec section <anchor>           # Fetch a spec section with subsections
+cargo xtask wgsl-spec section --shallow <anchor> # Fetch section without subsections
+cargo xtask wgsl-spec section <anchor> <sub>     # Fetch a specific subsection
+```
+
 ## Code Style
 
 - **Imports**: Standard lib and external crates first, then `use crate::` for internal modules