[docs] Update documentation for features from 2026-05-21

[github-actions]

Summary

Aligns package manifest documentation with PR #33660 by documenting support for raw GitHub Actions YAML (.yml) files in aw.yml packages alongside agentic markdown workflows.

Changes

Documentation Updates (3 files)

• docs/src/content/docs/reference/aw-yml-package-manifest.md (high impact)

  • Added support for raw GitHub Actions YAML files in the files array alongside agentic workflow markdown
  • Documented detailed installation behavior: markdown workflows are processed/translated, YAML files are copied verbatim

• docs/src/content/docs/reference/repository-package-manifest-specification.md (high impact)

  • Expanded specification to allow raw .yml GitHub Actions workflows as direct children of .github/workflows/
  • Documented verbatim copy semantics for YAML files
  • Clarified that auto-discovery only applies to markdown files

• docs/src/content/docs/reference/repository-package-manifest.md (medium impact)

  • Updated to describe two supported workflow kinds: agentic markdown and raw YAML
  • Documented respective installation and processing behavior for each type

Impact

• Breaking changes: None
• User-facing changes: Documentation now accurately reflects support for both markdown and YAML workflow files in packages
• Files changed: 3 documentation files (+26 lines, -13 lines)

Context

Previously, the package manifest documentation incorrectly stated that files entries MUST end in .md. This PR updates the reference and specification documentation to reflect the implementation in PR #33660, which extended aw.yml to accept both:

1. Agentic markdown workflows (.md) that are processed and translated during installation
2. Raw GitHub Actions YAML files (.yml) that are copied verbatim to .github/workflows/

Generated by PR Description Updater for issue #33745 · ● 985.5K · ◷