oliver-kriska/claude-elixir-phoenix / targets/codex/skills/phx-work
phx-work
VerifiedExecute Elixir/Phoenix plan tasks with progress tracking. Use after $elixir-phoenix:phx-plan to implement features…
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.1 KB |
| references/error-recovery.md | markdown | 2.0 KB |
| references/execution-guide.md | markdown | 9.4 KB |
| references/file-formats.md | markdown | 1.7 KB |
| references/harness-patterns.md | markdown | 2.7 KB |
| references/resume-strategies.md | markdown | 2.3 KB |
references/resume-strategies.md
View on GitHub# Resume Strategies
## How State Works
**Plan checkboxes ARE the state.** No separate JSON state files.
- `[x]` = completed
- `[ ]` = pending; `[ ] ... [BLOCKED] ...` = blocked and still incomplete
- Phase status `[COMPLETED|IN_PROGRESS|PENDING|BLOCKED]` tracks phase progress
- `[BLOCKED]` on the plan row is authoritative; progress records preserve blocker evidence
## Resume Modes
### Default: Auto-detect
```
$elixir-phoenix:phx-work # Resume at first unchecked non-[BLOCKED] task; stop if an earlier blocker exists
```
### From Specific Task
```
$elixir-phoenix:phx-work .claude/plans/auth/plan.md --from P2-T3
```
Targets P2-T3 regardless of earlier unchecked tasks. If it is `[BLOCKED]`, this explicitly retries it and clears the tag when starting.
### Skip Blockers
```
$elixir-phoenix:phx-work .claude/plans/auth/plan.md --skip-blockers
```
Skips rows visibly tagged `[BLOCKED]`; it does not infer blockers from prose or progress history.
## Resume from Interrupted Session
On resume, the plan file itself shows progress:
```markdown
## Phase 1: Schema Design [COMPLETED]
- [x] [P1-T1][ecto] Create users migration
- [x] [P1-T2][ecto] Add indexes
## Phase 2: Context Module [IN_PROGRESS]
- [x] [P2-T1][direct] Generate context
- [ ] [P2-T2][ecto] Add password_hash <-- Resumes here
- [ ] [P2-T3][direct] Implement register_user/1
```
No state file to parse. Select the first unchecked row not tagged `[BLOCKED]`, but stop when an unresolved blocker precedes it unless `--skip-blockers` was supplied.
## Consistency Check
On resume, validate:
- Tasks before the target must be `[x]`, or visibly `[BLOCKED]` when
`--skip-blockers` was explicitly supplied
- If another earlier task is unchecked, warn and ask the user:
- Skip them (mark as done)?
- Go back and complete them?
- Something else?
## Idempotent Task Execution
Tasks should be safe to re-execute:
| Task Type | Idempotent Approach |
|-----------|---------------------|
| Migration | Use `create_if_not_exists` or check schema |
| Schema | Write complete module, don't patch |
| Context | Write/replace function entirely |
| LiveView | Write complete component module |
| Test | Write complete test module |
| Route | Check route existence before adding |
If re-executing a task creates duplicate code, the task was not
idempotent. Write whole modules, not patches.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |