GitHub Skill

orchestrating-sprints

Manages development sprints with workflow-based compilation and fresh-context execution. Supports hierarchical phases (prepare → development → QA → deploy) with for-each step expansion. This skill should be used when starting sprints, managing workflows, or tracking sprint progress. Triggers on "start sprint", "create sprint", "run sprint", "sprint status", "add step", "compile sprint".

Mission42-ai☆ 0 仓库 Stars0 仓库 Forks

查看来源 ↗安装与使用

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求，再添加到工作流。

查看来源 ↗使用指南

技能说明

Sprint Orchestration

Manages development sprints through workflow-based compilation with hierarchical phase execution and fresh-context task processing.

Core Concepts

Concept	Definition
Workflow	Reusable phase template in `.claude/workflows/`
SPRINT.yaml	Sprint input: workflow reference + steps
PROGRESS.yaml	Compiled execution tree (generated)
Ralph Loop	Fresh context per task via `claude -p`
Ralph Mode	Autonomous goal-driven workflow with dynamic steps

Sprint Structure

.claude/
  workflows/          # Reusable workflow templates
    sprint-default.yaml
    feature-standard.yaml
  sprints/
    YYYY-MM-DD_name/
      SPRINT.yaml     # Input (workflow reference + steps)
      PROGRESS.yaml   # Compiled (generated by compiler)
      context/
      artifacts/

Workflow Architecture

┌─────────────────┐     ┌──────────────┐     ┌─────────────────┐
│  SPRINT.yaml    │     │   Compiler   │     │  PROGRESS.yaml  │
│                 │────▶│              │────▶│                 │
│  - workflow-ref │     │  - Resolves  │     │  - Phases       │
│  - steps[]      │     │    workflow  │     │    └─ Tasks[]   │
│                 │     │  - Expands   │     │  - Status tree  │
│                 │     │    for-each  │     │                 │
└─────────────────┘     └──────────────┘     └─────────────────┘

Commands

Command	Action
`start-sprint <name>`	Initialize sprint directory
`add-step <prompt>`	Add step to SPRINT.yaml
`import-steps`	Bulk import steps
`run-sprint`	Compile and execute sprint
`sprint-status`	Show hierarchical progress
`pause-sprint`	Pause after current phase
`resume-sprint`	Resume paused sprint
`stop-sprint`	Force stop
`help`	Show plugin help

Compilation Process

Compilation occurs automatically on /run-sprint:

Read SPRINT.yaml (workflow reference + steps)
Resolve workflow template from .claude/workflows/
Expand for-each phases into task hierarchy
Generate PROGRESS.yaml with full execution tree

# SPRINT.yaml (input)
workflow: sprint-default
steps:
  - implement auth module
  - add unit tests for auth
  - update API documentation

# PROGRESS.yaml (compiled output)
status: pending
phases:
  - name: prepare
    status: pending
    tasks: [...]
  - name: development
    status: pending
    tasks:
      - id: task-001
        prompt: implement auth module
        status: pending
      - id: task-002
        prompt: add unit tests for auth
        status: pending
  - name: qa
    status: pending
    tasks: [...]

Workflow Modes

The sprint system supports two workflow modes:

Mode	Description	Use Case
Standard	Phase-based execution with predefined steps	Known task sequences
Ralph Mode	Autonomous goal-driven with dynamic steps	Open-ended goals

Ralph Mode workflows use mode: ralph and allow Claude to create steps dynamically. See docs/concepts/ralph-mode.md for details.

References

references/workflow-definitions.md - Workflow template syntax and structure
references/progress-schema.md - PROGRESS.yaml schema specification (includes Ralph Mode fields)
references/compiler-usage.md - Compiler invocation and options
references/sprint-setup.md - Directory structure and initialization
docs/concepts/ralph-mode.md - Ralph Mode autonomous workflow documentation

Assets

assets/sprint-template.yaml - SPRINT.yaml template
assets/progress-template.yaml - PROGRESS.yaml template
assets/workflow-template.yaml - Workflow definition template

Troubleshooting

Issue	Cause	Resolution
Compilation fails	Invalid workflow	Check `references/workflow-definitions.md`
Workflow not found	Missing `.claude/workflows/`	Create directory with workflows
Step not expanding	Missing for-each	Verify phase has `for-each: step`
Loop exits early	PROGRESS.yaml status	Check `status` field

使用示例

查看来源仓库中的使用示例与配置说明。

查看来源 ↗

来源历史

收录时间: 2026-01-20
索引更新时间: 2026-01-26
Branch: main

收录与同步日期属于本站记录。源码修改历史请查看来源仓库。

GitHub ↗

chat Comments (0)

chat_bubble_outline

No comments yet. Be the first to share your thoughts!