nexus-orchestrator

Plan epics, decompose into subtasks, and delegate work via Nexus CLI.

2|Updated Jun 29, 2021
One-click install
npx skills add https://github.com/pypeaday/dotfiles --skill nexus-orchestrator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nexus-orchestrator
Source: https://github.com/pypeaday/dotfiles/tree/main/opencode/.config/opencode/skill/nexus-orchestrator
Command: npx skills add https://github.com/pypeaday/dotfiles --skill nexus-orchestrator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinate nexus work by planning epics/features, decomposing into subtasks, and delegating to worker subagents within a consistent, auditable workflow.

Core Features & Use Cases

  • Project context discovery and scoping using environment state and repo name, enabling correct Nexus project selection.
  • Claiming epics/features, decomposing into subtasks, and delegating work to worker subagents to ensure ownership and visibility.
  • Plan-first workflow with human approval for feature work and streamlined handling for smaller tasks.
  • Monitoring, updating, and completing tasks with Nexus CLI commands to maintain alignment and progress.
  • Delegation patterns and standardized context to ensure reproducible workflows across teams.

Quick Start

Example workflow to start an orchestration:

  • Claim a high-level issue: nexus issue claim <epic-id>
  • Explore scope and, if needed, create a plan: nexus plan create --for-issue <id> --type feature --body -
  • Present plan for human approval and set ready when approved: nexus plan show <plan-id> --format json | jq .ready; nexus plan update <plan-id> --ready
  • Decompose into subtasks: nexus issue create --parent <id> --title "Add ..."; delegate to workers
  • Monitor subtasks: nexus issue list --parent <id> --format json

Frequently Asked Questions about nexus-orchestrator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I decompose project epics into subtasks and delegate them to workers?

To decompose project epics into subtasks and delegate them, claim the high-level issue, create a plan for approval, then use nexus issue create with a parent ID to generate subtasks and delegate them to worker subagents for execution.

What is a plan-first workflow for project orchestration?

A plan-first workflow for project orchestration requires creating a plan and obtaining human approval before any feature work begins, ensuring a readiness gate is passed so subtasks can only be claimed after the plan is explicitly approved.

How does delegating work to subagents improve project management?

Delegating work to subagents improves project management by enforcing standardized context and ownership, ensuring reproducible workflows across teams while maintaining alignment through monitoring and updating tasks with CLI commands.

Can I use the Nexus CLI to monitor delegated subtasks?

Yes, you can use the Nexus CLI to monitor delegated subtasks by running nexus issue list with the parent ID to track progress and maintain alignment across the decomposed project work.

Do I need human approval before claiming feature subtasks?

Yes, you need human approval before claiming feature subtasks because the orchestration enforces a readiness gate, requiring you to create a plan, present it for approval, and set it to ready before subtasks can be claimed.

How do I handle project context discovery for Nexus orchestration?

You handle project context discovery for Nexus orchestration by using the environment state and repository name, enabling the system to automatically select the correct Nexus project for your workflow.