chore: improve project prompt instructions

[mnkiefer]

• Updates documentation, schemas, and tool descriptions related to GitHub Projects integration in agentic workflows:
  • Clarify usage, requirements, and expand support for custom fields, views, and status updates.
  • Emphasize the need for a Personal Access Token (PAT) with Projects permissions, and provide more detailed guidance on configuration and agent output fields.

[Copilot]

Pull request overview

This PR updates the human-facing descriptions/instructions for GitHub Projects (ProjectOps) safe-output tools across the tool metadata JSON, workflow schema descriptions, and repository documentation so agents get clearer guidance when creating/updating Projects and posting status updates.

Changes:

• Expanded and reworded tool descriptions for update_project, create_project, and create_project_status_update.
• Updated main_workflow_schema.json descriptions for the project-related safe-outputs configuration.
• Reworked ProjectOps guidance in .github/aw/github-agentic-workflows.md (requirements, examples, and calling modes).

Reviewed changes

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

File	Description
pkg/workflow/js/safe_outputs_tools.json	Updates Projects-related tool descriptions for the workflow prompt tooling.
actions/setup/js/safe_outputs_tools.json	Updates Projects-related tool descriptions used by the JS setup/runtime tooling.
pkg/parser/schemas/main_workflow_schema.json	Updates schema descriptions for project-related safe-outputs config.
.github/aw/github-agentic-workflows.md	Updates documentation/examples for configuring and using ProjectOps safe-outputs.

---

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

[Copilot]

@mnkiefer I've opened a new pull request, #14987, to work on those changes. Once the pull request is ready, I'll request review from you.

[mnkiefer]

@copilot recompile workflows

[Copilot]

@mnkiefer I've opened a new pull request, #14992, to work on those changes. Once the pull request is ready, I'll request review from you.

[Copilot]

Pull request overview

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

Comments suppressed due to low confidence (1)

pkg/workflow/js/safe_outputs_tools.json:929

• The create_project MCP handler auto-generates and returns a temporary_id (and returns project: "#<temporary_id>") (see actions/setup/js/safe_outputs_handlers.cjs). However this embedded tool schema for create_project doesn’t include temporary_id in its input schema, and the description doesn’t mention the returned #aw_... reference. For consistency with actions/setup/js/safe_outputs_tools.json and to avoid confusing agents, consider adding the optional temporary_id field here too (or clarify that it’s always auto-generated).

    "name": "create_project",
    "description": "Create a new GitHub Project board. Use this to create a new project for organizing and tracking work across issues and pull requests, owned by a specific user or organization. You can optionally provide a custom title and add an initial issue item to the project via item_url.",
    "inputSchema": {
      "type": "object",

---

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

[Copilot]

@mnkiefer I've opened a new pull request, #14995, to work on those changes. Once the pull request is ready, I'll request review from you.

[Copilot]

@mnkiefer I've opened a new pull request, #14996, to work on those changes. Once the pull request is ready, I'll request review from you.