ether-phase-dag

Explains the enforced phase order for changes tracked under .ether/changes/ directories.

Updated Jul 27, 2026
One-click install
npx skills add https://github.com/arayaroma/ether --skill ether-phase-dag-arayaroma
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ether-phase-dag
Source: https://github.com/arayaroma/ether/tree/main/.claude/skills/ether-phase-dag
Command: npx skills add https://github.com/arayaroma/ether --skill ether-phase-dag-arayaroma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working on changes tracked by the Ether harness, writes that skip the mandatory phase order are hard-blocked by a PreToolUse hook. This Skill explains the required sequence (init, explore, proposal, spec/design, tasks, apply, verify, archive) so you know exactly which artifact or command is needed before writing code. ## Core Features & Use Cases - Phase Order Reference: Documents all eight stages and which artifact (proposal.md, spec.md, design.md, tasks.md, evidence.md, archive.md) completes each one. - TDD Gate Guidance: Explains that apply and verify fail closed if any file listed under the tasks.md ## Files section lacks a paired test or the test suite fails. - Violation Recovery: Describes how to read hook denial messages and write the missing artifact instead of working around the block. - Use Case: You attempt to edit source code and the hook denies the write because tasks.md does not exist yet; this Skill tells you to run ether status, write tasks.md with a ## Files section, then retry. ## Quick Start Ask the assistant to check the current Ether phase with ether status and explain which artifact must be written next before editing code.

Frequently Asked Questions about ether-phase-dag

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

FAQPage Schema
How do I start a new change with the Ether phase workflow?▼

Run `ether init <change-id>` to create the .ether/changes/<id>/ directory and state, then complete the explore phase with `ether phase done explore`. After that, write proposal.md, which auto-marks the proposal phase complete.

Why is my file write blocked by the Ether PreToolUse hook?▼

The hook denies writes that skip the phase order, exiting with code 2 and a message naming the missing file or phase. Read the message, write the missing artifact or run the missing command, then retry instead of working around the block.

What is required before writing application code in the apply phase?▼

Both tasks.md and ac.md must exist, and tasks.md must list every touched file under a `## Files` section. Each listed file needs a paired test (default src/X.ts maps to tests/X.test.ts) and the test suite must pass.

How do I complete the verify and archive phases in Ether?▼

For verify, run tests and write evidence.md with proof such as test output; `ether phase done verify` re-runs the TDD gate as a regression check. For archive, write archive.md, then explicitly run `ether phase done archive` to record the change.

Can Ether auto-fix a missing test failure during apply?▼

No. Ether has no LLM or network calls, so there is no auto-fix. The failure message names the exact test file to write, and you must write it yourself using spec.md, design.md, and ac.md for expected behavior.