Overview

Formats of this Guide

Read it in whichever form fits how you work — all four stay in sync with this repo:

• 📄 Markdown — guide.md in this repo. The canonical source; everything else is generated from it. Best for reading in your editor, feeding to an agent, or sending a PR.
• 📖 Online — agentic-engineering.guide — a browsable web version: one page per tier, dark/light mode, easy to share. Built from guide.md by the static-site generator in web/ and rebuilt on every change, so it never drifts from this repo.
• 🕸️ Obsidian vault — the wiki/ folder is a wikified version: the guide split into linked pages — one per tier, concept, and entity — cross-referenced with [[wikilinks]]. Open wiki/ as an Obsidian vault to navigate by graph instead of top-to-bottom: jump between related tips, see how concepts connect, and explore the harness, loops, and primitives as a web. Best when you want to study the material, not just read it.
• 🔌 In your repo — install the plugin (/plugin install pape@pape) and the whole guide ships with it, byte-identical and enforced by CI. /pape:agentic-coach quotes tips from it as you work, and /pape:harness-audit rates the repo you're in against the eight tiers — see Audit your harness. The guide is there while you work, instead of somewhere you go.