orchestra-conventions

Define standardized project structures and roles for AI agent collaboration.

1|Updated Sep 17, 2025

Search Tags:#devops #project management #methodology #adr #ai collaboration #prds

Ready to run

npx skills add https://github.com/mpazaryna/agentic-factory --skill orchestra-conventions

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: orchestra-conventions
Source: https://github.com/mpazaryna/agentic-factory/tree/main/pm/orchestra/skills/conventions
Command: npx skills add https://github.com/mpazaryna/agentic-factory --skill orchestra-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a standardized methodology and folder structure for AI agents to collaborate within a project, ensuring clear communication, task management, and knowledge base organization.

Core Features & Use Cases

Standardized Project Structure: Defines conventions for roadmap, milestones, deliverables, ADRs, and devlogs within an .orchestra/ directory.
Role Definition: Outlines the distinct roles of Composer (human), Conductor (AI/human), and Orchestra (AI agents).
Agent Session Loop: Describes the workflow for agents: read score, perform task, update score.
Use Case: When onboarding a new AI agent to a project using the .orchestra/ methodology, this Skill provides the foundational knowledge for how the agent should interpret and interact with the project's roadmap, milestones, and deliverables.

Quick Start

Understand the .orchestra/ methodology for AI project collaboration.

Frequently Asked Questions about orchestra-conventions

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

FAQPage Schema

How do I structure my project for AI agent collaboration?▼

AI collaboration methodology establishes standardized project structures and folder conventions for agents. It solves communication and task management issues by defining specific roles (Composer, Conductor, Orchestra) and utilizing a `.orchestra/` directory for knowledge base organization.

What is the .orchestra methodology for AI project management?▼

The .orchestra methodology provides a standardized folder structure for AI project management, organizing roadmaps, milestones, and deliverables. It defines an agent session loop where agents read the score, perform tasks, and update the score within the knowledge base.

How do I onboard a new AI agent to an existing devops project?▼

Onboard a new AI agent by applying the `.orchestra/` methodology, which provides the foundational knowledge for interpreting roadmaps, milestones, and deliverables. The agent adheres to a hierarchical PRD structure and interacts via a specific materials table format.

Does this AI collaboration framework require specific role definitions?▼

Yes, the framework requires distinct role definitions for Composer (human), Conductor (AI/human), and Orchestra (AI agents). These roles are essential for managing the hierarchical PRD structure and tracking progress through the materials table format.

What is the best way to track AI agent tasks and progress in a codebase?▼

Track AI agent tasks by maintaining a hierarchical PRD structure and a specific materials table format within the `.orchestra/` directory. This standardizes how agents log work items and devlogs, ensuring clear communication and organized progress tracking.