ez-workflow

Category: Tools & Productivity | Uploader: rohoswagger | Downloads: 0 | Version: v1.0（Latest）

Use when about to run git branching, commit, push, or PR operations in a repo managed by ez-stack. Provides the complete command reference and agent-specific usage patterns.

Changelog: Source: GitHub https://github.com/rohoswagger/ez-stack

Directory Structure

Current level: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 ci.yml 1014 B
  - 📄 python-wheel.yml 3.3 KB
  - 📄 release.yml 2.2 KB
📁 docs/
- 📁 plans/
  - 📄 2026-03-06-v0.1.3-impl.md 22.7 KB
  - 📄 2026-03-06-v0.1.3-improvements-design.md 2.4 KB
- 📁 superpowers/
  - 📁 plans/
    
    📄 2026-03-10-stack-links.md 15.5 KB
    
    📄 2026-03-11-v0.1.5-agent-ux.md 52.0 KB
  - 📁 specs/
    
    📄 2026-03-10-stack-links-design.md 3.7 KB
    
    📄 2026-03-11-v0.1.5-agent-ux.md 6.7 KB
📁 python/
- 📁 ez_stack/
  - 📄 __init__.py 1.0 KB
- 📄 MANIFEST.in 33 B
- 📄 pyproject.toml 1005 B
- 📄 setup.py 232 B
📁 src/
- 📁 cmd/
  - 📄 amend.rs 2.8 KB
  - 📄 branch.rs 159 B
  - 📄 checkout.rs 4.8 KB
  - 📄 commit.rs 4.8 KB
  - 📄 create.rs 5.9 KB
  - 📄 delete.rs 7.4 KB
  - 📄 diff.rs 747 B
  - 📄 draft.rs 1.3 KB
  - 📄 init.rs 578 B
  - 📄 list.rs 6.9 KB
  - 📄 log.rs 8.7 KB
  - 📄 merge.rs 5.3 KB
  - 📄 mod.rs 449 B
  - 📄 move_branch.rs 3.9 KB
  - 📄 navigate.rs 2.3 KB
  - 📄 parent.rs 518 B
  - 📄 pr_edit.rs 3.1 KB
  - 📄 pr_link.rs 1.3 KB
  - 📄 pr_view.rs 683 B
  - 📄 push.rs 8.0 KB
  - 📄 restack.rs 4.1 KB
  - 📄 setup.rs 4.5 KB
  - 📄 shell_init.rs 992 B
  - 📄 skill.rs 1.3 KB
  - 📄 status.rs 8.5 KB
  - 📄 submit.rs 2.4 KB
  - 📄 sync.rs 14.7 KB
  - 📄 update.rs 4.1 KB
  - 📄 worktree.rs 370 B
- 📄 cli.rs 11.2 KB
- 📄 error.rs 1.9 KB
- 📄 git.rs 17.6 KB
- 📄 github.rs 7.1 KB
- 📄 hooks.rs 2.4 KB
- 📄 main.rs 7.6 KB
- 📄 stack.rs 6.4 KB
- 📄 stack_body.rs 5.2 KB
- 📄 ui.rs 3.3 KB
📄 .gitignore 20 B
📄 AGENTS.md 3.1 KB
📄 Cargo.lock 23.0 KB
📄 Cargo.toml 788 B
📄 CLAUDE.md 13.2 KB
📄 CONTRIBUTING.md 4.4 KB
📄 install.sh 2.3 KB
📄 LICENSE 1.1 KB
📄 README.md 6.6 KB
📄 reference.md 2.5 KB
📄 SKILL.md 4.4 KB

SKILL.md

---
name: ez-workflow
description: Use when about to run git branching, commit, push, or PR operations in a repo managed by ez-stack. Provides the complete command reference and agent-specific usage patterns.
---

# ez-stack

ez-stack makes version control invisible for AI coding agents. Four commands cover the full development lifecycle. Stacked PRs, worktree isolation, and auto-restacking happen automatically.

**When to use ez:** If `.git/ez/stack.json` exists, ALL git operations go through `ez`.

## The 4 Commands

```bash
ez create feat/auth              # 1. Start: worktree + branch + cd
# ... do your work ...
ez push -am "feat: add auth"     # 2. Ship: stage + commit + push + create PR
ez sync --autostash              # 3. Sync: pull trunk, clean merged, restack
ez delete feat/auth --yes        # 4. Done: remove worktree + branch + cd back
```

That's it. No `git add`, no `git commit`, no `gh pr create`, no `cd`.

## Never use these directly

| Instead of | Use |
|------------|-----|
| `git checkout -b` | `ez create` |
| `git commit` | `ez commit` or `ez push -am` |
| `git push` | `ez push` |
| `gh pr create` | `ez push` |
| `git diff main...HEAD` | `ez diff` |
| `git branch` | `ez list` |

## Agent Startup

```bash
# 1. Check what's happening
ez list

# 2. Create your isolated workspace (always use --from main for independent work)
cd $(ez create my-task --from main)

# 3. You're in .worktrees/my-task with your own branch. Work here.
```

**Always use `--from main`** for independent tasks. Without it, ez stacks on the current branch.

**Hooks:** If `.ez/hooks/post-create/default.md` exists in the repo, ez prints its instructions after worktree creation. Follow them to set up the worktree (install deps, copy env, etc.). Use `--hook <name>` for a specific hook: `ez create feat/auth --hook setup-node` reads `.ez/hooks/post-create/setup-node.md`.

Hooks are markdown instructions for agents, not executable scripts. ez prints them, you follow them.

## Working

### Commit specific files (keeps changes focused)
```bash
ez commit -m "feat: add types" -- src/types.rs src/mod.rs
```

### Stack changes (multiple PRs from one workflow)
```bash
ez create feat/auth-api            # stacks on current branch
ez commit -m "feat: add API"
ez create feat/auth-middleware     # stacks on auth-api
ez commit -m "feat: add middleware"
ez submit                          # pushes + creates PRs for entire stack
```

### Self-review before pushing
```bash
ez diff --stat       # what files changed vs parent
ez diff --name-only  # just file names
ez status            # stack info + working tree state
```

### Ship it
```bash
ez push -am "feat: done"               # stage + commit + push + create PR
ez push --title "feat: auth" --body "..." # with PR metadata
ez submit                                # push entire stack
```

### Sync with other agents' work
```bash
ez sync --autostash   # pulls trunk, cleans merged PRs, restacks your branches
```

### Finish
```bash
cd $(ez delete my-task --yes)   # removes worktree + branch, cd's to repo root
```

## Multi-Agent Rules

- **One worktree per agent.** Never share a worktree.
- **Always `--from main`** for independent tasks.
- **Sync before push** to pick up other agents' merged work.
- **Commit specific files** (`-- path1 path2`) not `-a` to avoid staging unintended changes.

## Receipts

Every mutating command emits a JSON receipt to stderr. Parse these to verify operations:

```json
{"cmd":"create","branch":"feat/auth","parent":"main","worktree":".worktrees/feat-auth"}
{"cmd":"push","branch":"feat/auth","pr_number":42,"pr_url":"...","created":true}
{"cmd":"delete","branch":"feat/auth","worktree":".worktrees/feat-auth"}
```

Check `redundant_commits > 0` after sync/restack — means commits were auto-dropped.

## Exit Codes

| Code | Meaning | Action |
|------|---------|--------|
| 0 | Success | Continue |
| 1 | Unexpected error | Log and stop |
| 2 | GitHub API error | `gh auth status` |
| 3 | Rebase conflict | Resolve, `ez restack` |
| 4 | Stale remote ref | `git fetch`, retry |
| 5 | Usage error | `ez status` |
| 6 | Unstaged changes | `--autostash` or `--if-changed` |

## Advanced Commands

See [reference.md](reference.md) for the full command reference: `ez commit`, `ez amend`, `ez diff`, `ez status`, `ez restack`, `ez log`, `ez move`, `ez merge`, `ez switch`, `ez pr-edit`, `ez draft`/`ez ready`, `ez pr-link`, `ez update`, `ez setup`, `ez skill install`.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

ez-workflow

Directory Structure

SKILL.md

Report

Notice