Skip to content

Commit cf4860f

Browse files
Sync agents and skills from help-content-tools (#1255)
Upstream: https://github.com/qlik-trial/help-content-tools/commit/28e3b6f72a246c18c38219804bec91d719d17942 Update Draft-doc.agent.md Improve leverage of DITA variables by Draft agent Author: f-bischoff Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
1 parent 6ffcb5e commit cf4860f

1 file changed

Lines changed: 5 additions & 2 deletions

File tree

‎.github/agents/Draft-doc.agent.md‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,9 +39,12 @@ For each documentation request (update, addition, or creation):
3939
- Load the product-specific variable set from `Project/VariableSets/{Product}.flvar` (e.g., `Replicate.flvar`, `Sense_Release.flvar`) and use variables for product names, versions, and service names (see copilot-instructions.md for details).
4040
- Always check the topic being edited and all its ancestor elements for `MadCap:conditions` with `Features.<ticket-id>` or `Features.NotIn<ticket-id>` before editing. If found, invoke the **flare-feature-conditions** skill and follow its decision table.
4141
- Never create a new feature condition and never add a feature condition to content you create or update.
42-
- **For DITA content in docs-core or docs-components**: Invoke the **dita-variables** skill and use `common/taxonomy/metadata-variables.dita` `<keyword conref>` references for product names, module names, and brand names.
42+
- **For DITA content in docs-core or docs-components**:
43+
- Invoke the **dita-variables** skill and use `common/taxonomy/metadata-variables.dita` `<keyword conref>` references for product names, module names, and brand names.
44+
- Treat prompt, handoff, Jira, and SME wording as factual input, not markup-ready text. Do not carry hardcoded product, module, service, engine, or brand names from those sources into DITA. Resolve each name by invoking the **dita-variables** skill before drafting.
45+
- Before delivery, scan every new or edited DITA topic for hardcoded names that require variables. XML parsing alone is not sufficient validation.
4346
- Update the documentation based on input and analysis, applying the rules from the **qlik-writing-guidelines** skill.
44-
- Match the output structure and markup to the current repository's documentation format.
47+
- Match the output structure and markup to the current repository's documentation format.
4548
- For unresolved links, cross-references, and images, follow the `[ASSUMED-*]` pattern documented in copilot-instructions.md:
4649
- Use empty `href=""` or `src=""` attributes (never dummy/placeholder values that will break the build)
4750
- Place `[ASSUMED-LINK]`, `[ASSUMED-XREF]`, or `[ASSUMED-IMAGE]` labels visibly in the content text

0 commit comments

Comments
 (0)