Skip to content

Add AGENTS.md + CLAUDE.md, drop one-shot refresh-decisions#9

Merged
parisek merged 1 commit into
masterfrom
docs/agents-md
May 25, 2026
Merged

Add AGENTS.md + CLAUDE.md, drop one-shot refresh-decisions#9
parisek merged 1 commit into
masterfrom
docs/agents-md

Conversation

@parisek

@parisek parisek commented May 25, 2026

Copy link
Copy Markdown
Owner

Adds the documentation entrypoints expected by AI coding agents (Claude Code, Codex, Cursor, …), matching the `parisek/timber-kit` template:

  • AGENTS.md — authoritative operational notes: project shape, commands, the Drupal 11.x refresh procedure, inline-shim discipline rules (don't expand beyond `Escape`/`PlainTextOutput`/`NestedArray`/`MarkupInterface`, don't pull `drupal/core-*` back), PHPStan level-5 rationale + upgrade path to level 6, manual release process.
  • CLAUDE.md — 3-line pointer to AGENTS.md (single source of truth pattern).

Also removes `docs/refresh-decisions.md` — a one-shot artefact from the 1.6.0 refresh. The bits with long-term value (PHPStan rationale, shim-discipline rules) are folded into AGENTS.md; the rest is recoverable from git history if anyone needs to retrace the refresh.

Test plan

  • `vendor/bin/phpunit` → `OK (41 tests, 110 assertions)`
  • `vendor/bin/phpstan analyse` → `[OK] No errors`
  • CI passes on PHP 8.3 + 8.4

🤖 Generated with Claude Code

- AGENTS.md captures the long-term operational shape: project layout,
  commands, refresh procedure from Drupal 11.x, inline-shim discipline,
  PHPStan level rationale, release process.
- CLAUDE.md is a 3-line pointer to AGENTS.md, matching the
  parisek/timber-kit template.
- docs/refresh-decisions.md was a one-shot artefact from the 1.6.0
  refresh. The bits with long-term value (PHPStan level rationale,
  shim-discipline rules) live in AGENTS.md now. The rest is recoverable
  from git history if anyone needs to retrace the refresh.
Copilot AI review requested due to automatic review settings May 25, 2026 20:40
@parisek parisek self-assigned this May 25, 2026
@parisek parisek merged commit 6552d0c into master May 25, 2026
3 of 4 checks passed
@parisek parisek deleted the docs/agents-md branch May 25, 2026 20:41
@parisek parisek removed the request for review from Copilot May 25, 2026 21:04
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.

1 participant