---
id: TASK-21.3
title: Update docs/examples and tests for project.args schema
status: Done
assignee:
  - codex
created_date: '2026-02-27 18:15'
updated_date: '2026-02-27 18:43'
labels: []
dependencies: []
references:
  - README.md
  - docs/spec.md
  - src/core/config.rs
  - tests/
parent_task_id: TASK-21
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Update README/spec/examples to use `[project].args` and document `[args]` as invalid. Add tests for the new schema (including rejection of `[args]`) and for arg merge order with project.args + profile args + CLI extras.
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [x] #1 Docs/spec/README examples use `[project].args` and mention `[args]` invalid
- [x] #2 Tests cover config parsing failure when `[args]` is present
- [x] #3 Tests cover arg merge order with `project.args` + profile + CLI extras
<!-- AC:END -->

## Implementation Plan

<!-- SECTION:PLAN:BEGIN -->
- Update README/spec examples to use `[project.args]` and add a note that top-level `[args]` is invalid.
- Add/extend tests for merge order: `project.args` + profile args + CLI `--` extras.
- Run `just test`.
<!-- SECTION:PLAN:END -->

## Implementation Notes

<!-- SECTION:NOTES:BEGIN -->
Updated README/spec to use `[project.args]` and note `[args]` invalid. Added integration test `kaze_run_merges_project_profile_and_cli_args` validating merge order and CLI extras with run binary path. `just test` passes.
<!-- SECTION:NOTES:END -->

## Final Summary

<!-- SECTION:FINAL_SUMMARY:BEGIN -->
Updated README/spec to use `[project.args]` and document `[args]` as invalid. Added integration test `kaze_run_merges_project_profile_and_cli_args` validating merge order and CLI extras for run. Tests: `just test`.
<!-- SECTION:FINAL_SUMMARY:END -->
