Skip to content

fix(trogonstack-datadog): reconcile Customer-Facing group with I/P/D prefix convention#31

Merged
yordis merged 4 commits intomainfrom
fixes-17
Apr 2, 2026
Merged

fix(trogonstack-datadog): reconcile Customer-Facing group with I/P/D prefix convention#31
yordis merged 4 commits intomainfrom
fixes-17

Conversation

@yordis
Copy link
Copy Markdown
Member

@yordis yordis commented Apr 2, 2026

Summary

  • Introduces B (Business) as a proper 4th layer alongside I/P/D — for customer-visible outcomes and business transactions
  • Corrects D (Domain) description from "business metrics" to logical domain units in the system (bounded contexts, aggregates, domain components)
  • Renames the "Customer-Facing" group concept to "Business" across both datadog-review-dashboard and datadog-design-dashboard skills, updating all prefixes, layout templates, classification guides, and quality checklists

Closes #17

…prefix convention

Closes #17

Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@cursor
Copy link
Copy Markdown

cursor bot commented Apr 2, 2026

PR Summary

Low Risk
Low risk documentation-only change that updates naming and classification guidance for dashboard design/review; main risk is confusing teams if any external docs or dashboards still reference the old Customer-Facing/D-as-business convention.

Overview
Standardizes the dashboard guidance across the datadog-design-dashboard and datadog-review-dashboard skills by renaming the top-level Customer-Facing group to Business and introducing a B prefix for customer-visible/business-outcome metrics.

Updates the widget prefix taxonomy to treat D as technical domain-process health (not business outcomes), adds B0: examples/templates, and revises layout/strategy docs and checklists to expect B-prefixed metrics first and group ordering as business → overview → details/infrastructure.

Written by Cursor Bugbot for commit 9dd689b. This will update automatically on new commits. Configure here.

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 2, 2026

Warning

Rate limit exceeded

@yordis has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 0 minutes and 59 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 0 minutes and 59 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fc2fad7c-6fe4-4fb6-8bd2-8afa38edebd7

📥 Commits

Reviewing files that changed from the base of the PR and between 5edcd47 and 9dd689b.

📒 Files selected for processing (4)
  • plugins/trogonstack-datadog/skills/datadog-design-dashboard/SKILL.md
  • plugins/trogonstack-datadog/skills/datadog-design-dashboard/references/layouts.md
  • plugins/trogonstack-datadog/skills/datadog-design-dashboard/references/widgets.md
  • plugins/trogonstack-datadog/skills/datadog-review-dashboard/SKILL.md

Walkthrough

Documentation update clarifying that the Customer-Facing group functions as a cross-cutting view across the I/P/D layer system, where widgets retain their source-layer prefixes while the group itself remains unprefixed. Query value widgets in this group are exempted from prefix requirements.

Changes

Cohort / File(s) Summary
Documentation Clarification
plugins/trogonstack-datadog/skills/datadog-review-dashboard/SKILL.md
Clarified Customer-Facing group as a cross-cutting view rather than a new layer; specified that timeseries widgets retain source-layer prefixes (I, P, D) while the group name itself remains unprefixed; documented that query value widgets in Customer-Facing are exempt from prefix requirements; updated Quality Checklist to reflect these distinctions.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Poem

🐰 A dash of clarity through the tangle of prefixes bright,
The Customer-Facing group now finds its rightful sight—
Not a layer of its own, but a view that bridges wide,
Where I, P, and D dance together as a guide. ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the main change: reconciling the Customer-Facing group with the I/P/D prefix convention by clarifying how prefixes apply to widgets in this group.
Linked Issues check ✅ Passed The PR fully addresses issue #17 by clarifying Customer-Facing as a cross-layer view, requiring timeseries widgets retain source-layer prefixes, exempting QV widgets, and updating the quality checklist accordingly.
Out of Scope Changes check ✅ Passed All changes are within scope—the PR modifies only SKILL.md documentation to resolve the stated conflict between the layer-priority prefix system and the Customer-Facing group requirement.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check ✅ Passed The PR description accurately describes the changeset, focusing on clarifying the Customer-Facing group concept and layer-priority prefixes.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fixes-17

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
plugins/trogonstack-datadog/skills/datadog-review-dashboard/SKILL.md (1)

127-127: Consider consistent capitalization of "Query Value".

Line 74 uses "Query Value widgets" (capitalized), while this line uses "query value widgets" (lowercase). For consistency and clarity when referring to a specific widget type in Datadog, consider using the same capitalization throughout.

📝 Suggested consistency fix
-**Principle**: A dedicated "Customer-Facing" group should exist at the top of the dashboard with 5-8 key metrics for immediate outage identification. The specific metrics should reflect the product's business — not just generic traffic and error rates. This group is a cross-cutting view — its timeseries widgets keep their source-layer prefix (`I`, `P`, or `D`), and its query value widgets need no prefix.
+**Principle**: A dedicated "Customer-Facing" group should exist at the top of the dashboard with 5-8 key metrics for immediate outage identification. The specific metrics should reflect the product's business — not just generic traffic and error rates. This group is a cross-cutting view — its timeseries widgets keep their source-layer prefix (`I`, `P`, or `D`), and its Query Value widgets need no prefix.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@plugins/trogonstack-datadog/skills/datadog-review-dashboard/SKILL.md` at line
127, Standardize the capitalization of the Datadog widget type by changing
"query value widgets" to "Query Value widgets" in SKILL.md so it matches the
earlier usage ("Query Value widgets"); update every occurrence in the file
(including the line in the "Customer-Facing" principle and any other references)
to the same form to keep terminology consistent when referring to the specific
widget type.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@plugins/trogonstack-datadog/skills/datadog-review-dashboard/SKILL.md`:
- Around line 74-75: The design doc and review guidance conflict: SKILL.md's
"Prefix every widget title" principle vs. the exemption for Query Value widgets
in the "Customer-Facing" group; update SKILL.md to resolve this by either (a)
documenting the Query Value exemption explicitly under the naming rules (mention
"Query Value widget" and "Customer-Facing group"), (b) stating whether the
exemption applies globally or only inside Customer-Facing (clarify rationale
about big-number indicators), or (c) removing the special-case and requiring
prefixes everywhere; ensure references to the principle "Prefix every widget
title" and the group name "Customer-Facing" are updated so designers know the
rule at creation time.

---

Nitpick comments:
In `@plugins/trogonstack-datadog/skills/datadog-review-dashboard/SKILL.md`:
- Line 127: Standardize the capitalization of the Datadog widget type by
changing "query value widgets" to "Query Value widgets" in SKILL.md so it
matches the earlier usage ("Query Value widgets"); update every occurrence in
the file (including the line in the "Customer-Facing" principle and any other
references) to the same form to keep terminology consistent when referring to
the specific widget type.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 8ea03000-d8f8-40f3-a06d-48dd4cdb75d3

📥 Commits

Reviewing files that changed from the base of the PR and between 0dcf24b and 5edcd47.

📒 Files selected for processing (1)
  • plugins/trogonstack-datadog/skills/datadog-review-dashboard/SKILL.md

yordis added 3 commits April 2, 2026 19:04
- Adds `B0-N:` prefix for customer-visible outcomes and business transactions
- Corrects `D` (Domain) description from "business metrics" to logical domain units
- Replaces the "Customer-Facing" cross-cutting view concept with the B layer
- Renames Section 5 and all references from Customer-Facing to Business

Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
…shboard skill

- Corrects D layer description from "business metrics" to domain units
- Adds B layer throughout: SKILL.md, widgets.md layers table, classification guide, and all 4 layout templates in layouts.md
- Renames "Customer-Facing" group to "Business" and updates prefixes from mixed I/P/D to B in all layout diagrams
- Updates Dashboard Strategy table and Group Structure section

Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
… business

Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>
@yordis yordis merged commit 0729e02 into main Apr 2, 2026
4 checks passed
@yordis yordis deleted the fixes-17 branch April 2, 2026 23:14
Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

│ │ (QV+bg) │ (QV+bg) │ (QV+bg) │ (QV+bg) │ │
│ ├──────────────────────┬────────────────────┤ │
│ │ D0: Key txn success │ I0: DB conn pool │ │
│ │ B0: Key txn success │ B1: DB conn pool │ │
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Infrastructure metrics incorrectly re-prefixed as Business layer

Medium Severity

Several infrastructure metrics in layout templates were blindly re-prefixed from I to B when the "Customer-Facing" group was renamed to "Business." Specifically: B1: DB conn pool (lines 74, 250) was formerly I0: DB conn pool, and B0: Host avail. / B1: Network errors (line 136) were formerly I0: prefixed. These are infrastructure metrics per the classification guide in widgets.md (databases, networks, OS resources), not business outcomes. The widgets.md examples were updated correctly to exclude non-B metrics from the Business group, but the layout templates were not — creating an internal inconsistency that will confuse the AI skill and produce incorrectly classified dashboards.

Additional Locations (2)
Fix in Cursor Fix in Web

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.

datadog-review-dashboard: Customer-Facing group conflicts with I/P/D prefix convention

1 participant