pub fn generate_readme(id: &str, archetype: &str, summary: &str) -> String {
format!(
r#"# {id}
## Behavior
{summary}
Archetype: `{archetype}`.
## Reference CPU implementation
The reference lives alongside the op's `spec.toml` under
`core/src/ops/<path>/` (or `conform/src/specs/<family>/<op>.rs` for
Category-C intrinsics). Consumers of this op should treat the CPU
reference as the source of truth; the conform gate proves the GPU
kernel is byte-identical.
## WGSL spelling notes
See `lowering/wgsl.rs` for the exact WGSL intrinsic / operator used.
If spellings differ by backend architecture, record them in the
`[intrinsic]` block of `spec.toml`; the conform gate cross-checks
each spelling against its backend.
## Contributor checklist
1. Replace the scaffold in `kernel.rs` with the implementation.
2. Verify `lowering/wgsl.rs` matches the WGSL operator spellings used
by `kernel.rs`.
3. Run `cargo build`.
4. Run `cargo run -p vyre-conform certify {id}`.
"#
)
}