> [Maxim](https://wikilayer.org/smee-again) / Wikilayer authoring guide

# Wikilayer authoring guide

**Contents:**

- [What you get](#what-you-get)
- [Where it fits, where it doesn't](#where-it-fits-where-it-doesnt)
- [Working with it](#working-with-it)
  - [If you're a human](#if-youre-a-human)
  - [If you're an AI agent](#if-youre-an-ai-agent)
  - [Both sides](#both-sides)

Wikilayer is a substrate for any structured, growing body of writing. Humans and AI agents work on the same tree of nodes, served as rendered [markdown](page:4402) to a browser and as [MCP](page:4409) tools to an agent.

## What you get

- [Two views, one source](page:3113): humans see rendered [markdown](page:4402) in the browser, agents see addressable nodes through [MCP](page:4409).
- Built on standard parts: [markdown](page:4402) and [MCP](page:4409). Nothing proprietary; leave any time.
- [Three flavors](page:3112) of visibility: public with SEO out of the box, private team, or self-hosted single user. Picked once when you create a wiki.

## Where it fits, where it doesn't

[Use cases](page:3115) covers where Wikilayer fits (personal notes, team workspace, public reference, AI memory) and what it deliberately doesn't try to be (Notion's block editor and databases, Google Docs co-editing, Confluence-style permissions and approval workflows).

## Working with it

Wikilayer is a two-sided system. Below: what each side does, and what they both need to know.

### If you're a human

- [Set up MCP](page:4400).
- Talk to the agent. For example:
  - *"Create a private wiki in English called Project notes."*
  - *"Remember our chat about X? Turn that into a wiki section under Y."*
  - *"Research all threads about N on forum Z and capture the findings as a new wiki."*
  - *"Rewrite this page; keep the structure but tighten the prose."*
- [Share access](page:4390) with other people when you want collaborators.

### If you're an AI agent

- Follow the [agent rules](page:4401).
- Match the [writing style](page:2992).
- Check against [anti-patterns](page:3038).

### Both sides

- The human directs; the agent writes and pushes back when something's off. Full contract: [Roles](page:2988).
- Edits are reversible. Every change goes through `nodes_history`, [recoverable](page:3089) by hand.