Clarify AGENTS.md as Grok’s locked UVAI source and workflow auto-discovery

[Copilot]

Canonical issue

Outcome

grok --cwd now has explicit repo-root guidance for where locked UVAI facts live and how Grok discovers workflow automation files, reducing ambiguity in prompt grounding and discovery behavior.

Scope

• Included:
  • Prompt grounding: clarified that repo-root AGENTS.md is the source for locked UVAI facts used by grok --cwd.
  • Discovery semantics: clarified that .grok/workflows/*.rhai is auto-discovered.
  • Minimal footprint: docs-only edit in AGENTS.md; no runtime/config changes.
• Explicitly excluded:
  • Any product logic, CI/workflow config, or code-path changes.
  • Any changes to .grok/config.toml behavior beyond documented expectations.

Risk

• Risk level: low
• Failure mode: Grok instructions remain ambiguous if downstream tooling ignores docs.
• Rollback: revert the single AGENTS.md commit.

Verification

List exact automated and manual checks, tied to the current head SHA.

Head: a4b78cc

• Manual: reviewed git diff to confirm only AGENTS.md changed and wording matches issue intent.

• Automated: secret scan run on AGENTS.md (no findings).

• Automated: parallel validation run; CodeQL classified as trivial docs-only.

• Focused tests

• Required CI

• Review threads resolved

Production evidence

Not applicable (documentation-only change; no deployable/runtime behavior modified).

Agent handoff

• One canonical issue is linked
• No competing PR implements the same issue
• Acceptance criteria are satisfied
• Required checks pass on the current head
• Human decision is requested only for product, security, irreversible infrastructure, or production approval

# Before
Grok Build (`grok --cwd <this-repo>`) appends this file to the system prompt.
- **Workflows:** `.grok/workflows/*.rhai` (already present).

# After
Grok Build (`grok --cwd <this-repo>`) appends this file to the system prompt; keep locked UVAI facts here.
- **Workflows:** auto-discovered from `.grok/workflows/*.rhai` (already present).

• Fixes Add UVAI AGENTS.md instructions for Grok Build #1654

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
v0-uvai	Building	Preview, v0	Sep 8, 2026 11:10pm UTC