Skip to content
Merlon Docs
Search
Ctrl
K
Cancel
GitHub
Select theme
Dark
Light
Auto
Menu
Learn Merlon Docs
Parts 1–2: Agent Skill
What this tool is
What kind of Agent Skill is this?
Why use Merlon Docs?
Get started
Merlon Docs 101
The Toolchain
Versions and feedback
Learn more
This repository
Read the Skill (SKILL.md)
Skills & workflows index
SKILL.md (merlon-docs)
Skill workflows
Getting-started workflow
Doc-only workflow
Design-architecture workflow
Feature-level workflow
UX workflow
Doc-review workflow
First-feature tutorial
Skill references
Install the skill
CLI commands reference
Shard single responsibility
Review lenses
Consolidation playbook
Acknowledgments
Part 3: CLI (merlon)
About
Get started
Why Merlon Docs for coding agents
Install and quick start
Project layout
Config essentials
Consumer migration
Shared glossary
Reference
Commands reference
Config reference
Coverage in check
Compile and the refs registry
Cross-links and refs
Optional linters
See also
Related packages
Terms in this guide
Concepts
Features Guide
About this guide
Start here
Overview
Personas and priority tiers
Feature catalog
Agent Skill and its workflows
Agent Skill
Skill workflows
Getting-started workflow
Feature-level workflow
Doc-only workflow
Design-architecture workflow
UX workflow
Doc-review workflow
Compile and validate
Manifest compile order
Default compile hooks
Compile pipeline
Overview
Front matter
Link passes
Path lookup order
Fence scan
Section slugs
Cross-guide link rewriting
Publish-relative link rewriting
Tables after link rewriting
Source tags and default banner
Compile output backup
Check gate
Link validation
Monolith link lint
Path resolution in prose
Documentation coverage scan
Standalone guides
Refs registry path
Decisions and constraints
Architecture decision records
Overview
Records
ADR 0001 — Remove mdcp export profiles
ADR 0002 — Remove mdcp refs lookup
ADR 0003 — Do not adopt OKF
ADR 0004 — Decline a hard-gated branch-before-edit skill rule
ADR 0005 — Keep linear TypeScript scanners over rg, Peggy, or Rust
ADR 0006 — Publish one skill that routes to workflows
ADR 0007 — Review the docs as a set in their own workflow
Design constraints
Overview
Direct value bar
Enforceable rules
md-tree integration
Peer linters
GFM scope
Locale and language boundary
Preprocessor / templating (out of scope)
The system
Vision and roadmap
Scope and positioning
Alternatives and adoption
Usage model
Shard single responsibility and idea mitosis
Extensions and archetypes
Merlon Docs 1.0 spec
Acknowledgments
Evidence and research
Documentation and software reliability
Benefit claims and evidence
Performance goals
Research records
Overview
Records
Skill eval round: harm check after aligning the skill with its docs
Context sizes: this repository's guides against one shard
Skill eval round: measured changes to the mdcp skill
Field report: a fully automated repository
Field report: the edge of the validated surface
Benchmark: this repository's docs before and after single-pass compile
Field report: a first external evaluator
Library API
About
Get started
Quick example
API
Config API
Compile API
Refs and validation API
Shard and peers API
Compile hooks
Compile hooks overview
stripAnchors
codeEvidence
inlineInserts
See also
Related packages
Glossary
Glossary
Product terms
Agent Skills (Agent Skill, skill)
Merlon Docs
Skill practice
atomic commit groups
live skill eval
Documentation structure
shard
guide
manifest
guide tier
archetype
standalone guide
idea mitosis
shard single responsibility
domain glossary
Compile outputs and links
compiled guide
publish output
monolith
cross-link
heading slug
refs
refs registry
ignoreGuides
Validation
check
orphan
coverage
Format and wording
GFM
authored GFM
locale pack
Security
ReDoS
Adoption and messaging
WIIFM
Contributing
About this guide
Set up and find your way
Local setup
Cloud agent environments
Repository layout
Change the code
Packages and tests
Safe markdown parsing
Benchmarks
Work items
Agent work-item tracking
Issue intake and labels
Weekly issue triage
Docs and skills
Docs dogfooding
Markdown formatting
Agent Skill development
Live skill evals
Documentation site
Release
Versioning and releases
Formal models
Publishing
Security
Security-incident triage
Repository settings
GitHub Actions security checklist
GitHub
Select theme
Dark
Light
Auto
Merlon Docs — documentation system Agent Skill
Merlon Docs — documentation system Agent Skill
What this tool is
What kind of Agent Skill is this?
Why use Merlon Docs?
Get started
Merlon Docs 101
The Toolchain
Versions and feedback
Learn more
This repository