Add product naming guidance to conforma/cli AGENTS.md to prevent stale name usage in generated code #3389
Description
What happened
PR #3381 (feat: improve error messages for Rego compilation failures) was created by the code agent from issue #3345. The issue body, written by human st3penta, used the old project name 'ec-cli' 4 times. The code agent faithfully used 'ec-cli' in the wrapRegoError error message strings, despite the project's root_cmd.go and AGENTS.md header clearly identifying it as 'Conforma CLI'. The review agent caught this on its second run (July 7, inline comment [low] naming). However, the fix agent did not address it after the first bare /fs-fix. The human then manually re-flagged the same naming issue on July 8 with a code suggestion. This required an additional fix iteration to resolve, contributing to the 5-iteration rework cycle.
What could go better
The code agent should prioritize the project's own naming conventions (from AGENTS.md, CLAUDE.md, or root command definitions) over terminology in issue descriptions. Currently, AGENTS.md has no explicit naming guidance. Adding a clear statement about the correct product name would give both the code agent and review agent a definitive reference. Confidence is high that this would prevent recurrence — the code agent demonstrably reads AGENTS.md for build commands and conventions.
Proposed change
Add to the 'Key Conventions' section of conforma/cli's AGENTS.md: 'Product name: This project is "Conforma CLI" (binary name: ec). Do not use the former name "ec-cli" in user-facing strings, error messages, or documentation, even if issue descriptions or existing comments reference the old name.'
Validation criteria
Future code agent PRs that generate user-facing strings (error messages, help text, log output) use 'Conforma CLI' instead of 'ec-cli'. The review agent can reference this AGENTS.md guidance when flagging naming violations, providing a clear rationale rather than relying on cross-referencing root_cmd.go.
Generated by retro agent from #3381
Activity
fullsend-ai-triage commentedon Jul 8, 2026
🤖 Finished Triage · ✅ Success · Started 2:45 PM UTC · Completed 2:48 PM UTC
Commit:
7c8ccca· View workflow run →fullsend-ai-triage commentedon Jul 8, 2026
Triage Summary
Category: Documentation improvement · Severity: Low
Problem
AGENTS.md lacks explicit product naming guidance. When AI code agents generate user-facing strings, they may use the old project name "ec-cli" from issue descriptions instead of "Conforma CLI." This was demonstrated in PR #3381, which required extra review iterations to correct the naming.
Root Cause
The Key Conventions section of AGENTS.md has no entry for the canonical product name. The code agent reads AGENTS.md for conventions but, finding no naming rule, defaults to whatever terminology appears in the issue description.
Recommended Fix
Add to the Key Conventions section of AGENTS.md:
Validation
root_cmd.goand the AGENTS.md headerThis is a straightforward, low-risk documentation change that is ready to implement.
Labels: This is a documentation improvement to AGENTS.md. Applying 'documentation' for the category, 'size: XS' as it's a single-line addition, and 'good first issue' since it requires no code changes.
fullsend-ai-coder commentedon Jul 8, 2026
🤖 Finished Code · ✅ Success · Started 2:49 PM UTC · Completed 2:54 PM UTC
Commit:
7c8ccca· View workflow run →docs(conforma#3510): add AGENTS.md guidance for review conventions