- Rationale
-
The tspec skills must resolve item fields from role guidance, but
antora-tracer role-guidance <role> --config traceability.yml --contentfails today. TheroleGuidance.*.pagevalues are Antora-relative paths, but the tracer resolves them as filesystem paths relative to the config file, soguidance/change.adocresolves to a nonexistent repo-root file instead ofdocs/modules/specs/pages/guidance/change.adoc. The guidance pages also carry no item template, so field names exist only as informal prose. - Outcome
-
antora-tracer role-guidance change --config traceability.yml --contentand itsdecisionequivalent return their guidance pages, each carrying anItem templateblock that enumerates the role’s labeled-list fields. - Out-of-scope
-
The skill update that consumes the templates is a later change. Core-repo preset consistency is a separate change in the core repository. Roles, relations, workflow, and validation are unchanged.
CHG-005 — Make role guidance resolvable and template-driven
Addresses