Skip to content

Agents: Write the documentation in Matěj's tone of voice - #33

Open
immakermatty wants to merge 1 commit into
mainfrom
agent/DEV-6626-docs-matej-tone-of-voice
Open

immakermatty wants to merge 1 commit into
mainfrom
agent/DEV-6626-docs-matej-tone-of-voice

Conversation

@immakermatty

Copy link
Copy Markdown
Contributor

Status: ready for review.

Why

Matěj (co-founder), 2026-10-08: agents who write Lazurio documentation should use his tone of voice. The same day he asked to keep product interfaces minimal and to move explanations into the documentation (plan DEV-6626). That makes the documentation's voice more visible.

What changes

AGENTS.md → "Content contract" gains a short Voice subsection:

  • The public core of the voice: a calm, direct, human technical partner who starts from the reader's situation and the practical impact, uses plain language, translates technical points into what changes for the reader, and avoids guru tone, grand visions, marketing claims and overpromising.
  • A pointer to the canonical guide company/agents/voice/MATEJ_TONE_OF_VOICE.md in the HumanAndMachine-ai Organization, for agents with access.
  • The editorial rules stay. The voice adds to them and replaces none.

What it deliberately does not change

  • No document content. Existing pages are not rewritten in this PR.
  • No private material from the voice guide is copied; only the writing style is summarized.

Verification

  • Docs-only change to AGENTS.md; no build input changed.
  • pr-preflight: ready to push on top of origin/main 884340c.

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Oct 8, 2026 •

Copy link
Copy Markdown

Cloudflare Pages preview

This comment is updated after every successful preview deployment.

@agentrozjedemeai agentrozjedemeai left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@immakermatty Exact-head review 1b3d20b — APPROVED for the AGENTS.md-only voice rule. The public-safe summary matches the canonical Matěj guide; no private material or document content was copied. git diff --check and synthetic integration with current main passed; CI test and preview build green, zero unresolved threads.

Publication is a separate gate: GitHub currently reports BEHIND, and AGENTS.md requires current GA4 Enhanced Measurement readback before production release. This content verdict does not claim either deployment gate is met.

Matěj, 2026-10-08: agents writing Lazurio documentation use his tone of
voice. AGENTS.md now carries the public core of that voice (a calm,
direct technical partner who starts from the reader's situation and
practical impact, without jargon or overpromising) and points to the
canonical guide in the HumanAndMachine-ai Organization.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch was successfully deployed

1 active deployment
preview-pr-33 — 922eb9b7 Deployed Oct 8, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants