cy-research-issues

Converts multi-agent codebase research into an executable Compozy task suite with specs and issue files.

2.7k|171|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/compozy/compozy --skill cy-research-issues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cy-research-issues
Source: https://github.com/compozy/compozy/tree/main/.agents/skills/cy-research-issues
Command: npx skills add https://github.com/compozy/compozy --skill cy-research-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Turning codebase research, bug investigations, and competitor analysis into an actionable, executable backlog normally requires manual synthesis and task authoring. This Skill automates that pipeline: it dispatches parallel explorer agents, synthesizes findings, and emits a validated task graph that cy-execute-task can run directly.

Core Features & Use Cases

  • Parallel Explorer Dispatch: Slices a research question into 4-8 scoped analyses run via compozy exec with GLM 5.2 through the pi harness, each producing a seven-section evidence-cited analysis document.
  • Lite Spec Authoring: Generates a _spec.md with root causes, target architecture, delete targets, sequencing waves, and impact audits, without interactive ADR ceremony.
  • Executable Task Graph: Produces task_NN.md issue files and a _tasks.md compozy.tasks/v2 manifest with dependencies, complexity ratings, and Unit/Integration/E2E test plans, validated via compozy tasks validate.
  • Use Case: When auditing a subsystem or investigating a bug class (e.g., "returning to a live session shows a blank thread"), run the skill with a slug and research prompt to receive a complete, validated backlog under .compozy/tasks/<slug>/ ready for execution.

Quick Start

Ask the agent to research why returning to a live session shows a blank thread and turn the findings into an executable task suite under the slug session-reconnect.

Frequently Asked Questions about cy-research-issues

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

FAQPage Schema
How do I turn codebase research into executable tasks?

Provide a slug and a research prompt describing the bugs or surfaces to investigate. The skill dispatches parallel explorer agents, synthesizes findings into a lite spec, and generates task_NN.md files plus a _tasks.md graph under .compozy/tasks/<slug>/ that cy-execute-task can run directly.

How do I run multi-agent codebase analysis in parallel?

The skill slices the research into 4-8 scoped questions and backgrounds one compozy exec per slice using GLM 5.2 through the pi harness. Each explorer writes exactly one seven-section analysis file with path:line evidence citations.

When should I use cy-research-issues instead of cy-create-spec?

Use cy-research-issues for research-driven backlogs without interactive gates. Use cy-create-spec for formal spec authoring with grill and ADR review, cy-create-tasks to decompose an approved spec, and cy-execute-task to run generated tasks.

Why do explorer agents stall with zero output?

Stalls usually mean the dispatch used opencode instead of the pi harness, which starves Compozy's activity watchdog. Confirm --ide pi was used and that ~/.pi/agent/auth.json contains a valid OpenRouter API key.

Can this skill modify production code or run the tasks it creates?

No. The skill is analysis and authoring only; it never modifies production code and never executes generated tasks. Execution is delegated to cy-execute-task after compozy tasks validate exits 0.