Skip to content

AGENTS.md + CLAUDE.md: fix stale facts, tune for current agents - #1203

Merged
Iamfle4ka merged 3 commits into
keboola:mainfrom
Iamfle4ka:agents-md-opus55
Oct 14, 2026
Merged

Iamfle4ka merged 3 commits into
keboola:mainfrom
Iamfle4ka:agents-md-opus55

Conversation

@Iamfle4ka

Copy link
Copy Markdown
Collaborator

Jira issue(s): none

Changes:

  • AGENTS.md: images are served from public/<section>/ (the old advice to put them next to the Markdown gives a 404). Frontmatter now asks for title, slug and description, which matches CLAUDE.md.
  • AGENTS.md: new sections on redirect_from for moved or deleted pages, the MDX {braces} trap, and comments reaching the public Markdown twin. The verify list now includes npm run check:cli (CI runs it on every PR) and npm test.
  • AGENTS.md: all four integrations listed; the sidebar rule appears once instead of three times; the migration scripts sit under "Don't run" with the reason.
  • CLAUDE.md: the review agents and skills are named as the keboola-docs plugin's, with a fallback when the plugin isn't installed. Before this, a fresh clone pointed agents at tools that don't exist.
  • CLAUDE.md: scripts/shoot.mjs is gitignored (the file said it wasn't). The dev-server rule no longer says pkill -f "astro dev", which also kills the servers of other worktrees.
  • Both files: caps and bold "NEVER/NOT" replaced with the reason behind each rule. Current models follow instructions literally and over-apply shouted ones.

The feedback-widget lines from #1003 are kept as merged.


Docs-only change to the contributor guides; no page or build output changes.

🤖 Generated with Claude Code

Nikita and others added 3 commits October 14, 2026 16:31
- Image path: served copies live in public/<section>/, not next to the page
- Frontmatter needs description too (matches CLAUDE.md)
- Add redirect_from usage, the MDX {braces} trap, public-comment warning
- Verify section now mentions check:cli, which CI runs on every PR
- List all four integrations; drop the triple-stated sidebar rule
- Replace caps/bold emphasis with reasons, for literal-reading models

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- fact-checker / guide-tester / migration-placement live in the gitignored
  .claude/; say so and what to do when they're missing
- scripts/shoot.mjs is gitignored (the file said it wasn't)
- Dev server: don't pkill every astro dev, other worktrees run their own
- Drop rules now covered by AGENTS.md (frontmatter) and the note about
  guardrails that no longer apply; point redirects at redirect_from
- Replace caps/bold emphasis with reasons, for literal-reading models

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 14, 2026

Copy link
Copy Markdown

Someone is attempting to deploy a commit to the Keboola Engineering Team on Vercel.

A member of the Team first needs to authorize it.

@keboola-pr-reviewer-bot keboola-pr-reviewer-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.

Verdict: auto_approve (risk 1/5) · profile connection-docs

Auto-approve: prose-only cleanup of the repo-root contributor guides AGENTS.md and CLAUDE.md, with no public-site or build impact.

@Iamfle4ka
Iamfle4ka merged commit 204f011 into keboola:main Oct 14, 2026
2 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants