fix: implement workflow issues remediation plan

[nam20485]

Implements the approved remediation plan from docs/implementation-plan.md.

Changes in this repo

orchestrator-agent.yml

• Added skip-event job that runs for explicitly ignored events
• traycerai[bot] actor exclusion added to skip conditions [Issues 1, 16]
• orchestrate job now also skips for traycerai[bot]

.labels.json

• Stripped stale id, node_id, url fields from all entries [Issue 17]
• Added 9 missing labels: agent:queued, agent:in-progress, agent:success, agent:error, agent:infra-failure, agent:stalled-budget, implementation:complete, epic, story [Issues 2, 5]

AGENTS.md

• Removed delegation-depth constraint [Issue 18]
• Added .labels.json reference to coding conventions

orchestrator.md

• Removed all artificial depth/context budget constraints [Issue 18]
• Removed Progressive Context Reduction token limits
• Replaced Delegation Depth Management with unconstrained guidelines

scripts/create-project.ps1 [NEW]

• Standalone script for manual GitHub Project creation [Issue 4]
• Uses gh project create + gh project link
• Supports -DryRun flag

workflow-issues-and-fixes.md

• Updated statuses: 14 Complete, 8 Deferred

Companion PR in agent-instructions repo

https://github.com/nam20485/agent-instructions/compare/mn/workflow-assignment-fixes

init-existing-repository.md

• PR/branch creation moved to step 1 [Issue 3]
• .labels.json path corrected to .github/.labels.json
• Manual project creation instructions added [Issue 4]

create-project-structure.md

• Made tech-stack-agnostic [Issue 20]
• Added Docker COPY order guardrail [Issue 10]
• Added Python healthcheck guardrail [Issue 11]
• Added Python and Node.js example structures

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly refines the agent orchestration and workflow management system. It focuses on improving the efficiency and flexibility of automated processes by streamlining label management, removing restrictive delegation constraints, and providing a new utility for project setup. The changes aim to address identified workflow issues, making the system more robust and adaptable to various tasks.

Highlights

• Workflow Automation Enhancements: The orchestrator-agent.yml workflow was updated to include a skip-event job for explicitly ignored events and to exclude traycerai[bot] from triggering redundant orchestrator runs.
• Label Management Improvements: The .github/.labels.json file was cleaned by stripping stale id, node_id, and url fields, and 9 new agent-related and workflow labels were added. AGENTS.md was updated to reflect .labels.json as the single source of truth for repository labels.
• Agent Orchestration Flexibility: Artificial delegation depth and context budget constraints, including 'Progressive Context Reduction' token limits, were removed from orchestrator.md and AGENTS.md to allow for more flexible agent delegation.
• Project Setup Utility: A new PowerShell script, scripts/create-project.ps1, was introduced to facilitate manual GitHub Project creation and linking.
• Issue Remediation Tracking: The docs/workflow-issues-and-fixes.md document was updated to reflect the completion of 14 workflow-related issues and the deferral of 8 others.

Ignored Files

• Ignored by pattern: .github/workflows/** (1)
  • .github/workflows/orchestrator-agent.yml

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request implements a remediation plan for several workflow issues. The changes are extensive, touching workflow definitions, agent instructions, label configurations, and adding a new script for project creation. My review focuses on the correctness and robustness of these changes.

I've identified a couple of areas for improvement:

• In .github/.labels.json, there's a color collision between two new labels which could cause UI confusion.
• The new scripts/create-project.ps1 script could be made more robust by adding a dependency check for the gh CLI.

Overall, the changes are well-aligned with the implementation plan described. The suggestions provided aim to enhance clarity and script reliability.