BoK Building

SimpleModeling.org is a technical information site focused on modeling technologies centered around Literate Model-Driven Development (Literate MDD).

At the same time, it also explores and practices knowledge construction and sharing foundations for realizing AI-Driven Development using generative AI.

To enable AI-assisted support for literate models, it is necessary to share the “development context” with AI—such as models, design philosophies, terminology definitions, and development patterns.

SimpleModeling refers to the knowledge system that forms the core of this context sharing as the BoK (Body of Knowledge).

The goal of building a BoK is to enable knowledge sharing, education, AI support, automation, and decision-making assistance.

BoK Building refers to the process of systematically organizing domain-specific expertise, techniques, concepts, and practices into a reusable and structured body of knowledge.

At SimpleModeling, the construction and operation of the BoK is positioned as a central theme in the utilization of AI.

Providing the BoK via the Web

Web technologies are leveraged to the fullest extent as the foundation for the BoK.

With consideration for both human comprehension and AI processing, knowledge is organized and published from the following perspectives:

Human and AI Harmony

  • Documents that humans can read, understand, and utilize

  • Metadata that AI can structurally grasp and interpret

Conventional structured data is suitable for machine processing, but it tends to be difficult for humans to read and is not ideal for learning or comprehension.

Conversely, human-centered documents can make it difficult for AI to grasp the context.

SimpleModeling aims to design a BoK that bridges this gap.

Utilizing Web Metadata

Standard web metadata such as the following are utilized to clarify semantic meaning at the page level.

  • HTML head

  • Open Graph Protocol

  • Twitter Cards

  • JSON-LD

  • robots.txt / humans.txt

  • Atom Feed

  • RDF (RDF/XML, Turtle, JSON-LD)

By carefully designing and configuring these elements, search engines and AI can more accurately understand the meaning of documents.

Knowledge Representation in Site Structure

Link structures and classification systems are also part of knowledge. By establishing the following mechanisms, the BoK can be clarified.

  • Site Structure

  • Glossary

  • Keywords

  • Index

  • References

  • External Reference Links

  • Contextual Definition

The meaning of terms changes depending on context. If the context can be made explicit, AI can interpret the meaning of terms more accurately.

SimpleModeling.org also serves as an experimental platform for integrating ontology technologies with generative AI.

Internationalization Support

In global development environments, internationalization (I18N) is essential.

By supporting English and another major language (e.g., Japanese), a wide range of needs can be addressed.

SmartDox provides structured mechanisms for multilingual support, making language switching and translation support easier in BoK construction.

Technical Foundation for BoK Construction

At SimpleModeling.org, the following technology stack is used to build and manage the BoK.

SmartDox

Document markup and tool suite

Arcadia

A static site generator for visual pages such as the site top

Antora / Asciidoc

A structured documentation framework for technical articles

BoK Building Process
Figure 1. BoK Building Process

SmartDox

SmartDox is a custom document format and open-source processing system developed by Asami, the founder of SimpleModeling.org, combining the simplicity of Markdown with the structural expressiveness of Asciidoc and Org-mode.

By organizing multiple SmartDox files hierarchically, a single site structure (SmartDox site) can be formed.

Based on this SmartDox site, two types of outputs can be generated:

Arcadia Site

For top pages and visual guide pages

Antora Site

For BoK main content and technical documents

The SmartDox site is structured with SmartDox documents and metadata text files arranged in a hierarchical directory, making it manageable with text-based version control systems like Git.

No special middleware such as databases is required; the site structure is automatically interpreted from the directory hierarchy and metadata, and converted into proper data.

Glossaries and keywords are automatically linked, achieving both human readability and AI interpretability as a BoK.

Arcadia

Arcadia is an open-source static site generator (SSG) developed by Asami. It generates responsive web pages based on Bootstrap 5.

At SimpleModeling.org, Arcadia and Antora are used in the following ways:

Top page and category top pages

Generated with Arcadia (visual clarity prioritized)

Article pages

Built with Antora (readability and structure prioritized)

Antora / Asciidoc

Asciidoc is a widely used markup language for technical documentation, and Antora is a tool for building navigable websites from collections of such documents.

By generating Antora-compatible Asciidoc from SmartDox, the entire BoK can be assembled into a website well-suited for publishing technical content.

Since Antora and Asciidoc are widely adopted, they are also expected to be advantageous for AI-based website analysis.

For internal project BoKs, the combination of SmartDox and Antora alone can suffice, without using Arcadia.

Knowledge Sharing with AI

The BoK also serves as a knowledge-sharing interface between AI and developers.

AI can learn from the BoK in the following formats:

  • HTML site (high versatility)

  • Antora site (structured as technical documentation)

  • SmartDox site (highest contextual density)

When published as a web page, an HTML site can be analyzed by AI using standard web crawling techniques.

All of these are text-based in structure, making them suitable for Git-based management and AI ingestion.

Since Antora is widely adopted, it becomes a high-quality learning source for AIs that can understand its structure.

SmartDox sites, once their structure is learned by AI, can serve as an even more precise training source.

Advantages of Building a BoK with SSG

Dynamically generated sites using databases create content structure at the time of request, making it difficult to analyze the structure and thus disadvantageous as a BoK source.

Sites built as SPAs (Single Page Applications) using JavaScript frameworks such as Angular or React dynamically construct the DOM on the client side, making them unsuitable for direct HTML structure analysis by search engines or AI.

In particular, for AI to learn and interpret a BoK, it is important that structured HTML or markup can be statically retrieved. With static HTML, AI can accurately understand link structures, document hierarchies, and term relationships.

In BoK building, publishing structured and explicit knowledge through SSG (Static Site Generators) is critically important for integration with AI.

To meet these requirements, SimpleModeling.org adopts static site generation technologies such as Arcadia and Antora to build a reliable mechanism for delivering structured BoK content to AI.

To improve readability and usability for developers, the latest CSS and JavaScript technologies are integrated with static structures to enhance expressiveness without compromising visibility or aesthetics.

As a result, a hybrid BoK site is realized—one that is easy to use and structurally intuitive for both humans and AI.

Summary

  • Lower the barrier to BoK construction with a configuration that is easy to adopt

  • Support understanding by search engines and AI through semantic annotation based on web metadata

  • Connect terms and contexts within the BoK via automatic link-building functionality

  • Support both international users and AI through multilingual mechanisms

  • Build a BoK that balances structure, visibility, and extensibility using SmartDox, Antora, and Arcadia

  • Enable easy tracking, team collaboration, and AI ingestion through Git-based management

  • Realize “readable + analyzable” documents as a BoK usable by both humans and AI

  • Achieve an optimal BoK for both AI and humans by avoiding SPA and combining static structure with modern web technologies

Diagram: AI-Driven Architecture

Diagram: AI-Driven Architecture
Figure 2. Diagram: AI-Driven Architecture

This diagram illustrates the overall architecture of Literate Model-Driven Development as explained in Purpose of the Site.

The BoK building discussed in this article corresponds to the "AI Learning" and "BoK Management" areas within this architecture.

The BoK serves as a knowledge-sharing interface that enables AI to support literate modeling, and it is an essential foundation for AI-driven development.

Please use this diagram as a reference to understand the role of the BoK in relation to AI assistance.