Issue Description
Roll out content-completeness enforcement for instructions — the lowest-effort asset type — as the first increment of promoting authored-docs completeness from warning to hard-fail.
Scope:
- Introduce per-kind
-RequireAuthoredContent scoping in scripts/linting/Validate-AssetDocs.ps1 (e.g., -RequireAuthoredContent instruction) so completeness can be promoted one asset type at a time. This capability is created here and reused by the prompts/skills/agents rollout issues.
- Backfill the authored When to use it section for every instruction docs page under
docs/reference/instructions/** (~75 files). Instructions are non-interactive (applied via applyTo), so How to use it is N/A and Example usage is optional — this is the smallest authored surface.
- Flip the CI gate to hard-fail authored-completeness for
kind: instruction only.
Additional Context
Issue Description
Roll out content-completeness enforcement for instructions — the lowest-effort asset type — as the first increment of promoting authored-docs completeness from warning to hard-fail.
Scope:
-RequireAuthoredContentscoping inscripts/linting/Validate-AssetDocs.ps1(e.g.,-RequireAuthoredContent instruction) so completeness can be promoted one asset type at a time. This capability is created here and reused by the prompts/skills/agents rollout issues.docs/reference/instructions/**(~75 files). Instructions are non-interactive (applied viaapplyTo), so How to use it is N/A and Example usage is optional — this is the smallest authored surface.kind: instructiononly.Additional Context
applyTo/description); no How-to and no Example prompt authoring.instruction's required/optional/N-A section semantics extend a single shared list instead of editing template + generator + validator in lockstep).