compozy

Explain Compozy CLI commands, pipeline phases, and artifact structure.

Updated May 15, 2026
One-click install
npx skills add https://github.com/JBonfim/skill-developer --skill compozy-jbonfim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: compozy
Source: https://github.com/JBonfim/skill-developer/tree/main/.agents/skills/compozy
Command: npx skills add https://github.com/JBonfim/skill-developer --skill compozy-jbonfim

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Compozy users need a single, accurate reference for how the CLI, skills, workflow pipeline, artifacts, and reusable agents fit together so they can configure and run end-to-end AI-assisted development reliably.

Core Features & Use Cases

  • Workflow orchestration map: explains the full pipeline from setup through ideation, PRD, tech design, task decomposition, execution, review, remediation, and archive.
  • CLI command quick reference: documents the key commands and the most important flags for setup, execution, review fetching, review fixing, validation, syncing, and archiving.
  • Skill and artifact conventions: defines core skills (cy-create-prd, cy-create-techspec, cy-create-tasks, cy-review-round, cy-fix-reviews, cy-final-verify, etc.) and the .compozy/tasks/<slug>/ artifact layout they produce and consume.
  • Reusable agents and extension model: describes how workspace-scoped agents and optional extensions (like cy-idea-factory) extend capabilities and council-driven planning.
  • Configuration guidance: summarizes .compozy/config.toml defaults and how CLI flags override configuration.

Quick Start

Ask the AI: "Explain how to run the Compozy pipeline for a new feature, including which commands to use and where the generated files will appear under .compozy/tasks."

Frequently Asked Questions about compozy

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

FAQPage Schema
How do I run the Compozy pipeline for a new feature end to end?

To run the Compozy pipeline, you execute CLI commands sequentially from setup through ideation, PRD, tech design, task decomposition, execution, review, remediation, and archive. Generated files appear under the `.compozy/tasks/<slug>/` artifact layout.

What is the AI workflow execution-to-review-to-remediation pipeline?

The AI workflow pipeline is a deterministic process where generated tasks are executed, fetched for review, fixed via remediation commands, and validated. It ensures end-to-end AI-assisted development reliability by defining clear pipeline phases and file outputs.

Which CLI commands are available for task orchestration and configuration?

Available CLI commands include setup, execution, review fetching, review fixing, validation, syncing, and archiving. Key flags override `.compozy/config.toml` defaults to control task orchestration behavior across the workspace.

Do I need specific workspace configurations to use Compozy?

You need a `.compozy/config.toml` file for workspace defaults and a `.compozy/tasks/<slug>/` directory for artifact storage. CLI flags can override configuration defaults, and workspace-scoped agents can extend capabilities.

When should I use the Compozy skill versus cy-* workflow skills?

Use the Compozy skill for CLI reference, configuration, and pipeline orchestration overviews. Use cy-* workflow skills like cy-create-prd or cy-fix-reviews for executing specific phases within the artifact generation and review pipeline.

What artifact structure does Compozy produce during AI-assisted development?

Compozy produces artifacts under the `.compozy/tasks/<slug>/` directory layout. These files are generated and consumed by core skills like cy-create-prd, cy-create-techspec, cy-create-tasks, and cy-review-round throughout the development lifecycle.