Skip to content

Refresh CLAUDE.md and agent docs for current tooling/versions#59

Merged
turegjorup merged 2 commits into
developfrom
docs/phpstan-level-8
Jul 9, 2026
Merged

Refresh CLAUDE.md and agent docs for current tooling/versions#59
turegjorup merged 2 commits into
developfrom
docs/phpstan-level-8

Conversation

@turegjorup

Copy link
Copy Markdown
Contributor

Audited README, CLAUDE.md, all .claude/agents/*, .claude/skills/**, and .claude/settings.json against composer.json, phpstan.dist.neon, phpunit.dist.xml, Taskfile.yml, the workflows, and the src/tests layout. Fixes the stale bits.

Corrected (were wrong)

  • CLAUDE.md — Stack line: API Platform 4.1 → 4.3; image itkdev/php8.3-fpmitkdev/php8.4-fpm.
  • CLAUDE.md + .claude/agents/pr-readiness.md — PHPStan level 6 → 8 (the code-analysis comment also now notes Rector).
  • .claude/agents/reload-fixtures.md — dropped the stale ignore_error: true fixtures rationale (removed from the Taskfile in the mappings PR).

Filled gaps (testing/architecture, newly true)

  • CLAUDE.md — the ES index contract is now CI-enforced (index-mapping-drift.yaml vs the importer's committed resources/mappings export), not only the local Stop hook.
  • CLAUDE.md — documented the test-suite layout that has grown since it was written: Contract/ (+ ContractSchemaTest, tests/schemas/), Consumer/ (aarhusguiden, os2display), the per-resource behavioural tests, and tests/Unit/.

Checked and accurate (no change)

PHP floor >=8.3, the six filters, failOnDeprecation/Notice/Warning, the PostToolUse Rector hook (#57), the skills (changelog-entry, new-resource, update-api-spec), filter-provider-reviewer, and .claude/settings.json hook commands. README pins no versions, so nothing stale there.

Audited the docs against the code. Corrections:
- Stack: API Platform 4.1 → 4.3, image itkdev/php8.3-fpm → php8.4-fpm.
- PHPStan level 6 → 8 (pr-readiness agent + the code-analysis comment,
  which also now notes Rector).
- Drop the stale `ignore_error: true` fixtures rationale from the
  reload-fixtures agent (removed from the Taskfile in the mappings PR).
- Note the CI-enforced index-mapping-drift gate (not just the local Stop
  hook) and document the test-suite layout (Contract/Consumer/Unit +
  tests/schemas) that has grown since CLAUDE.md was written.

README is accurate (pins no versions) and left as-is.
@codecov-commenter

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 72.89%. Comparing base (63839c8) to head (7dc5c25).
⚠️ Report is 4 commits behind head on develop.

Additional details and impacted files
@@            Coverage Diff             @@
##             develop      #59   +/-   ##
==========================================
  Coverage      72.89%   72.89%           
  Complexity       232      232           
==========================================
  Files             29       29           
  Lines            653      653           
==========================================
  Hits             476      476           
  Misses           177      177           
Flag Coverage Δ
unittests 72.89% <ø> (ø)

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

☔ View full report in Codecov by Harness.
📢 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.

@turegjorup turegjorup self-assigned this Jul 9, 2026
@turegjorup turegjorup merged commit 3e6860a into develop Jul 9, 2026
12 checks passed
@turegjorup turegjorup deleted the docs/phpstan-level-8 branch July 9, 2026 08: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.

2 participants