Phase Example

phase-{name}-rules

Phase rules skill for {name} phase. Provides exit criteria checkers, worker routing table, and phase-specific constraints consumed by the orchestrator.

Contract

Input (from orchestrator)

The orchestrator calls this skill's scripts directly. No inter-skill communication envelope needed.

Output

Every script in scripts/ returns a JSON object to stdout and exits 0 on success or 1 on error.

---

Phase identity

| Field | Value | |-------|-------| | phase_name | {name} | | order | {N} | | required | true | | worker_default | {worker-agent-name} |

---

Worker routing table

Maps task.type to worker sub-agent. Consumed by the orchestrator dispatcher (Step 5).

| task.type | worker subagent_type | |-----------|----------------------| | {type_a} | {worker-a} | | {type_b} | {worker-b} | | * (default) | {worker-default} |

---

scripts/select_worker.py

Returns the worker sub-agent name for a given task type.

Usage

python3 .claude/skills/phase-{name}-rules/scripts/select_worker.py \
  --task-type 

Output

On success (exit 0):

{"worker": "", "task_type": "", "phase": "{name}"}

On error (exit 1):

{"status": "error", "reason": "unknown_task_type", "detail": ""}

---

scripts/check{criterionname}.py

Evaluates one exit criterion. Replace {criterion_name} with the actual criterion identifier (e.g. all_impl_tasks_terminal, all_specs_approved, no_open_critical_findings).

One script per criterion. Each script is independent and has no side effects.

Usage

python3 .claude/skills/phase-{name}-rules/scripts/check_{criterion_name}.py

Output schema

{
  "criterion": "{criterion_name}",
  "met": true,
  "evidence": {
    "total": 0,
    "passing": 0,
    "failing": []
  }
}

| Field | Type | Description | |-------|------|-------------| | criterion | string | Criterion identifier (matches key in exit-criteria.json) | | met | bool | true if criterion is satisfied | | evidence | object | Supporting data — structure varies by criterion |

On error (exit 1):

{"status": "error", "reason": "", "detail": ""}

Error reason codes:

• log_missing — .orch/log.jsonl not found
• internal_error — unexpected runtime error

---

exit-criteria.json

Declares all exit criteria for this phase. The orchestrator evaluates each criterion by calling the corresponding check_{criterion_id}.py script.

See exit-criteria.json in this directory.

---

references/

Phase-specific reference documents. Optional — add files here when the phase has domain-specific rules, templates, or vocabulary that workers need to consume.

| File | Purpose | |------|---------| | (empty in this template) | (add as needed) |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: zig999
• Source: zig999/siegard-code
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.