Support for Contributions of Agentic Workflows

[brunoborges]

Summary

Makes this project welcoming to users who want to contribute their own Agentic Workflows — AI-powered repository automations that run coding agents in GitHub Actions, defined in markdown with natural language instructions.

Changes

• New workflows/ directory for community-contributed agentic workflows (flat .md files)
• Build pipeline integration — metadata parsing, README generation, and website data generation for workflows
• CI validation workflow (validate-agentic-workflows-pr.yml) with two jobs:
  • Block forbidden files — rejects .yml, .yaml, .lock.yml, and .github/ modifications
  • Compile and validate — runs gh aw compile --validate on each workflow .md file
• Documentation updates — README.md, CONTRIBUTING.md, and AGENTS.md with workflow docs, contributing guidelines, examples, and code review checklists
• PR template updated with Agentic Workflow as a contribution type
• validate-readme.yml updated to trigger on workflows/** changes

Type of Contribution

• New agentic workflow.
• Other: Infrastructure to support agentic workflow contributions

[Copilot]

Pull request overview

Adds first-class repository support for community-contributed Agentic Workflows (markdown-defined automations for gh-aw), integrating them into the build/readme generation, website data generation, CI validation, and contribution docs.

Changes:

• Introduces a new workflows/ resource type (flat .md files) with metadata parsing and README generation.
• Extends website data/search index generation to include workflows and emits workflows.json.
• Adds PR-time CI validation for workflow contributions and updates docs/templates to include workflows.

Reviewed changes

Copilot reviewed 11 out of 12 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
workflows/.gitkeep	Ensures the new workflows/ directory exists in git.
eng/yaml-parser.mjs	Adds parseWorkflowMetadata() for workflow frontmatter parsing.
eng/update-readme.mjs	Generates docs/README.workflows.md via a new workflows section builder.
eng/generate-website-data.mjs	Generates workflows metadata, adds workflows to search index, and writes workflows.json.
eng/constants.mjs	Adds WORKFLOWS_DIR and new README template snippets for workflows.
docs/README.workflows.md	New generated documentation page for workflows (currently empty state).
README.md	Adds workflows to the main README navigation and repo structure/docs.
CONTRIBUTING.md	Adds contribution guidance and an example workflow file format.
AGENTS.md	Documents workflow file expectations and adds a review checklist for workflows.
.github/workflows/validate-readme.yml	Triggers README validation when workflows/** changes.
.github/workflows/validate-agentic-workflows-pr.yml	New CI workflow to block forbidden files and validate workflows with gh aw compile --validate.
.github/pull_request_template.md	Adds “agentic workflow” as a contribution type and checklist item.

Comments suppressed due to low confidence (1)

.github/workflows/validate-agentic-workflows-pr.yml:112

• Same as earlier: commenting on PRs from forks will usually fail under pull_request due to missing write permissions. Please guard this step with a permission check (like validate-readme.yml does) so validation failures still surface without the workflow erroring while trying to comment.

      - name: Comment on PR if compilation failed
        if: failure()
        uses: marocchino/sticky-pull-request-comment@v2
        with:
          header: workflow-validation

[aaronpowell]

@brunoborges your actions files because of the .gitkeep I think 😅