BACKLOG.md

Knowledge backlog

Candidate agent-only entries, grouped by contributor-docs coverage. Each lands as its own reviewed PR.

Not in the docs

• casing-and-pluralization — how API names map to Terraform names; when api_name is required.
• output-only-test-assertions — server-populated fields must have their values asserted in tests.
• pr-mined-lessons — recurring review catches and per-service quirks surfaced from merged PRs.

Overlaps the docs (entry would add the judgment layer)

• permadiff-decision-path — choosing between output, default_from_api, diff suppression, or a real fix; mechanics are in docs/content/develop/diffs.md.
• data-source-idioms — pitfalls beyond the procedure in docs/content/develop/add-handwritten-datasource.md.
• test-adequacy-traps — cases docs/content/test/test.md doesn't cover (identical-config update steps, missing import-and-recheck).

Mostly covered by the docs (revisit only if agents misread them)

• immutability-nuances — docs/content/reference/field.md, docs/content/best-practices/immutable-fields.md.
• sensitive-and-write-only — docs/content/reference/field.md.

Lives elsewhere

• failure-troubleshooting-catalog — .agents/skills/operations/troubleshooting_reference.md; migrates here if it outgrows the skill.