kandev/docs/plans/submodule-review/task-06-document-submodule-review.md

id, title, status, wave, depends_on, plan, spec

id	title	status	wave	depends_on	plan	spec
06-document-submodule-review	Document nested submodule review	done	3	03-present-submodule-review-hierarchy	plan.md	../../specs/ui/requirements/submodule-review.md

Task 06: Document nested submodule review

Acceptance

• Public Review guidance explains that initialized direct and nested submodule files appear with repository scope and that unavailable children fall back to the gitlink.
• Public feature status names nested initialized submodule support without implying that Kandev creates or coordinates pull requests for submodule remotes.
• Public docs validation passes and internal spec/ADR/plan links resolve.

Verification

node --test scripts/validate-public-docs.test.mjs
node scripts/validate-public-docs.mjs
rg -n "submodule|Nested Submodule Review" docs/public docs/specs docs/decisions docs/plans/submodule-review

Files likely touched

• docs/public/sessions-and-review.md
• docs/public/feature-status.md

Dependencies

Task 03 for final visible terminology.

Parallelism

parallel-safe with Task 05 after Task 03 because public docs and E2E files are disjoint.

Inputs

• Spec What, Failure modes, and Out of scope.
• ADR consequences for separate Git-host workflows.
• Existing public Review section and feature-status table.

Output contract

Report public pages and Diataxis classifications, wording boundaries, exact validation results, files changed, blockers/risks, and synchronized task/plan status.

Results

Updated the public Sessions and Review guide and Feature Status reference with initialized direct/nested submodule scope behavior, anchored comparisons, unavailable-child fallback, and separate submodule PR workflows.

Verification:

• node --test scripts/validate-public-docs.test.mjs — 58 passed.
• node scripts/validate-public-docs.mjs — 41 published pages validated.
• rg -n "submodule|Nested Submodule Review" docs/public docs/specs docs/decisions docs/plans/submodule-review — references present.