// Create a pull request for Agent Health following all compliance requirements. Use after implementing a feature or fix. Handles SPDX headers, DCO signoff, CHANGELOG, and the PR template.
| name | create-pr |
| description | Create a pull request for Agent Health following all compliance requirements. Use after implementing a feature or fix. Handles SPDX headers, DCO signoff, CHANGELOG, and the PR template. |
You are helping the user create a compliant PR for the Agent Health project.
Run these before creating the PR:
npm run build:all && npm run test:all
Must pass. Never use --no-verify.
Every new .ts, .tsx, .js source file needs:
/* Copyright OpenSearch Contributors
SPDX-License-Identifier: Apache-2.0 */
Check for missing headers:
grep -rL 'SPDX-License-Identifier' src/ cli/ server/ services/ --include='*.ts' --include='*.tsx'
Every commit needs Signed-off-by: line:
git log --format='%H %s' origin/main..HEAD | while read hash msg; do
git log -1 --format='%b' $hash | grep -q 'Signed-off-by:' || echo "MISSING: $hash $msg"
done
Fix missing signoff (for last commit):
git commit --amend -s --no-edit
Add entry under ## [Unreleased] in the appropriate section:
### Added — new features### Fixed — bug fixes### Changed — modifications to existing features### Removed — removed featuresFormat: - Description of change ([#PR](link))
gh pr create --title "<type>: <concise description>" --body "$(cat <<'EOF'
## Summary
- <bullet 1>
- <bullet 2>
## Test plan
- [ ] Unit tests added/updated
- [ ] `npm run build:all && npm run test:all` passes
- [ ] Manual verification: <describe what to check>
EOF
)"
feat: — new featurefix: — bug fixrefactor: — code restructuring (no behavior change)docs: — documentation onlytest: — test additions/changeschore: — maintenance tasksKeep title under 70 characters.
Diagnose and fix bugs in Agent Health. Use when a user reports a bug, failing test, or unexpected behavior. Follows a systematic diagnosis → fix → verify workflow.
Guided feature implementation for Agent Health. Use when a user wants to add a new capability, endpoint, CLI command, or UI component to the Agent Health project. Ensures correct architecture layer, coding conventions, test coverage, and PR readiness.
Add OpenTelemetry instrumentation to an AI agent for Agent Health observability. Use when a user wants to make their agent's traces visible in Agent Health dashboards, or when debugging why traces aren't appearing. Covers span structure, Gen AI semantic conventions, required attributes, and OTLP exporter setup.
Set up an OpenTelemetry collector or OSIS pipeline to route traces from an agent to OpenSearch for Agent Health consumption. Covers OSIS, OTel Collector, and direct export configurations.
Write tests for Agent Health following project conventions. Use when adding tests for new features, bug fixes, or improving coverage. Covers Jest setup, mocking patterns, path aliases, and coverage thresholds.
Use when working on config loading, authentication, AWS profiles, or data source resolution. Explains the two config systems (TS vs JSON), auth priority, and multi-profile setup.