From 36a9ecff474c4ba079a752e532f9f5f83e400569 Mon Sep 17 00:00:00 2001
From: darrenhinde <107584450+darrenhinde@users.noreply.github.com>
Date: Sun, 16 Nov 2025 23:47:45 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs:=20add=20clear=20explanatio?=
 =?UTF-8?q?n=20of=20what=20the=20Blueprint=20is=20at=20the=20top?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .opencode/AGENT-SYSTEM-BLUEPRINT.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/.opencode/AGENT-SYSTEM-BLUEPRINT.md b/.opencode/AGENT-SYSTEM-BLUEPRINT.md
index a0540b9..16fdc98 100644
--- a/.opencode/AGENT-SYSTEM-BLUEPRINT.md
+++ b/.opencode/AGENT-SYSTEM-BLUEPRINT.md
@@ -4,6 +4,20 @@ _Build Intelligent Workflow Systems with Context-Aware AI_
 
 ---
 
+## 📘 What Is This Blueprint?
+
+**This is a teaching document** that explains how the OpenCode agent system works and how to extend it for your needs.
+
+**You don't need to read this to use the system** - the agents work out of the box. Read this document only if you want to:
+- Understand the architecture behind the system
+- Create your own custom agents and commands
+- Extend the system with domain-specific patterns
+- Learn how context loading and agent coordination works
+
+**If you just want to start building**, skip this document and use `codebase-agent` instead. See the [README.md](../../README.md) for quick start instructions.
+
+---
+
 ## ⚡ TL;DR - Quick Reference
 
 **For New Users:**