---
id: TASK-6.3
title: Document CLI `--` extra args behavior
status: Done
assignee:
  - codex
created_date: '2026-02-03 14:30'
updated_date: '2026-02-03 16:13'
labels: []
dependencies: []
parent_task_id: TASK-6
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Update README (or other user-facing docs) with examples showing `zync <phase> -- <args>` and the merge order with global/profile config args.
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [x] #1 Docs include a CLI example using `--` for extra args.
- [x] #2 Docs explain that CLI args are appended after global and profile args.
- [x] #3 Docs show a combined example with resulting command order.
<!-- AC:END -->

## Implementation Plan

<!-- SECTION:PLAN:BEGIN -->
1. Update README zconf/args section to include a CLI `--` example for extra args.
2. Document merge order: global config args -> profile args -> CLI args.
3. Add a combined example showing the resulting command line.
<!-- SECTION:PLAN:END -->

## Implementation Notes

<!-- SECTION:NOTES:BEGIN -->
Updated README.md with CLI `--` example, merge order explanation, and combined example showing resulting command line. Tests not run for doc-only change.
<!-- SECTION:NOTES:END -->
