docs: add ralph.* placeholders to how-it-works and update CLI reference SEO metadata

The how-it-works page explained placeholder resolution but didn't mention
ralph.name, ralph.iteration, or ralph.max_iterations — added since v0.3.0.
Also updated the CLI reference description and keywords to include ralph add.

Co-authored-by: Ralphify <noreply@ralphify.co>

Author: 2 people

docs/cli.md

@@ -1,7 +1,7 @@
 ---
 title: Ralph CLI Reference
-description: Full CLI reference for ralphify — ralph run, ralph init, ralph new, all options, user arguments, and RALPH.md frontmatter format.
-keywords: ralph CLI, ralph run, ralph init, ralph new, CLI reference, RALPH.md format, frontmatter options, agent arguments
+description: Full CLI reference for ralphify — ralph run, ralph init, ralph new, ralph add, all options, user arguments, and RALPH.md frontmatter format.
+keywords: ralph CLI, ralph run, ralph init, ralph new, ralph add, CLI reference, RALPH.md format, frontmatter options, agent arguments
 ---
 
 # CLI Reference

docs/how-it-works.md

@@ -51,6 +51,14 @@ commands:
 
 Each `{{ commands.<name> }}` placeholder in the prompt body is replaced with the corresponding command's output. Placeholders for `{{ args.<name> }}` are replaced with user argument values from the CLI — both in the prompt body and in command `run` strings.
 
+`{{ ralph.* }}` placeholders provide runtime metadata — no frontmatter configuration needed:
+
+- `{{ ralph.name }}` — the ralph's directory name (e.g. `my-ralph`)
+- `{{ ralph.iteration }}` — current iteration number (1-based)
+- `{{ ralph.max_iterations }}` — total iterations if `-n` was set, empty otherwise
+
+These are useful for iteration-aware prompts — for example, telling the agent to wrap up on the last iteration, or including the ralph name in commit messages.
+
 Unmatched placeholders resolve to an empty string — you won't see raw `{{ }}` text in the assembled prompt.
 
 ### 4. Assemble the prompt