Skip to content

[instructions] Sync instruction files with release v0.80.4#40275

Merged
pelikhan merged 1 commit into
mainfrom
instructions-sync-mcp-scripts-dependencies-f868ccb161efc868
Jun 19, 2026
Merged

[instructions] Sync instruction files with release v0.80.4#40275
pelikhan merged 1 commit into
mainfrom
instructions-sync-mcp-scripts-dependencies-f868ccb161efc868

Conversation

@github-actions

@github-actions github-actions Bot commented Jun 19, 2026

Copy link
Copy Markdown
Contributor

Document dependencies: frontmatter field for mcp-scripts steps

Summary

Adds documentation for the new dependencies: frontmatter field in agentic workflow step files (.github/aw/syntax-agentic.md). This field lets workflow authors declare per-step npm/pip/go package dependencies that are resolved by the agentic runtime before the step executes. The docs cover per-manager resolution rules, the exact-version-pinning requirement, and include an inline example using @octokit/rest@21.0.2.

Changes

File Change Impact
.github/aw/syntax-agentic.md Added dependencies: field docs + updated inline example Medium

Details

.github/aw/syntax-agentic.md — The frontmatter reference for agentic workflow steps now documents the dependencies: field:

  • Describes per-manager resolution rules (npm, pip, go, apt)
  • Calls out the exact-version-pinning requirement — floating ranges are not permitted
  • Updates the embedded example to demonstrate the field with @octokit/rest@21.0.2

Notes

  • Documentation-only change; no runtime code is modified.
  • Breaking: no
  • Authors of existing workflow step files should review the pinning requirement if they plan to adopt the field.

Generated by PR Description Updater for issue #40275 · 36 AIC · ⌖ 6.74 AIC · ⊞ 4.5K ·

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation instructions labels Jun 19, 2026
@github-actions

Copy link
Copy Markdown
Contributor Author

Great work from the Instructions Janitor 🧹 — documenting the mcp-scripts.dependencies field was a real accuracy gap against v0.80.4, and this closes it cleanly in .github/aw/syntax-agentic.md. The diff is minimal (+5/-5), the description includes a thorough accuracy audit against the Go source, a size audit confirming the file stays at exactly 500 lines, and a duplication audit. Everything looks well-reasoned.

  • No test files changed — this is a documentation-only change and no test files are applicable. This flag can be disregarded for this PR type.

If you'd like to add a validation step for future instruction syncs, here's a ready-to-use prompt:

Validate the updated .github/aw/syntax-agentic.md instruction file after the mcp-scripts.dependencies addition:
1. Confirm the file is exactly 500 lines (`wc -l .github/aw/syntax-agentic.md`).
2. Verify the `dependencies:` field description matches the behavior in `pkg/workflow/mcp_scripts_dependencies_validation.go` (manager inference, exact-version-pin requirement).
3. Confirm the inline example uses an exact-version-pinned package (e.g., `@octokit/rest@21.0.2`).
4. Check `pkg/parser/schemas/main_workflow_schema.json` around line 10849 — `additionalProperties: false` on the mcp-scripts tool object does not yet list `dependencies`. Flag this schema gap for maintainers if it remains unaddressed.

Generated by ✅ Contribution Check · 143.7 AIC · ⌖ 7.66 AIC · ⊞ 5.9K ·

@pelikhan pelikhan merged commit 2e59910 into main Jun 19, 2026
@pelikhan pelikhan deleted the instructions-sync-mcp-scripts-dependencies-f868ccb161efc868 branch June 19, 2026 13:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation instructions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant