Skip to content

feat: add .claude configuration and AGENTS.md documentation#3227

Merged
ByronDWall merged 5 commits intomainfrom
FEC-327-ai-tooling-phase-1-ui-kit-templates-install-agent-skills
Apr 17, 2026
Merged

feat: add .claude configuration and AGENTS.md documentation#3227
ByronDWall merged 5 commits intomainfrom
FEC-327-ai-tooling-phase-1-ui-kit-templates-install-agent-skills

Conversation

@misama-ct
Copy link
Copy Markdown
Contributor

@misama-ct misama-ct commented Mar 31, 2026

Summary

Adds AI tooling foundation (Phase 1) to ui-kit — Claude Code configuration, MCP server setup, shared skills, and per-package AGENTS.md documentation.

Implements FEC-327, part of FEC-320 (Improve Agentic Engineering Support).

What's included

  • .claude/settings.json — PostToolUse hook for auto-formatting with Prettier on Edit/Write
  • .mcp.json — MCP server configuration (commercetools-docs, context7, playwright, sequential-thinking)
  • .claude/skills/ — symlinked shared skills from .agents/skills/ (repo-healthcheck-node, remember, repo-maintenance-node, renovate-review, renovate-migrate, pr-review-navigator, security-auditor, jira-create-epic-from-plan, jira-implement-task)
  • Root CLAUDE.md — Claude Code entry point referencing MCP servers, hooks, and skills
  • Root AGENTS.md — Monorepo architecture, build commands, workflows, conventions, and gotchas
  • Per-package AGENTS.md + CLAUDE.md for: design-system, packages/i18n, packages/components/icons, packages/components/inputs/rich-text-input, packages/components/inputs/rich-text-utils, presets/ui-kit

Review notes

All generated AGENTS.md files were reviewed against the actual codebase and corrected for accuracy (false paths, incorrect tool descriptions, and misleading claims were fixed). See the ticket description for the full acceptance criteria checklist.

Test plan

  • Open a fresh Claude Code session in this repo and ask "how do I build this project?" — should return exact correct commands
  • Run skills list — should show all installed skills
  • Verify MCP servers respond (commercetools-docs, context7, playwright, sequential-thinking)
  • Edit a .ts file — Prettier auto-format hook should trigger

🤖 Generated with Claude Code

@misama-ct misama-ct self-assigned this Mar 31, 2026
@misama-ct misama-ct added the 🚧 Status: WIP Work in progress label Mar 31, 2026
@vercel
Copy link
Copy Markdown

vercel bot commented Mar 31, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ui-kit Ready Ready Preview, Comment Apr 17, 2026 4:04pm

Request Review

@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Mar 31, 2026

⚠️ No Changeset found

Latest commit: 99e9319

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@misama-ct misama-ct changed the title FCE-327: feat: add AI agent configuration files and skills feat: add .claude configuration and AGENTS.md documentation Apr 1, 2026
@misama-ct misama-ct marked this pull request as ready for review April 16, 2026 05:59
@misama-ct misama-ct requested a review from a team as a code owner April 16, 2026 05:59
Copy link
Copy Markdown
Contributor

@valoriecarli valoriecarli left a comment

Choose a reason for hiding this comment

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

For now it covers everything asked in this phase. A++

misama-ct and others added 4 commits April 17, 2026 11:23
- Introduced .claude/.gitignore to exclude local settings and plan artifacts.
- Added .claude/settings.json to configure MCP servers and post-writehooks
  for auto-formatting with Prettier.
- Created symlinks for various skills in .claude/skills/ including
  pr-review-navigator, remember, renovate-migrate, renovate-review,
  repo-healthcheck-node, repo-maintenance-node, and security-auditor.
- Added .mcp.json to define MCP server configurations.
- Documented project structure and workflows in AGENTS.md and CLAUDE.md
  files across multiple directories.
- Established skills-lock.json to manage dependencies for agent skills.
Replace per-skill symlinks in .claude/skills/ with a single directory
symlink to .agents/skills/, so new skills are picked up automatically.
Also adds jira-create-epic-from-plan and jira-implement-task skills.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@ByronDWall ByronDWall force-pushed the FEC-327-ai-tooling-phase-1-ui-kit-templates-install-agent-skills branch from 7957b56 to 69e3038 Compare April 17, 2026 15:23
- Add Start Here block (Node 24, Yarn 3 Berry, React 19, dev-loop pointers)
- Add workspace-scoped test command; collapse full-build steps to `yarn build`
- Replace sub-package CLAUDE.md prose with `@AGENTS.md` import
- Drop rot-prone Slate version numbers and --format=transifex detail
- Fix prettier PostToolUse hook to use markdown parser for .md/.mdx
Copy link
Copy Markdown
Contributor

@ByronDWall ByronDWall left a comment

Choose a reason for hiding this comment

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

Skills are usable, agents.md files are accurate and well-scoped, lgtm!

@ByronDWall ByronDWall merged commit e950dd5 into main Apr 17, 2026
9 of 10 checks passed
@ByronDWall ByronDWall deleted the FEC-327-ai-tooling-phase-1-ui-kit-templates-install-agent-skills branch April 17, 2026 16:12
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.

3 participants