Skip to content

chore(agents): add starter dd-trace-php overrides for dd-apm-sdk-review - #4191

Draft
robertomonteromiguel wants to merge 4 commits into
robertomonteromiguel/dd-apm-sdk-review-core-copyfrom
robertomonteromiguel/dd-apm-sdk-review-php-overrides
Draft

robertomonteromiguel wants to merge 4 commits into
robertomonteromiguel/dd-apm-sdk-review-core-copyfrom
robertomonteromiguel/dd-apm-sdk-review-php-overrides

Conversation

@robertomonteromiguel

@robertomonteromiguel robertomonteromiguel commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

Adds the dd-trace-php layer on top of the shared skill copy.

  • .agents/dd-apm-sdk-review-overrides/ — one starter PHP reviewer fact: userland follows PSR-2 / composer lint (fix with composer fix-lint), as written in CONTRIBUTING.md § "PHP linting"
  • AGENTS.md — short hook (this repo had none): local agents run the skill; Codex reads review-without-harness.md
  • .llm-validation/ — first suite in this repo, one case (php-conventions-psr2), plus the GitLab "llm validation" include

Stacked on the core-copy PR (#4190). Shared skill source: dd-apm-sdk-review-core#1.

Motivation

This is the half that PHP reviewers should actually read. The repo had no agent hook or eval gate yet; this lands the minimum so the skill is usable.

Additional Notes

How to review

  • Start here: .agents/dd-apm-sdk-review-overrides/
  • Then: the AGENTS.md Review Guidelines block
  • Then: .llm-validation/ if you care about the gate
  • Skip .agents/skills/dd-apm-sdk-review/ — that is the parent PR / core repo

Merge with the parent skill-copy PR, not as a standalone.

Reviewer checklist

  • Test coverage seems ok.
  • Appropriate labels assigned.

Made with Cursor

One PSR-2 convention rule, a short AGENTS.md hook, and one llm-validation case.

Co-authored-by: Cursor <cursoragent@cursor.com>
@datadog-official

datadog-official Bot commented Sep 14, 2026

Copy link
Copy Markdown

Pipelines  Tests

Unblock PR with BitsAI

⚠️ Warnings

Your PR has failed checks. Please review the issues below and take necessary action before merging.

🚦 16 Pipeline jobs failed

DataDog/apm-reliability/dd-trace-php | Loader test on amd64 libc: [8.3, zts, amd64, true] — 🔧 Needs a code fix, caused by this PR

View more details · View in GitLab

DataDog/apm-reliability/dd-trace-php | check libxml2 version — 🔧 Needs a code fix, caused by this PR

View more details · View in GitLab

DataDog/apm-reliability/dd-trace-php | min install tests — 🔧 Needs a code fix, caused by this PR

View more details · View in GitLab

View all 16 failed jobs.

ℹ️ Info

No other issues found (see more)

🧪 All tests passed
❄️ No new flaky tests detected

🎯 Code Coverage (details)
Patch Coverage: 100.00%
Overall Coverage: 55.03% (+0.00%)

Useful? React with 👍 / 👎

This comment will be updated automatically if new data arrives.
🔗 Commit SHA: fb69c90 | Docs | View more details | Give us feedback!

GitHub Codex follows markdown links in AGENTS.md. Link the skill
folder (same hook as js/go/rb) and review-without-harness.md so the
review spec lands in the GitHub review context.

Co-authored-by: Cursor <cursoragent@cursor.com>
Document how to add a review-skill case and how to run the suite locally,
same shape as dd-trace-go / dd-trace-rb.
Watch the full skill tree like go/rb, ignore local eval artifacts, and
give PHP an explicit CODEOWNERS + CONTRIBUTING pointer for the gate.
@robertomonteromiguel

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fb69c9011c

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".


## PHP userland follows PSR-2

PHP under this repo must follow [PSR-2](https://www.php-fig.org/psr/psr-2/). Style is checked with `composer lint` and auto-fixed with `composer fix-lint`. A new or edited `.php` file that uses Allman braces, tabs for indent, or otherwise fails that check is a finding. Do not invent a different house style.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Stop rejecting PSR-2 brace placement

When reviewing a class or method that correctly puts its opening brace on the next line, this instruction tells the reviewer to report the compliant Allman-style placement as a defect, even though the cited PSR-2 source of truth requires that placement and the repository uses it throughout. This will produce false review findings; remove “Allman braces” from the prohibited examples and describe the fixture’s actual excessive brace indentation instead.

AGENTS.md reference: AGENTS.md:L15-L17

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant