Mako

Quality 0.50 · 6 views · Updated 1 month ago

Mako is an AI assistant built by CloudSurf Software, integrated into the Surf Docs workspace at app.surf. Named after the mako shark -- the fastest shark species -- Mako provides document generation, research assistance, content enhancement, and fact verification capabilities, with native understanding of the SurfDoc format.

title: "Mako" type: doc version: 1 created: 2026-03-26 author: "K. Brady Davis" status: draft scope: public tags: [wiki, mako, ai-assistant, surf-docs]

Mako

::figure[src=/home/brady/Projects/cloudsurf/repos/cloudsurf-strategy-staging/plans/wiki-articles/mako-logo.png, alt=Mako Logo] ::

::summary Mako is an AI assistant built by CloudSurf Software, integrated into the Surf Docs workspace at app.surf. Named after the mako shark -- the fastest shark species -- Mako provides document generation, research assistance, content enhancement, and fact verification capabilities, with native understanding of the SurfDoc format. ::

Overview

Mako is an AI assistant developed by CloudSurf Software LLC for use within the Surf Docs document workspace. It is designed to work natively with the SurfDoc format, understanding typed block directives, document metadata, and semantic structure rather than treating documents as unstructured text.

The assistant is accessible through the Surf Docs interface at app.surf.

Name

Mako takes its name from the mako shark (genus Isurus), recognized as the fastest shark species, capable of swimming at speeds exceeding 70 kilometers per hour. The name reflects the assistant's emphasis on speed and efficiency in document workflows.

Capabilities

Document Generation

Mako can generate complete SurfDoc files from natural language descriptions. Generated documents include properly structured YAML frontmatter, typed block directives, and standard heading hierarchies. Users can request specific document types -- plans, guides, reports, analyses -- and Mako produces output conforming to SurfDoc conventions.

Research Assistance

Mako assists with research tasks by synthesizing information, identifying relevant sources, and organizing findings into structured document sections. Within the Surf Wiki ecosystem, Mako can reference and cross-link existing articles to support new content creation.

Content Enhancement

For existing documents, Mako provides editing suggestions, structural improvements, and content expansion. The assistant understands SurfDoc's typed block system and can recommend appropriate block types for different content -- converting unstructured notes into properly typed callouts, summaries, action items, and decision records.

Fact Verification

Mako includes fact-checking capabilities that validate claims within documents against available sources. This functionality supports the verification pipeline used by Surf Wiki, where articles progress through verification tiers from community-contributed to AI-verified to AI-and-human-verified status.

SurfDoc Integration

A distinguishing characteristic of Mako is its native understanding of SurfDoc-formatted content. The assistant produces output that conforms to the SurfDoc specification without additional post-processing. Mako understands the semantic meaning of typed blocks, the role of frontmatter metadata, and the structural conventions of the ARDS standard.

When generating or editing documents, Mako preserves existing document structure, respects block nesting rules, and maintains metadata consistency.

Availability

Mako is available within the Surf Docs workspace at app.surf. The assistant is invoked through the document editor interface.

References

wikimakoai-assistantsurf-docs