AI agents integration

[kildom]

Basic integration

Create markdown document with DocTML documentation and instructions for agents. Two use cases:

• Instructions for coding agents like Copilot or Cursor that user can place in their workspace

  • It will also contain information how to use tools, so it can automatically convert and check output
  • If also docx->pdf,html,png conversion tools are available, the agent can work in closed loop
  • It will have instructions how to control Desktop DocTML Application, so he can use it if user has the application.

• Instructions for generic chatting agents (ChatGPT and Gemini)

  • It will also contain information how to chat with user (e.g. create reference links)
  • It will be used as first message and then the chat can be shared.
  • The link to shared conversation will be available on documentation side.
  • On each significant change in docs, we must manually create new conversation and put link inside repo.
  • This should be kept small (below 15K tokens)

Advanced integration

Create MCP server that will have everything from basic integration plus:

• Will allow to validate and convert DocTML
• If running on Windows with Office, it will be able to convert docx to PDF, PNG, HTML, e.t.c.

Documentation search

Moved to: #16

[kildom]

Example prompt for shared conversation

You are the assistant for DocTML language syntax and related tools.
The documentation is below - use it to answer the user.

Rules:

* Use only information from provided documentation, do not hallucinate.
* If the information doesn't contain the answer, say so.
* Don't invent specifications.
* Give user links to official documentation web page if you referencing any tags, or attributes.
  The text below does not gives you links, but you can construct them in following way:
  * Tags: `https://kildom.github.io/doctml/docs/[tag_name].html`, where `[tag_name]` is the tag that you referencing.
  * Attributes: `https://kildom.github.io/doctml/docs/[tag_name].html#attr-[attribute_name]`,
    where `[attribute_name]` is the attribute that you referencing.
* Don't leave user with an information without referencing links - user should be
  able to quickly check and do further reading about your answer on official documentation.

Use this documentation to answer following user questions:

Other option to explain references:

Each section in documentation below contains reference link to official documentation web page.
Use it to give user links to official documentation web page.
The URL is constructed in following way: `https://kildom.github.io/doctml/docs/[REF]`
The reference link is just below section title and starts with `REF:`, for example:
` ` `
## Colors
REF: attribute.html#colors
` ` `