6869: Add claude.md and Claude Code configuration by turegjorup · Pull Request #62 · itk-dev/devops_itksites

turegjorup · 2026-03-19T11:38:13Z

Link to ticket

https://leantime.itkdev.dk/dashboard/show#/tickets/showTicket/6869

Description

Add vendor-neutral agents.md with project context for AI coding agents, and Claude Code settings with permissions, hooks, and plugins. Update README with AI coding agents section describing the setup.

https://dev.to/javiereguiluz/claude-code-for-symfony-and-php-the-setup-that-actually-works-1che

Latest additions:

Agents: PR readiness checker (runs all CI-equivalent checks locally) and Doctrine migration generator
Skills: /update-api-spec for regenerating OpenAPI spec files
Hooks: PreToolUse guard for lock files/.env.local, Prettier auto-format for JS/CSS/YAML/MD
MCP: Team-shared .mcp.json with context7 for live documentation lookup

Screenshot of the result

If your change affects the user interface you should include a screenshot of the result with the pull request.

Checklist

My code is covered by test cases.
My code passes our test (all our tests).
My code passes our static analysis suite.
My code passes our continuous integration process.

If your code does not pass all the requirements on the checklist you have to add a comment explaining why this change
should be exempt from the list.

Additional comments or questions

If you have any further comments or questions for the reviewer please add them here.

Add vendor-neutral agents.md with project context for AI coding agents, and Claude Code settings with permissions, hooks, and plugins. Update README with AI coding agents section describing the setup. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…_itksites into feature/6869_agent_config

cableman · 2026-03-19T12:43:43Z

.claude/settings.json

+    "feature-dev@claude-plugins-official": true
+  },
+  "alwaysThinkingEnabled": true,
+  "defaultMode": "acceptEdits"


I do not think this should be the default behavior, it will not match all users workflow. The "alwaysThinkingEnabled" will burn tokens and time way to fast. It is better to do "ultrathink" when you need it.

cableman · 2026-03-19T12:44:14Z

claude.md

@@ -0,0 +1,142 @@
+# 🤖 Code Agents - DevOps ITKsites


Note this file is not read by claude, this is jetbrains only

Renamed to claude.md

But it's not "jetbrains only" https://agents.md/ 😃

yepzdk · 2026-03-19T13:25:49Z

.claude/settings.json

+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"


Do we want to play with experimental as default in projects? 😊

yepzdk · 2026-03-19T13:26:55Z

.claude/settings.json

+      "Bash(gh release delete:*)",
+      "Bash(gh release edit:*)",
+      "Bash(gh repo create:*)",
+      "Bash(gh repo delete:*)",


Maybe move to deny, and lets the human delete?

All "delete" commands have been moved to "deny"

.claude/settings.json

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…_config

Co-authored-by: Jesper Pedersen <jesper@yepz.dk>

codecov-commenter · 2026-03-25T13:08:33Z

Codecov Report

❌ Patch coverage is 0% with 1 line in your changes missing coverage. Please review.
⚠️ Please upload report for BASE (develop@a555524). Learn more about missing BASE report.

Files with missing lines	Patch %	Lines
src/Trait/ExportCrudControllerTrait.php	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             develop      #62   +/-   ##
==========================================
  Coverage           ?   12.61%           
  Complexity         ?      819           
==========================================
  Files              ?      118           
  Lines              ?     2560           
  Branches           ?        0           
==========================================
  Hits               ?      323           
  Misses             ?     2237           
  Partials           ?        0

Flag	Coverage Δ
unittests	`12.61% <0.00%> (?)`

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

- Add PHPStan, twig-cs-fixer, and composer normalize PostToolUse hooks - Add SessionStart hook to ensure Docker services are running - Add Stop hook for Symfony DI container validation - Scope docker compose permissions (destructive commands require confirmation) - Restore php-lsp plugin - Set COMPOSE_USER env var Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Replace opaque RabbitMQ Erlang cookie with self-documenting value and add comment indicating these are local dev credentials. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

…_itksites into feature/6869_agent_config

- PHP 8.4+ → 8.5+, Symfony 7.3 → 8.0 - EasyAdmin 4.x → 5.x, PHPUnit 11+ → 13+ - Expand CI section to reflect all 14 workflow checks Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

github-actions · 2026-03-27T09:48:30Z

API Specification - Non-breaking changes

API Changelog 0.0.0 vs. 0.0.0

No changes

Use plain constructor instead of the removed static factory method, fixing PHPStan staticMethod.notFound errors. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Add PR readiness and migration generator agents, update-api-spec skill, PreToolUse lock file guard, Prettier PostToolUse hook, and team-shared .mcp.json with context7. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Convert absolute host paths to relative paths in all PostToolUse hooks using ${CLAUDE_FILE_PATH#$CLAUDE_PROJECT_DIR/} so tools inside Docker containers can resolve the files. Document agents, skills, hooks, and MCP servers in README. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Fix MD030 violations: reduce list marker spacing from 3 to 1 space. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

turegjorup requested a review from cableman March 19, 2026 11:38

turegjorup self-assigned this Mar 19, 2026

turegjorup and others added 3 commits March 19, 2026 12:44

&869: Update Chnagelog

1e7c04c

6869: Update Changelog

30a9a53

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Merge branch 'feature/6869_agent_config' of github.com:itk-dev/devops…

7b21a00

…_itksites into feature/6869_agent_config

cableman requested changes Mar 19, 2026

View reviewed changes

yepzdk reviewed Mar 19, 2026

View reviewed changes

.claude/settings.json Outdated Show resolved Hide resolved

turegjorup and others added 3 commits March 25, 2026 13:54

6869: Rename agents.md to claude.md and update settings

3d5ac2d

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Merge remote-tracking branch 'origin/develop' into feature/6869_agent…

864a7ca

…_config

Update .claude/settings.json

f07447d

Co-authored-by: Jesper Pedersen <jesper@yepz.dk>

turegjorup and others added 6 commits March 25, 2026 14:18

6869: Add PHPStan job to PR workflow

8c33faf

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

6869: Clarify local-only dev credentials in docker-compose.override

560e5e5

Replace opaque RabbitMQ Erlang cookie with self-documenting value and add comment indicating these are local dev credentials. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Merge branch 'feature/6869_agent_config' of github.com:itk-dev/devops…

82b77ae

…_itksites into feature/6869_agent_config

6869: Update claude.md for Symfony 8.0 and PHP 8.5

2ad001c

- PHP 8.4+ → 8.5+, Symfony 7.3 → 8.0 - EasyAdmin 4.x → 5.x, PHPUnit 11+ → 13+ - Expand CI section to reflect all 14 workflow checks Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

6869: Fix typo in config reference (@var → @type)

9a88a00

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

turegjorup and others added 3 commits March 27, 2026 10:53

6869: Fix FieldCollection::new() removed in EasyAdmin 5.x

9344dca

Use plain constructor instead of the removed static factory method, fixing PHPStan staticMethod.notFound errors. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

6869: Update task file with "pr.actions" check

39144a6

6869: Update defaults in claude.md

84caedc

turegjorup requested review from cableman and yepzdk March 27, 2026 10:11

turegjorup changed the title ~~6869: Add agents.md and Claude Code configuration~~ 6869: Add claude.md and Claude Code configuration Mar 27, 2026

turegjorup and others added 3 commits March 27, 2026 11:29

6869: Fix markdown lint errors in README.md

bac1888

Fix MD030 violations: reduce list marker spacing from 3 to 1 space. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

6869: Add claude.md and Claude Code configuration#62

6869: Add claude.md and Claude Code configuration#62
turegjorup wants to merge 19 commits intodevelopfrom
feature/6869_agent_config

turegjorup commented Mar 19, 2026 •

edited

Loading

Uh oh!

cableman Mar 19, 2026

Uh oh!

turegjorup Mar 27, 2026

Uh oh!

cableman Mar 19, 2026 •

edited

Loading

Uh oh!

turegjorup Mar 27, 2026

Uh oh!

turegjorup Mar 27, 2026

Uh oh!

yepzdk Mar 19, 2026

Uh oh!

turegjorup Mar 27, 2026

Uh oh!

yepzdk Mar 19, 2026

Uh oh!

turegjorup Mar 27, 2026

Uh oh!

Uh oh!

codecov-commenter commented Mar 25, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 27, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

turegjorup commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Link to ticket

Description

Screenshot of the result

Checklist

Additional comments or questions

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cableman Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

codecov-commenter commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

github-actions bot commented Mar 27, 2026

API Specification - Non-breaking changes

API Changelog 0.0.0 vs. 0.0.0

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

turegjorup commented Mar 19, 2026 •

edited

Loading

cableman Mar 19, 2026 •

edited

Loading

codecov-commenter commented Mar 25, 2026 •

edited

Loading