Skip to content
pentaglyph
pentaglyph — five standards bound by one AI-first workflow

pentaglyph

Five peer standards. One opinionated kit. Documentation your AI agent can actually navigate.
What is pentaglyph? 30-min getting started View on GitHub

The five standards, plus one binder

Section titled “The five standards, plus one binder”

arc42

Architecture documentation template by Dr. Peter Hruschka & Gernot Starke — the de-facto standard for software architecture in the German-speaking world. arc42.org

C4 model

Simon Brown’s four-tier visual notation for software architecture: Context → Container → Component → Code. c4model.com

MADR v3.0

Markdown Architecture Decision Records — every architectural decision is one file, one ID, one immutable record. adr.github.io/madr

Diátaxis

Daniele Procida’s four-quadrant model for technical writing: Tutorials, How-to, Reference, Explanation. diataxis.fr

TiSDD

This Is Service Design Doing — the canonical book on service design methods (personas, journeys, blueprints). thisisservicedesigndoing.com

PEL (binder)

Project Engagement Layer — composes eight client-communication primitives (Inception Deck / GitLab Handbook / Atlassian weekly / Basecamp Heartbeat / Amazon 6-pager / Now-Next-Later / DACI / RAID / PR-FAQ) for consulting work.

Why does this exist?

Section titled “Why does this exist?”

Documentation standards already exist — but the gap is a single workflow that tells humans and AI agents where every artifact goes, when to write it, and what state it goes through. pentaglyph fills exactly that gap. External standards stay authoritative; pentaglyph only adds:

  1. A concrete file layout that maps each standard to a directory.
  2. A canonical WORKFLOW.md covering placement and lifecycle.
  3. Per-directory README.md files with explicit AI instructions.
  4. A Bun-based CLI (bunx --bun @uyuutosa/pentaglyph init) that scaffolds the kit.

Read the full why →

Quick start

Section titled “Quick start”
Terminal window
bunx --bun @uyuutosa/pentaglyph init ./my-project --profile=standard --ai=claude

That command creates ./my-project/docs/ populated with the kit and ./my-project/.claude/rules/documentation.md for the Claude Code auto-load rule. Then open ./my-project/docs/AI_INSTRUCTIONS.md and ./my-project/docs/WORKFLOW.md — those two files are everything you need.

30-minute tutorial →