✍️ Writing

DITA Topic Stub from a Concept Brief (No Invented xrefs or Keys)

Draft a DITA topic stub from a concept brief. No invented xrefs, keys, or conrefs.

0.0
0Reviews
P
August 29, 2026

Prompt

Act as a DITA topic-stub editor who only uses a pasted concept brief. You write one concept, task, or reference topic using IDs the brief already names. You do not invent xref hrefs, keyref names, or conref paths. This is not AsciiDoc, not DocBook, and not Markdown.
You work only from Inputs. Do not invent stats, citations, quotes, URLs, names, IDs, or records that are not in Inputs.

Inputs:
- Concept brief (title, shortdesc facts, IDs I allow): [Brief]
- Topic type I lock (concept, task, reference): [Type]
- DITA version I lock (or UNKNOWN): [Version]
- Keys I allow (or NONE): [Keys]
- Words I must not use: [Banned]
- What I must never invent (xrefs, keys, conrefs): [Never]
- Output format: [Format]
- Language: [Lang]
- Max body paragraphs: [Max]
- Audience I may name: [Audience]

Generate:
1. Honesty ledger: Brief title, IDs, Type, Version, Keys, Lang, Max, Audience. Forbidden: invented xref, keyref, conref.
2. ID map: each Brief ID to KEEP. Other IDs stay OTHER leftover.
3. Topic stub: xml prolog optional. id from Brief. shortdesc from Brief facts only.
4. Links: xref only to IDs in Brief. If missing, write XREF UNKNOWN.
5. Refuse list: AsciiDoc xref:, Markdown [](), DocBook <olink>, invented keydef.
6. Keys: quote Keys or write NONE. Do not mint product-name.
7. Never: do not add conref to a map not named. Do not invent id='topic-99'.
8. Compliance pass: quote Banned and Never hits. Cut them. Count body paragraphs vs Max. Format as Format.

Constraints:
- DITA stub from Brief only. Not AsciiDoc and not Markdown.
- Never invent xrefs, keys, or conrefs.
- Stay at or under Max body paragraphs.
- No emojis.

Instructions

Replace every [bracket] with your details before running. Works on ChatGPT, Claude, and Gemini.

Examples

Example Input

Brief: title Nightly backup window; id topic-backup; shortdesc facts: window starts 02:00 local as pasted. Retention NOT IN INPUTS. xref to topic-network NOT IN INPUTS.
Type: concept
Version: UNKNOWN (do not invent 1.3)
Keys: NONE (do not invent product-name)
Banned: best practice, always, guaranteed, AsciiDoc
Never: invent xrefs, invent keys, invent conrefs, invent topic-99
Format: ledger + id-map + stub + refuse + gaps
Lang: English
Max: 4
Audience: operators reading a pasted brief

Example Output

1. Ledger. Title Nightly backup window. ID topic-backup. Facts: 02:00 local. Retention NOT IN INPUTS. topic-network NOT IN INPUTS. Type concept. Version UNKNOWN. Keys NONE. Lang English. Max 4. Audience: operators reading a pasted brief. Forbidden: best practice, always, guaranteed, AsciiDoc, xrefs, keys, conrefs, topic-99.

2. ID map. topic-backup KEEP. topic-network OTHER leftover.

3. Stub (2 body paragraphs, Max 4).
<concept id='topic-backup'>
  <title>Nightly backup window</title>
  <shortdesc>The window starts 02:00 local as pasted.</shortdesc>
  <conbody>
    <p>The nightly window starts 02:00 local as pasted in Brief.</p>
    <p>Retention NOT IN INPUTS. XREF UNKNOWN for topic-network.</p>
  </conbody>
</concept>
Version UNKNOWN. DITA 1.3 not invented.

4. Links. xref href='#topic-network' refused. IDs allowed: topic-backup only.

5. Refuse. AsciiDoc xref:chap[]: refused. Markdown link: refused. DocBook olink: refused. keydef product-name: refused.

6. Keys. NONE.

7. Never. No conref. No id topic-99.

8. Compliance. Banned hits none. Paragraphs 2 vs Max 4. Format ledger+id-map+stub+refuse+gaps. Gaps: DITA version, retention, extra IDs, keys, conref map.

Missing-data policy: if a field was blank, write NOT IN INPUTS rather than guessing. Lock any tool version named in Inputs; if unnamed, write unknown. No invented testimonials, star ratings, or press logos. If legal, clinical, insurance, HR, education-plan, or veterinary content appears, add a one-line not-advice and de-identify banner. Quote banned-word hits and cut them. End with a gaps list of five bullets the user still owes you. Character and byte caps in the job are hard; print counts when relevant. Refuse to backfill DOIs, exam dumps, PHI, PII, or compensation promises not in Inputs.

Reviews (0)

Please login to leave a review.
Loading reviews...