Skip to content

feat: docs completeness rollout [1/4] — instructions #2361

Description

@jkim323

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

Metadata

Metadata

Labels

ciContinuous integrationdocumentationImprovements or additions to documentationenhancementNew feature or request

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions