---
id: TASK-17.4
title: Document sysbuild behavior in project docs if needed
status: Done
assignee:
  - codex
created_date: '2026-02-27 08:46'
updated_date: '2026-02-27 10:15'
labels: []
dependencies: []
references:
  - docs/spec.md
  - docs/plan.md
  - docs/zync/README.md
parent_task_id: TASK-17
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Update project docs to reflect sysbuild list/image behavior and defaults if current docs are missing or inconsistent.
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [x] #1 Docs describe sysbuild `--list` and `--image` behavior, including default image selection rules.
- [x] #2 Doc changes are limited to sysbuild behavior updates.
- [x] #3 No code changes beyond documentation.
<!-- AC:END -->

## Implementation Plan

<!-- SECTION:PLAN:BEGIN -->
Plan:
1) Inspect docs/spec.md and docs/plan.md for current sysbuild guidance or gaps.
2) Add a concise sysbuild section (list/image behavior + default selection rules) if missing.
3) Keep changes limited to documentation and avoid behavior changes.
<!-- SECTION:PLAN:END -->

## Implementation Notes

<!-- SECTION:NOTES:BEGIN -->
Reviewed docs: sysbuild list/image behavior documented in docs/spec.md. Added note that `--list`/`--image` error on non-sysbuild projects to align with current behavior. No other doc changes needed.
<!-- SECTION:NOTES:END -->

## Final Summary

<!-- SECTION:FINAL_SUMMARY:BEGIN -->
Updated docs/spec.md to explicitly state that `--list`/`--image` error on non-sysbuild projects, aligning sysbuild behavior documentation with implementation.

Docs: `docs/spec.md`
<!-- SECTION:FINAL_SUMMARY:END -->
