design-a-cycle

Orchestrate Plan, Research, and Architect phases across L1-L3 substrates.

Updated May 3, 2026
One-click install
npx skills add https://github.com/fkberthold/loom --skill design-a-cycle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-a-cycle
Source: https://github.com/fkberthold/loom/tree/main/skills/design-a-cycle
Command: npx skills add https://github.com/fkberthold/loom --skill design-a-cycle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Above-bead campaign/arc orchestrator that drives a design cycle's Plan→Research→Architect cadence over the layered design substrate (L1 KG spine / L2 design-doc drawer / L3 optional executable specs), gates on two-tier soundness, then hands off to create-beads to spawn the implementation epic. NOT a bead-lifecycle activity recipe — it iterates, spawns research-a-beads + an epic, and is stateless beyond the substrate it maintains. Triggers on "/design-a-cycle <topic>", or when the user wants to open or advance a design cycle for a topic that will eventually become beads.

Core Features & Use Cases

  • Orchestrates Plan → Research → Architect cadence across L1-L3 substrates, preserving cycle-state in the KG and design-docs.
  • Spawns research beads for grounding open [CLARIFICATION] markers and then creates an implementation epic when green.
  • Reads and writes substrate state to drive cadence without storing internal bead instances, enabling stateless orchestration.

Quick Start

Open a topic design cycle with /design-a-cycle <topic> to start or advance a design cadence from Plan to Handoff.

Frequently Asked Questions about design-a-cycle

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

FAQPage Schema
How do I orchestrate a design cycle from plan to handoff?

You orchestrate a design cycle by triggering the /design-a-cycle command with a topic, which drives the Plan, Research, and Architect phases across a knowledge graph substrate and design-doc headers. It coordinates the entire cadence and hands off to create-beads for implementation.

What is a two-tier soundness gate in a design cycle workflow?

A two-tier soundness gate validates design cycle progression by checking state consistency across the layered substrate before advancing phases. It ensures the knowledge graph spine, design-doc headers, and optional executable specs align before spawning research beads or implementation epics.

How do I manage state across research and architecture phases without internal storage?

State is managed by reading and writing directly to the layered substrate, comprising the L1 knowledge graph, L2 design-doc headers, and L3 optional specs. This enables stateless orchestration, preserving cycle-state externally without storing internal bead instances.

When do I need to spawn research beads during a design cycle?

Research beads are spawned to ground open clarification markers that arise during the Research phase of the design cycle. Once these markers are resolved and the cycle passes soundness gates, the orchestrator hands off to create an implementation epic.

Can I use design-a-cycle to manage individual bead lifecycles?

No, design-a-cycle is not a bead-lifecycle activity recipe. It functions as an above-bead campaign orchestrator that iterates through the Plan, Research, and Architect cadence, spawning research beads and implementation epics rather than managing individual bead states.

How do I scaffold design-doc drawers from templates?

Design-doc drawers are scaffolded from templates during the orchestration of the design cycle. The orchestrator reads the substrate state, applies templates to generate the L2 design-doc structure, and advances the cycle through the required architectural phases.