Skip to content

feat: add AI agent setup#353

Open
slimluccii wants to merge 9 commits intomainfrom
feat/ai-agent-setup
Open

feat: add AI agent setup#353
slimluccii wants to merge 9 commits intomainfrom
feat/ai-agent-setup

Conversation

@slimluccii
Copy link
Copy Markdown
Member

@slimluccii slimluccii commented Apr 22, 2026

Changes

  • Add AGENTS.md at the repo root with project overview, required reading, environment setup, build/run/test commands, code style guidelines, GraphQL & CMS workflow, security considerations, guardrails (destructive action rules + loop prevention), commit & PR guidelines, and known rough edges/typos
  • Add .agents/skills/ directory with six project-specific skills: astro, datocms, frontend-design, cloudflare, wrangler, and web-perf
  • Add .mcp.json at the repo root configuring four MCP servers: datocms (stdio, @datocms/mcp-server), astro-docs (remote HTTP, mcp.docs.astro.build), cloudflare-docs (remote HTTP, docs.mcp.cloudflare.com), and chrome-devtools (stdio, chrome-devtools-mcp)

Skill details

Skill Source Purpose
astro astrolicious/agent-skills .astro files, SSR config, integrations, Astro CLI
datocms jodusnodus/datocms-skill CMS schema, migrations, GraphQL, structured text
frontend-design anthropics/skills UI components and pages — Astro-first, match existing framework
cloudflare cloudflare/skills Cloudflare Pages, Workers, and adapter reference
wrangler cloudflare/skills wrangler CLI — local preview, secrets, deployments
web-perf cloudflare/skills Core Web Vitals auditing via the chrome-devtools MCP server

Associated issue

Resolves #352

How to test

  1. Open the repository in an MCP-compatible agent (Claude Code, Cursor, etc.)
  2. Verify the agent picks up AGENTS.md and references the skills/MCP servers when working in the relevant domains
  3. Run npm run dev and use the web-perf skill to audit Core Web Vitals via the chrome-devtools MCP server

Checklist

  • I have performed a self-review of my own code
  • I have made sure that my PR is easy to review (not too big, includes comments)
  • I have made updated relevant documentation files (in project README, docs/, etc)
  • I have added a decision log entry if the change affects the architecture or changes a significant technology
  • I have notified a reviewer

… and agent instructions

- Created LICENSE.txt for frontend-design skill with Apache License 2.0.
- Added SKILL.md for frontend-design skill detailing design guidelines and implementation strategies.
- Introduced .mcp.json to configure MCP servers for DatoCMS and documentation access.
- Added AGENTS.md to provide instructions for AI coding agents and project overview.
- Initialized skills-lock.json to manage dependencies for agent skills.
Copilot AI review requested due to automatic review settings April 22, 2026 11:58
@slimluccii slimluccii linked an issue Apr 22, 2026 that may be closed by this pull request
@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Apr 22, 2026

Deploying head-start with  Cloudflare Pages  Cloudflare Pages

Latest commit: a988448
Status: ✅  Deploy successful!
Preview URL: https://c4f3dd83.head-start.pages.dev
Branch Preview URL: https://feat-ai-agent-setup.head-start.pages.dev

View logs

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds AI-agent onboarding and configuration artifacts to help MCP-compatible coding agents work effectively in this Astro + DatoCMS + Cloudflare Pages repository.

Changes:

  • Add AGENTS.md with repo-specific agent guidance (setup, workflows, guardrails, commands).
  • Add .agents/skills/* domain skills for Astro, DatoCMS, frontend design, and a “caveman” terseness mode.
  • Add .mcp.json plus skills-lock.json to configure MCP servers and lock skill sources.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 6 comments.

Show a summary per file
File Description
skills-lock.json Adds a lockfile mapping skill names to GitHub sources and hashes.
AGENTS.md Documents project overview, setup, workflows, guardrails, and agent pointers to skills/MCP.
.mcp.json Configures MCP servers for DatoCMS and live Astro/Cloudflare docs access.
.agents/skills/frontend-design/SKILL.md Adds a UI/design-focused skill with aesthetic and implementation guidance.
.agents/skills/frontend-design/LICENSE.txt Adds Apache-2.0 license text for the frontend-design skill.
.agents/skills/datocms/SKILL.md Adds a comprehensive DatoCMS workflow/reference skill (APIs, migrations, MCP, troubleshooting).
.agents/skills/caveman/SKILL.md Adds a skill describing an ultra-terse response mode and how to invoke it.
.agents/skills/astro/SKILL.md Adds an Astro usage/config skill with CLI and adapter guidance.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread .agents/skills/frontend-design/SKILL.md Outdated
Comment thread .agents/skills/datocms/SKILL.md
Comment thread .agents/skills/datocms/SKILL.md
Comment thread .mcp.json
Comment thread AGENTS.md Outdated
Comment thread .agents/skills/frontend-design/SKILL.md Outdated
@slimluccii slimluccii changed the title feat: add AI agent setup (AGENTS.md, skills, MCP servers) feat: add AI agent setup Apr 22, 2026
@slimluccii slimluccii requested a review from jbmoelker April 22, 2026 12:31
- cloudflare: general Cloudflare Pages/Workers platform reference
- wrangler: CLI commands for local preview, secrets, deployments, and wrangler.toml
- web-perf: Core Web Vitals auditing via the chrome-devtools MCP server

All three registered in the AGENTS.md skills table.
@slimluccii slimluccii requested a review from JopMolenaar April 22, 2026 13:10
Co-authored-by: Copilot <copilot@github.com>
slimluccii and others added 2 commits May 1, 2026 10:57
Drop skills table from AGENTS.md and source table from working-with-ai.md;
SKILL.md frontmatter is now the single source of truth for trigger conditions
so adding a skill no longer requires updating multiple docs.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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.

Preconfigure MCP Servers

3 participants