toppymicroservices.github.io

ToppyMicroServices OÜ — Designing ultra-lean, AI-first companies from scratch.

This repository contains the source for the public website of ToppyMicroServices OÜ.
The README is written for readers who want to understand the site structure, intent, and scope.

Contents

• toppymicroservices.github.io
  • Contents
  • Overview
  • Public Pages
  • Concept Notes
  • Interactive Quizzes
  • Research References
  • Compliance & Governance Mapping
  • Local Development
  • Deployment
  • Contact
  • Changelog

Overview

This repository hosts the static website for ToppyMicroServices OÜ, deployed via GitHub Pages.

ToppyMicroServices designs ultra-lean, AI-first companies from scratch. In this context, "company design" refers to the deliberate structuring of roles, workflows, decision boundaries, and automation, with the goal of minimizing headcount, organizational overhead, and long-term lock-in.

The website serves three purposes:

• To state the company design principles that guide our work
• To publish proof artifacts (research notes, evaluation methods, and dashboards) that demonstrate these principles in practice
• To describe the scope of public-facing services

Current public services include ultra-lean company architecture, AI-first operations and automation, vendor-neutral evaluation and reliability, and dmarc4all (DMARC/SPF/DKIM policy design and reporting setup).

Public Pages

The site consists of a small number of standalone pages. Some pages describe services or policies, while others are published as proof artifacts supporting the company design philosophy.

Primary site: https://toppymicroservices.github.io (CNAME → https://toppymicros.com)

Selected standalone pages:

• Economy_AI_ERA.html — AI Economy / Window Guidance as Code (EN) — research note published as a proof artifact
• Economy_AI_ERA_ja.html — 同上（JA）
• theory.html — summary of Thermo-Credit (QTC) theory, published as a proof artifact
• education/quiz_finance_terms.html — Finance terminology quiz (JA)
• education/quiz_finance_terms_en.html — Finance terminology quiz (EN)

Concept Notes

Concept notes are early-stage research notes and design documents published as static pages.

They are intended for readers who want to understand the underlying ideas, assumptions, and design trade-offs. These pages are provided as proof artifacts and are not operational products, policy tools, or production systems.

Interactive Quizzes

This repository includes simple, client-side interactive quizzes for finance terminology (Japanese and English).

These quizzes are educational utilities and are independent from the core service offerings.

Quiz authoring policy (required)

These quizzes are not designed for certifications or rote memorization. Their purpose is to help developers build durable engineering skill in an AI-first era.

Purpose

• Organize what developers should already understand when using AI to implement or review related themes.
• Prioritize learning-by-reading the explanations: the explanation is part of the curriculum, not just an answer key.

Question policy

• Avoid memorization of commands/flags/options as a primary goal (AI can look these up). Instead, test the meanings behind them: concepts, design philosophy, thought frameworks, key terms, metric meanings, common misconceptions, and typical errors.
• When a new reference URL or a new small theme is added, create 10 questions.
• For a large theme, create 25 questions.

Explanation policy (must)

• Explanations are learning-first: a reader should be able to study by reading them.
• Include (at minimum):
  • (1) Context / why the question exists ("問題を出した背景") and what skill it trains
  • (2) What is being asked (definitions + the core concept)
  • (3) Real-world usage: when/where you would face this in practice
  • (4) Term/word explanations (mini glossary when needed)
  • (5) Especially important keywords must be bold
  • (6) A careful explanation for every option (including why each incorrect option is wrong); do not end with a one-line summary
  • (7) Related topics / adjacent concepts to connect the learning (briefly)
• Author the question and explanation blocks so Markdown-like formatting is safely/consistently rendered by the quiz template.

Research References

Some pages reference external research outputs associated with ToppyMicroServices.

• Preprint: https://arxiv.org/abs/2510.14925 (not peer-reviewed)
• Related artifacts include AuditLoop evaluation metrics and Thermo-Credit indicators, which are referenced from the site pages where relevant

Compliance & Governance Mapping

Selected pages reference external frameworks such as the EU AI Act, ISO/IEC 42001, and the NIST AI Risk Management Framework.

These references are provided for alignment and context only. They do not imply certification, regulatory approval, or formal compliance claims.

Local Development

The site can be served locally for inspection using a simple static file server:

python3 -m http.server 8080
# Open http://localhost:8080

Or with Node:

npx serve .

Lint / format suggestions (optional, not enforced yet):

brew install tidy-html5
tidy -qe Economy_AI_ERA.html

Deployment

The site is deployed automatically using GitHub Actions and GitHub Pages.

Automated via GitHub Actions (.github/workflows/static.yml). Workflow:

1. Trigger: push to main or manual dispatch.
2. Steps: checkout → configure Pages → upload entire repo as artifact → deploy.
3. Concurrency group pages ensures serialized deployments without canceling in-progress.

Custom domain configured via CNAME (toppymicros.com). Ensure DNS A/ALIAS records point to GitHub Pages.

Contact

For inquiries: info@toppymicros.com

Changelog

This changelog records major structural or publication-related updates to the site.

• 2026-02: Added YOLOZU release links (PyPI + Zenodo software/manual records) to the homepage.
• 2025-11: Added bilingual AI Economy proof-artifact pages and Thermo-Credit theory summary.
• 2025-10: Initial public site structure and deployment workflow.

---

© 2026 ToppyMicroServices OÜ — Registry code 16551297 — Tallinn, Estonia.