<< All versions

Skill v1.0.0

currentAutomated scan100/100
danielvm-git/bigpowers/compose-workflow
──Details
PublishedSeptember 30, 2026 at 02:16 PM
Content Hashsha256:73ebf35fbdcd732b...
Git SHA812d57a91767
──Files
Files (1 file, 2.9 KB)
SKILL.md2.9 KBactive
SKILL.md · 69 lines · 2.9 KB

version: "1.0.0" name: compose-workflow description: Chain multiple bigpowers skills into a custom workflow recipe saved in specs/. Use when a project repeats a non-standard skill sequence, or user wants a documented playbook beyond orchestrate-project modes. model: sonnet effort: standard

story: e09s01

story: e45s27

story: e21s04

Compose Workflow

HARD GATE — HARD GATE — Workflows are orchestration, not automation. Do NOT create workflows for tasks that should be single skills. Workflow complexity must be justified.

Process

  1. Interview: goal, phases, which skills, gates between steps.
  2. Write specs/workflows/<name>.yaml:
  • name, command, description, skills[], verify
  • Optional: args for skill-specific arguments
  1. Register in state.yaml Active Decisions.
  2. Optional: reference from orchestrate-project Ad-Hoc mode.
Prefer the YAML recipe format over the legacy specs/WORKFLOW-<name>.md markdown format.
YAML recipes are command-mappable, machine-readable, and listed in the Standard Recipe Library.

Terminal-state taxonomy (e45s27)

Every workflow step and /loop tick MUST exit with exactly one terminal state:

StateMeaningNext action
successStep verify passed; artifacts writtenAdvance to next skill in recipe
no-opNothing to do (already green / already applied)Skip step; advance
blockedExternal gate (approval, red CI, missing dep)diagnose-stall or escalate to user
exhaustedMax iterations/cycles reached (review cap, dispatch cycles)Stop; human decision required

Record terminal state in specs/state.yaml handoff.last_terminal_state when a recipe step completes. /loop ticks that produce no progress for two consecutive wakes → invoke diagnose-stall.

Standard Recipe Library

Pre-built recipes in specs/workflows/ map agentic stack commands to skill chains. Reference them in AGENTS.md so /command directly invokes the matching recipe.

CommandWorkflowSkill chain
/check-stackcheck-stacksurvey-context → assess-impact → setup-environment
/shipshipaudit-code → commit-message → release-branch
/tddtdddevelop-tdd → enforce-first
/code-reviewcode-reviewaudit-code → request-review → respond-review
/securitysecurityaudit-code → request-review
/planplansurvey-context → research-first → plan-work
/build-fixbuild-fixinvestigate-bug → diagnose-root → develop-tdd → validate-fix
/e2ee2esmoke-test → verify-work

Add to AGENTS.md:

/check-stack = compose-workflow check-stack
/ship        = compose-workflow ship

Verify

→ verify: [ "$(ls specs/workflows/*.yaml 2>/dev/null | wc -l | tr -d ' ')" -ge 8 ]

See REFERENCE.md for template.

All versions