Reference
Tag reference
The 115 tags across the SemText vocabulary, its extension
families and NPL, grouped by the job the element
does. Each card opens the element's page — its options, children
and an authored example — and a field its source does not state
is marked there. To write with them right away,
open the editor →
— any example below opens in it with ?example=<tag>.
Every tag in one table →
Document & structure
The root wrapper, reading chrome, audience declarations and document-level metadata that frame a SemText document.
<sem-enhanced-document>
SemText
The required root wrapper around a SemText document.
<sem-reader>
SemText
Reading tools for a long document: an outline, a progress bar, and controls for text size and theme.
<sem-audiences>
SemText
Names the reader groups a document knows about, so each reader sees the parts meant for them.
<sem-profile>
SemText
Names one reader group inside a sem-audiences block.
<agent>
SemText
Describes one AI agent inside the document: its name, a short bio, and its instructions.
Prose & code
Content blocks beyond plain HTML — Markdown bodies, callouts, skim blocks and source listings with provenance.
<sem-md>
SemText
A block written in Markdown that the browser turns into HTML.
<sem-note>
SemText
A callout: a short piece of prose set beside the main text.
<sem-tldr>
SemText
A summary block the reader can skim or skip.
<sem-code>
SemText
A code listing with a file name, a language, and marked lines.
<sem-browser>
SemText
Draws a browser-style window around a live SemText document.
Disclosure & views
The same content under different reading interactions — occluded detail, Q→A reveal, markup flip, perspective tabs.
<sem-details>
SemText
A group of passages whose key words can be hidden for recall practice.
<sem-detail>
SemText
One passage of prose with parts that can be hidden for self-testing.
<highlight>
SemText
Prose with parts the reader can hide to test their recall.
<sem-reveal>
SemText
A question the reader clicks to reveal the answer.
<sem-source>
SemText
Lets the reader flip between a section as it renders and the markup behind it.
<sem-views>
SemText
Shows one subject several ways, with a tab bar to switch.
<sem-view>
SemText
One named perspective inside a sem-views tab set.
Facts & recall
Assertable statement/conclusion pairs — the citable unit — with the quiz candidates and distractors built on them.
<sem-facts>
SemText
A group of facts the reader can flip through as cards, a quiz, or plain prose.
<sem-fact>
SemText
One fact: a statement, its conclusion, and optionally what would be wrong to believe.
<statement>
SemText
The claim side of a fact — what is asserted.
<conclusion>
SemText
The takeaway side of a fact — what the statement means.
<incorrect-statement>
SemText
A wrong version of a fact, shown so readers can spot the error.
<sem-question>
SemText
A question with answer choices, for self-testing.
<sem-option>
SemText
One answer choice in a question.
Data & tables
Authored tables, site/file trees, and the data-visualizer's named buckets, joins and editable queries.
<sem-table>
SemText
A table the reader can sort and filter — the table you write is the data.
<sem-site-tree>
SemText
A site or file tree written as nested node elements.
<sem-file-tree>
SemText
A file listing written as an indented tree inside a pre block.
<sem-data-visualizer>
SemText
The container that holds data sets, joins, and queries, and shows the results.
<sem-data-source>
SemText
One named set of data inside a data visualizer.
<sem-data-join>
SemText
Combines two named data sets on one shared column, like a database join.
<sem-data-query>
SemText
A question asked of a data set, written in a small, safe SQL-like language.
Sequences & progress
Ordered, status-annotated content — timelines, procedures, verified workflows and completion meters.
<sem-chronology>
SemText
A timeline: dated events shown in the order they happened.
<sem-event>
SemText
One dated event on a timeline.
<sem-procedure>
SemText
An ordered list of steps, each marked with where it stands.
<sem-workflow>
SemText
An ordered workflow whose steps carry verification.
<sem-step>
SemText
One step in a procedure.
<sem-progress>
SemText
A progress bar for one number between 0 and 1.
Knowledge & documents
Whole-document containers for a named genre — how-tos, runbooks, KBs, FAQs, changelogs, guard-rails, plans, requirements, rubrics, evals, philosophies, summaries, threat models and mockups — each a self-describing wrapper with its own metadata and sections.
<sem-howto>
SemText
A how-to guide container: a named guide with free contents.
<sem-kb>
SemText
A knowledge-base article: the content you write inside is the article.
<sem-runbook>
SemText
An operational runbook: preconditions, procedure and references in one container.
<sem-faqs>
SemText
A collection of FAQ entries.
<sem-faq>
SemText
One FAQ entry: the asked question and its authored answer.
<sem-tsgs>
SemText
A collection of troubleshooting entries.
<sem-tsg>
SemText
One troubleshooting entry: a symptom and its fix.
<sem-changelogs>
SemText
The collection wrapper for changelog entries.
<sem-changelog>
SemText
A changelog: dated entries describing what changed.
<sem-guard-rails>
SemText
A collection of guard rails.
<sem-guard-rail>
SemText
One guard rail: a rule the reader should not cross.
<sem-plan>
SemText
A plan container: the reasoning and the steps of a solution.
<sem-requirement>
SemText
A requirement statement with a status and priority.
<sem-rubric>
SemText
A scoring rubric container: criteria against levels.
<sem-eval>
SemText
An evaluation spec: the inputs, expected outputs and criteria in one container.
<sem-philosophy>
SemText
A principles container: the beliefs or rules a project runs on.
<sem-summary>
SemText
A summary container: the short version of what follows.
<sem-threat-model>
SemText
A threat-model container: assets, threats and mitigations.
<sem-mockup>
SemText
A UI mockup container holding text or HTML.
Definitions & citations
Closed key/value assertions, the numbered works the prose cites, and the self-describing vocabulary cards (tag/attribute/API definitions).
<sem-properties>
SemText
A list of key–value pairs, shown as a tidy definition grid.
<sem-property>
SemText
One key–value pair in a properties grid.
<sem-references>
SemText
A numbered list of sources the document cites.
<sem-reference>
SemText
One numbered entry in a reference list.
<sem-tag-def>
SemText
Documents one tag's contract: its attributes, types, defaults and child tags, as a card.
<sem-tag-attr>
SemText
One attribute row inside a sem-tag-def: name, type, required flag, default and description.
<sem-api-call>
SemText
Documents one API call's contract: method, endpoint, status and its parameters, as a card.
<sem-api-param>
SemText
One parameter row inside a sem-api-call: name, where it lives, type and description.
SemText extensions
The semext-* embeds — service-backed views (SigNoz signals, media prompts, doc pointers, styleguide themes) rendered where a plain tag cannot reach.
<semext-annotate>
SemText Extensions
Visitor comment threads embedded in the page, backed by the annotate service.
<semext-docptr>
SemText Extensions
A doc-pointer card rendered from a cached snapshot.
<semext-media-prompt>
SemText Extensions
An authored media-generation prompt with an output cache region.
<semext-sig-logs>
SemText Extensions
A SigNoz log-line snapshot with a link to open the query.
<semext-sig-metrics>
SemText Extensions
A SigNoz metrics snapshot with a link to open the query.
<semext-sig-synthetic-monitor>
SemText Extensions
A SigNoz synthetic-monitor definition card with a deep link.
<semext-sig-traces>
SemText Extensions
A SigNoz trace-list snapshot with a link to open the query.
<semext-styleguide-theme>
SemText Extensions
One theme's token cards rendered from a cached snapshot.
<semext-styleguide-themes>
SemText Extensions
The collection wrapper for theme token cards.
Agent Kit elements
The agent-kit-* cards — the work-item vocabulary (tickets, epics, personas, test cases) rendered from Agent Kit records.
<agent-kit-acceptance-criteria>
Agent Kit
A given/when/then criteria list for a ticket or story.
<agent-kit-agent-persona>
Agent Kit
An agent persona card: who the agent is and how it behaves.
<agent-kit-artifact>
Agent Kit
A typed artifact card: code or text produced by the work.
<agent-kit-asset>
Agent Kit
A media asset card with a caption.
<agent-kit-board>
Agent Kit
A kanban-style board laid out over ticket references.
<agent-kit-bug>
Agent Kit
A bug ticket card.
<agent-kit-chatroom>
Agent Kit
A chatroom transcript card.
<agent-kit-cucumber>
Agent Kit
A Gherkin spec card: the feature source shown as written.
<agent-kit-custom-assert>
Agent Kit
A list of custom assertions, each an expression and an expectation.
<agent-kit-cypress>
Agent Kit
A Cypress spec card: the test source shown as written.
<agent-kit-epic>
Agent Kit
An epic ticket card.
<agent-kit-issue>
Agent Kit
An issue ticket card with org, project and state.
<agent-kit-organization>
Agent Kit
An organization reference card.
<agent-kit-project>
Agent Kit
A project reference card.
<agent-kit-review>
Agent Kit
A review card: comments and a verdict.
<agent-kit-sub-task>
Agent Kit
A sub-task ticket card.
<agent-kit-task>
Agent Kit
A task ticket card.
<agent-kit-test-case>
Agent Kit
A test-case card: steps and the expectation.
<agent-kit-test-suite>
Agent Kit
A test-suite card with per-branch rows.
<agent-kit-ticket-ref>
Agent Kit
An inline reference to a ticket.
<agent-kit-user-persona>
Agent Kit
A user persona card: who the product serves.
<agent-kit-user-story>
Agent Kit
A user story ticket card.
NPL elements
The npl-* components — display renders of NPL prompt blocks (agent introspection, critique, reasoning).
<npl-agent>
NPL
Describes one AI agent: its name, type, and how it should behave.
<npl-artifact>
NPL
Shows a piece of work an agent produced, like code or a report, with a title and notes.
<npl-cot>
NPL
Shows the steps of a chain of thought, folded up until the reader opens them.
<npl-critique>
NPL
Shows a review of one thing from one point of view: strengths, weaknesses, and a verdict.
<npl-declaration>
NPL
Shows which version of a rules document you are reading.
<npl-directive>
NPL
Marks a short instruction inside a sentence, so it stands out from the prose.
<npl-example>
NPL
A sample element that shows how npl-* elements are built.
<npl-flag>
NPL
One setting a reader can switch, shown as a labelled row.
<npl-flags>
NPL
A group of settings shown as clickable rows.
<npl-hormones>
NPL
Shows seven drive levels — like momentum, tension, and curiosity — as bars.
<npl-intent>
NPL
Shows what a piece of work is meant to achieve: the goal, the scope, and the expected outcomes.
<npl-mindread>
NPL
Shows what one party thinks another party believes or feels.
<npl-mode>
NPL
Lists the thinking styles an agent uses, one chip per style.
<npl-mood>
NPL
Shows a mood with an emoji, plus an optional note on its tone.
<npl-poa>
NPL
Shows a plan as a decision tree, plus the reasons each path was weighed.
<npl-ref>
NPL
Looks back at a finished turn: what went well, what to improve, and how it was checked.
<npl-rubric>
NPL
A scoring table: each row is a criterion with a weight and a score, plus a total.
<npl-section>
NPL
A labelled section for any NPL prompt block.
<npl-thought>
NPL
A thought bubble: short related ideas grouped under one type.
<npl-vos>
NPL
Shows a persona's inner state: id, ego, superego, and mood, before a reply.