From e1fab23edd1e648455d3acd99f824f7c49b34fac Mon Sep 17 00:00:00 2001 From: Pavel Luzanov Date: Fri, 16 Oct 2026 19:37:58 +0900 Subject: [PATCH] docs(readme): protocol in three steps (orient, work, deposit) --- README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/README.md b/README.md index b2e0e5b..9545e21 100644 --- a/README.md +++ b/README.md @@ -52,6 +52,21 @@ flowchart LR --- +## The protocol in three steps + +```mermaid +flowchart LR + O[Orient] --> W[Work] --> D[Deposit] +``` + +1. **Orient** — read the local map (L0); pick a **layout** key or **node**. +2. **Work** — any harness, skills, MCP, or humans; AAP does **not** prescribe how work is done. +3. **Deposit** — durable results under layout **`artifacts`**; drafts under **`scratch`**; follow map rules (not random paths). + +**Core Orientation conformance requires only step 1**; steps 2–3 are **convention**, not conformance MUST. + +--- + ## How it works (Core) ### 1. One small map in *your* repo