| 1 | --- |
| 2 | slug: welcome-writing |
| 3 | title: "Writing on AI-Guiders" |
| 4 | description: "Org essays and release notes live here; deeper personal posts stay on the author site." |
| 5 | date_display: "May 2026" |
| 6 | order: 1 |
| 7 | tags: |
| 8 | - meta |
| 9 | - agents |
| 10 | --- |
| 11 | |
| 12 | This section is the **org writing surface** for AI-Guiders: product direction, open-stack notes, and material that belongs next to the repositories — not only in READMEs or ADRs. |
| 13 | |
| 14 | ## What goes here |
| 15 | |
| 16 | - **Org voice** — parity, observable loops, MCP and IDE decisions we want to cite from the handbook or GitHub. |
| 17 | - **Pointers** — when a topic is personal or experimental, we link out instead of duplicating. |
| 18 | |
| 19 | Long-form essays and the full archive remain on [Dmitry Karataev's site](https://karataevdmitry.github.io/writing/) (EN) and [RU](https://karataevdmitry.github.io/ru/writing/). Example cross-post: [Agent Notes MCP 2.0](https://karataevdmitry.github.io/writing/agent-notes-mcp-2-one-config.html). |
| 20 | |
| 21 | ## How to publish |
| 22 | |
| 23 | Add paired `src/writing/en/*.md` and `src/writing/ru/*.md`, then run `dotnet script tools/build-writing.csx` from the repo root. See `src/writing/README.md`. |
| 24 | |
View only · write via MCP/CIDE