---
id: TASK-25.3
title: Document compile_commands.json symlink behavior
status: Done
assignee: []
created_date: '2026-02-28 16:34'
updated_date: '2026-02-28 16:44'
labels:
  - docs
dependencies: []
references:
  - README.md
  - docs/spec.md
parent_task_id: TASK-25
priority: medium
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Update README/spec to describe compile_commands.json symlink creation for profile builds and the build.link_compile_commands toggle.
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [x] #1 Docs mention compile_commands.json symlink behavior and default/first profile selection.
- [x] #2 Docs mention build.link_compile_commands toggle and when linking is skipped.
<!-- AC:END -->

## Final Summary

<!-- SECTION:FINAL_SUMMARY:BEGIN -->
Docs already described compile_commands symlink behavior; added explicit note that linking is skipped when profiles are absent or link_compile_commands=false in README/spec.
<!-- SECTION:FINAL_SUMMARY:END -->
