Skip to content

chore(readme): close UTM tracking gaps and sync utm-links.csv#658

Open
oktaygoktas wants to merge 1 commit into
mainfrom
chore/utm-tracking-gaps
Open

chore(readme): close UTM tracking gaps and sync utm-links.csv#658
oktaygoktas wants to merge 1 commit into
mainfrom
chore/utm-tracking-gaps

Conversation

@oktaygoktas

Copy link
Copy Markdown
Contributor

Summary

UTM-only audit of the README (incl. the Built With AgentField section) found that 45 of 46 agentfield.ai links were tracked, but Discord/X were untracked, the assets/utm-links.csv manifest had drifted from the README, and two links had inconsistent params. This PR closes those gaps:

  • Discord (3 placements) and X now route through tracked redirectsagentfield.ai/discord and agentfield.ai/x, each with a distinct utm_id per placement (-discord-header-badge, -discord-nav, -discord-community-badge, -x-follow), matching the existing /github/* redirect pattern used for project repos
  • Dropped stray utm_content=cloudsec from the two CloudSecurity links — no other link uses utm_content, and the CSV never recorded it
  • Normalized www.agentfield.ai/examples to the apex domain so analytics don't fragment by host
  • Appended 13 rows to assets/utm-links.csv — the 9 README links missing from the manifest plus the 4 new Discord/X links; README and CSV utm_id sets now diff to zero in both directions

Intentionally not changed: https://agentfield.ai/install.sh (left untagged per discussion) and same-repo GitHub links (badges/issues — not UTM-trackable).

⚠️ Do not merge yet

agentfield.ai/discord and agentfield.ai/x currently return 404. The redirects are being created on the website side — merge only after both resolve, or the README's Discord/X links will break.

Verification

  • utm_id diff between README.md and assets/utm-links.csv: empty in both directions
  • No remaining discord.gg, x.com, utm_content, or www.agentfield.ai references in README.md
  • All links follow the convention utm_source=github-readme&utm_campaign=github-readme&utm_id=github-readme-<placement>

🤖 Generated with Claude Code

- Route Discord (3 placements) and X links through agentfield.ai/discord
  and agentfield.ai/x redirects with per-placement utm_id
- Drop stray utm_content=cloudsec param for consistency with all other links
- Normalize www.agentfield.ai/examples to apex domain
- Add 13 missing rows to assets/utm-links.csv so the manifest mirrors the README

Note: agentfield.ai/discord and /x redirects must be live before merge
(currently 404; being created separately).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@oktaygoktas oktaygoktas requested review from a team and AbirAbbas as code owners June 13, 2026 01:42

@santoshkumarradha santoshkumarradha left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for wiring the README links through tracked redirects and syncing the CSV. I checked the new targets just now, and both https://agentfield.ai/discord and https://agentfield.ai/x still return 404 on June 13, 2026. I do not want to merge the README over to dead links yet. Once those redirects are live, this looks ready.

@santoshkumarradha santoshkumarradha left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Few breaking changes

Comment thread README.md
[![Coverage](https://img.shields.io/endpoint?url=https%3A%2F%2Fgist.githubusercontent.com%2Fsantoshkumarradha%2F433fb09c2d54c3c2589125cfd3eb14a2%2Fraw%2Fbadge.json&style=flat&logo=github&logoColor=e8e5dc&color=0c0b09&labelColor=8b7355&cacheSeconds=3600)](https://github.com/Agent-Field/agentfield/actions/workflows/coverage.yml)
[![Last Commit](https://img.shields.io/github/last-commit/Agent-Field/agentfield?style=flat&logo=git&logoColor=e8e5dc&color=0c0b09&labelColor=8b7355)](https://github.com/Agent-Field/agentfield/commits/main)
[![Discord](https://img.shields.io/badge/discord-join%20us-0c0b09.svg?style=flat&labelColor=8b7355&logo=discord&logoColor=e8e5dc)](https://discord.gg/aBHaXMkpqh)
[![Discord](https://img.shields.io/badge/discord-join%20us-0c0b09.svg?style=flat&labelColor=8b7355&logo=discord&logoColor=e8e5dc)](https://agentfield.ai/discord?utm_source=github-readme&utm_campaign=github-readme&utm_id=github-readme-discord-header-badge)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@oktaygoktas this breaks discord we need utm link capture first in website repo for this.

Comment thread README.md

[![Discord](https://img.shields.io/badge/Join%20Discord-d4a24a?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/aBHaXMkpqh)
[![Twitter](https://img.shields.io/badge/Follow%20on%20X-0c0b09?style=for-the-badge&logo=x&logoColor=white)](https://x.com/agentfield_ai)
[![Discord](https://img.shields.io/badge/Join%20Discord-d4a24a?style=for-the-badge&logo=discord&logoColor=white)](https://agentfield.ai/discord?utm_source=github-readme&utm_campaign=github-readme&utm_id=github-readme-discord-community-badge)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same here

Comment thread README.md
[![Discord](https://img.shields.io/badge/Join%20Discord-d4a24a?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/aBHaXMkpqh)
[![Twitter](https://img.shields.io/badge/Follow%20on%20X-0c0b09?style=for-the-badge&logo=x&logoColor=white)](https://x.com/agentfield_ai)
[![Discord](https://img.shields.io/badge/Join%20Discord-d4a24a?style=for-the-badge&logo=discord&logoColor=white)](https://agentfield.ai/discord?utm_source=github-readme&utm_campaign=github-readme&utm_id=github-readme-discord-community-badge)
[![Twitter](https://img.shields.io/badge/Follow%20on%20X-0c0b09?style=for-the-badge&logo=x&logoColor=white)](https://agentfield.ai/x?utm_source=github-readme&utm_campaign=github-readme&utm_id=github-readme-x-follow)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same here

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants