phase-planner

Transform approved tasks into deterministic phases stored in phases.json.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/alexization/git-ranker-workflow --skill phase-planner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phase-planner
Source: https://github.com/alexization/git-ranker-workflow/tree/main/.codex/skills/phase-planner
Command: npx skills add https://github.com/alexization/git-ranker-workflow --skill phase-planner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

승인된 작업을 실행 가능한 단계(phase)로 분해하고 phases.json을 표준 계획으로 고정하여 관리 효율을 높입니다.

Core Features & Use Cases

  • 승인된 작업을 여러 phase로 나누고 각 phase에 필요한 JSON 필드를 채워 실행 계획을 구성합니다.
  • phases.json를 통해 일관된 실행 계획을 저장하고, intake와 spec의 동기화를 유지합니다.
  • 변경 시 재잠금 및 재계획 절차를 안내하고 phase-executor로 이행합니다.

Quick Start

태스크를 승인한 뒤 plan 명령으로 phases.json를 생성하고 차후 bootstrap 메타데이터를 설정한 다음 phase-executor를 시작하라.

Frequently Asked Questions about phase-planner

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

FAQPage Schema
How do I split approved tasks into executable phases for project planning?

To split approved tasks into executable phases, you decompose them into a deterministic sequence and store the plan in a canonical phases.json file. This enforces requirements like allowed_write_paths, test_policy, and deliverables for reliable task execution.

What is a canonical phases.json file used for in task management?

A canonical phases.json file serves as the standard execution plan for task management. It stores decomposed phase sequences, synchronizes with spec and intake data, and defines required fields like completion_signal and starting_points for reliable planning.

How do I create a phase execution plan after task approval?

After task approval, run the plan command to generate phases.json and populate it with phase requirements. Then set up bootstrap metadata and transition to the phase-executor to begin the workflow.

Can I synchronize intake and spec data within my phase planning workflow?

Yes, you can synchronize intake and spec data within your phase planning workflow. Storing execution plans in phases.json maintains consistency and ensures intake and spec remain synchronized during task decomposition.

What should I do if I need to change an existing phase plan?

If you need to change an existing phase plan, you must follow a re-locking and re-planning procedure. This ensures the phases.json canonical plan stays synchronized and deterministic before you resume execution.