Skip to content

docs: CLAUDE.md updates for 5 active repos (June 2026)#9

Open
shrivastavakapil2000 wants to merge 2 commits into
mainfrom
claude/serene-davinci-lMI1P
Open

docs: CLAUDE.md updates for 5 active repos (June 2026)#9
shrivastavakapil2000 wants to merge 2 commits into
mainfrom
claude/serene-davinci-lMI1P

Conversation

@shrivastavakapil2000

@shrivastavakapil2000 shrivastavakapil2000 commented Jun 7, 2026

Copy link
Copy Markdown

Summary

This PR adds updated/new CLAUDE.md files for the 5 most active Resonate repositories, based on a review of merged PRs from June 2025–June 2026 by contributors: SayaliPat, shrivastavakapil2000, JoeVsVolcano, PallaviJagarlamudi, mike-brant, and nathan-resonate (PallaviJagarlamudi had no merged PRs in this period).

Files are staged in claude-md-updates/ for review before being applied to each target repo.

Repositories Covered

Repository Action PR Activity Key Changes Documented
resonate/step-function-workflow-orchestrator Update existing 42 PRs EMR7 upgrades (5 pipelines), cookiejar-sample-export decommission
resonate/batch-expression-modeling Update existing 8 PRs BlockGraph vendor support (CDP-118913), batch stitch throttle fix
resonate/resonate-terraform Create new 6 PRs Monitoring/alerting overhaul (DE-13849), Nagios → Slack+PagerDuty
resonate/batch-audience-delivery-syndication Create new 5 PRs BlockGraph/FreeWheel file syndication Lambdas (CDP-118915/16/17)
resonate/identity-graph Create new 4 PRs prism_dbt v1.0, NAME_ADDRESS UDF+SP, CI workflows (CDP-119018)

How to Apply

See claude-md-updates/README.md for gh api commands to apply each file to its target repository. The commands for existing-CLAUDE.md repos include SHA fetch steps to avoid GitHub API rejection.

Test plan

  • Review each CLAUDE.md for accuracy against the repo's actual code and recent PRs
  • Apply step-function-workflow-orchestrator/CLAUDE.md to the target repo (update)
  • Apply batch-expression-modeling/CLAUDE.md to the target repo (update)
  • Create resonate-terraform/CLAUDE.md in the target repo (new)
  • Create batch-audience-delivery-syndication/CLAUDE.md in the target repo (new)
  • Create identity-graph/CLAUDE.md in the target repo (new)

https://claude.ai/code/session_011tgujgCjwfxgGcDx6XNnH4

Review and update CLAUDE.md files for the 5 most active resonate repositories
based on merged PRs from contributors: SayaliPat, shrivastavakapil2000,
JoeVsVolcano, mike-brant, and nathan-resonate.

Repos covered:
- step-function-workflow-orchestrator (updated): EMR7 upgrades, cookiejar deprecation
- batch-expression-modeling (updated): BlockGraph vendor support (CDP-118913)
- resonate-terraform (new): monitoring/alerting stack overhaul (DE-13849)
- batch-audience-delivery-syndication (new): BlockGraph/FreeWheel file syndication
- identity-graph (new): prism_dbt v1.0, NAME_ADDRESS UDF, CI workflows

https://claude.ai/code/session_011tgujgCjwfxgGcDx6XNnH4
Copilot AI review requested due to automatic review settings June 7, 2026 13:15

Copilot AI 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.

Pull request overview

This PR stages updated/new CLAUDE.md documentation for five active Resonate repositories (plus an internal README describing how to apply them), intended to be reviewed in-repo before being pushed to the target repos.

Changes:

  • Add staged CLAUDE.md docs for step-function-workflow-orchestrator, batch-expression-modeling, resonate-terraform, batch-audience-delivery-syndication, and identity-graph.
  • Add claude-md-updates/README.md with gh api commands to apply the staged files to their target repositories.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
claude-md-updates/step-function-workflow-orchestrator/CLAUDE.md Documents repo structure, workflows, terragrunt/CI deployment, and operational gotchas for Step Functions + lambdas.
claude-md-updates/batch-expression-modeling/CLAUDE.md Documents BEM pipeline architecture, deployment workflows, JSONata guidance, and recent vendor-related updates.
claude-md-updates/resonate-terraform/CLAUDE.md Documents resonate-terraform layout, drift detection, CI workflows, and recent monitoring/alerting changes.
claude-md-updates/batch-audience-delivery-syndication/CLAUDE.md Documents BlockGraph/FreeWheel syndication lambdas, deployment, and end-to-end flow context.
claude-md-updates/identity-graph/CLAUDE.md Documents PRISM identity graph dbt package primitives, testing/deploying, and recent v1.0 changes.
claude-md-updates/README.md Explains which staged docs map to which repos and provides copy/paste gh api apply commands.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread claude-md-updates/README.md Outdated
@@ -0,0 +1,56 @@
# CLAUDE.md Updates

This directory contains updated `CLAUDE.md` files for the 5 most active Resonate repositories (based on merged PRs from June 2025–June 2026 by contributors: SayaliPat, shrivastavakapil2000, JoeVsVolcano, PallaviJagarlamudi, mike-brant, nathan-resonate).
Comment on lines +26 to +33
gh api -X PUT repos/resonate/step-function-workflow-orchestrator/contents/CLAUDE.md \
--field message="docs: update CLAUDE.md with EMR7 upgrades and cookiejar deprecation" \
--field content="$(base64 -i step-function-workflow-orchestrator/CLAUDE.md)"

# batch-expression-modeling
gh api -X PUT repos/resonate/batch-expression-modeling/contents/CLAUDE.md \
--field message="docs: update CLAUDE.md with BlockGraph vendor support" \
--field content="$(base64 -i batch-expression-modeling/CLAUDE.md)"
Comment on lines +125 to +128
`prism_default_waterfall` (PRISM's recommended order, high-precision first):
HEM_MD5 → HEM_SHA1 → HEM_SHA256 → MAID → RAMP_ID → TTD → CTV_ID → RCID → L2_VOTER_ID → L2_CONSUMER_ID → ZIP11

**Intentionally excluded from default** (opt-in only): `IP`, `PHONE_CELL`, `PHONE_LANDLINE`, `NONID`, `HOUSEHOLD_ID`, `L2_FAMILY_ID`, `EXPERIAN_*`, `NAME_ADDRESS`.
- Prod: `arn:aws:iam::694585954309:role/ProdTerraform` (assumed via `role_arn` in `step_function.hcl`)

**State bucket:** `resonate-terraforming-state` (non-prod) / `resonate-terraforming-state-prod` (prod)
**State key prefix:** `environments/mgmt/lambdas/x_men/` (lambdas) or `environments/mgmt/lambdas/x_men|agents_of_shield/` (step functions)
└─> blockgraph-publish-files (upload to FreeWheel)
```

The step function orchestrating these three Lambdas lives in `step-function-workflow-orchestrator` (or this repo — check `workflows/step-functions/`).
- README: note PallaviJagarlamudi had 0 merged PRs (consistent with PR body)
- README: add SHA fetch + placeholder to gh api update commands for existing
  CLAUDE.md repos (step-function-workflow-orchestrator, batch-expression-modeling)
- identity-graph: correct ZIP11 in Recent Changes — it IS in the default
  waterfall (resolves via persons.zip11, not excluded)
- batch-audience-delivery-syndication: replace ambiguous step function location
  with actionable search instructions
- step-function-workflow-orchestrator: clarify the literal `|` in the step
  function state key prefix

https://claude.ai/code/session_011tgujgCjwfxgGcDx6XNnH4
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.

3 participants