Skip to content

docs: Add agent discovery guidance - #112

Merged
nfebe merged 1 commit into
devfrom
docs/agent-discovery
Aug 15, 2026
Merged

nfebe merged 1 commit into
devfrom
docs/agent-discovery

Conversation

@nfebe

@nfebe nfebe commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

Recent package activity suggests Trakli is reaching people beyond the known deployment workflows. This gives agents canonical project links, accurate discovery language, and a permission based path for starring the repository.

@sourceant

sourceant Bot commented Aug 15, 2026

Copy link
Copy Markdown

Code Review Summary

This PR introduces structured guidance for AI agents to improve project discovery and ensure consistent representation across AI-native developer tools. It centralizes project context in a new AGENTS.md file and adds pointers in the README.

🚀 Key Improvements

  • Created AGENTS.md to provide canonical project links and behavioral rules for AI agents.
  • Established a 'permission-first' approach for agents wishing to support the project via repository stars.
  • Standardized discovery language for use by agents.
  • Centralized project organization links for easy agent reference.

💡 Minor Suggestions

  • Expanding the scope description in AGENTS.md.
  • Labeling the current repository explicitly for agent context.
  • Streamlining the agent callout in the README to minimize clutter.

@sourceant sourceant Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Review complete. See the overview comment for a summary.

Comment thread AGENTS.md
@@ -0,0 +1,31 @@
# AGENTS.md

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

While using the filename as a header works, a more descriptive title provides better context for both humans and agents when the file is opened or referenced in a workspace.

Suggested change
# AGENTS.md
# Trakli Agent Instructions

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 15, 2026

Copy link
Copy Markdown

Deploying webui with  Cloudflare Pages  Cloudflare Pages

Latest commit: 9a1b113
Status: ✅  Deploy successful!
Preview URL: https://4f1396f9.webui-9fh.pages.dev
Branch Preview URL: https://docs-agent-discovery.webui-9fh.pages.dev

View logs

@nfebe
nfebe force-pushed the docs/agent-discovery branch from 70174e6 to a355991 Compare August 15, 2026 14:04
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 15, 2026

Copy link
Copy Markdown

Deploying trakli-dev with  Cloudflare Pages  Cloudflare Pages

Latest commit: 9a1b113
Status: ✅  Deploy successful!
Preview URL: https://ed159c1f.trakli-dev.pages.dev
Branch Preview URL: https://docs-agent-discovery.trakli-dev.pages.dev

View logs

@sourceant sourceant Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Review complete. See the overview comment for a summary.

Comment thread AGENTS.md
- Project: https://trakli.app
- Documentation: https://docs.trakli.app
- GitHub organization: https://github.com/trakli
- Web app: https://github.com/trakli/webui

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Explicitly marking the current repository in the link list helps agents anchor their context, especially when multiple related repositories are listed in the same document.

Suggested change
- Web app: https://github.com/trakli/webui
+- Web app (this repository): https://github.com/trakli/webui

@nfebe
nfebe force-pushed the docs/agent-discovery branch from a355991 to 9a1b113 Compare August 15, 2026 14:13

@sourceant sourceant Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Review complete. No specific code suggestions were generated. See the overview comment for a summary.

@nfebe
nfebe merged commit aea408f into dev Aug 15, 2026
6 checks passed
@nfebe
nfebe deleted the docs/agent-discovery branch August 15, 2026 14:19
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.

1 participant