From bd49a854312589b3bb0bd6cadca54a745955c3c7 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 25 Dec 2025 18:07:30 +0000
Subject: [PATCH 1/2] Initial plan


From 17a3dac25577d38d000cc063297a01e82673470f Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 25 Dec 2025 18:12:17 +0000
Subject: [PATCH 2/2] Add diagram showing coding context prompt structure to
 README

Co-authored-by: alexec <1142830+alexec@users.noreply.github.com>
---
 README.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/README.md b/README.md
index 0ad27e6..0cebfd8 100644
--- a/README.md
+++ b/README.md
@@ -7,6 +7,53 @@ This tool collects context from predefined rule files and a task-specific prompt
 **📖 [View Full Documentation](https://kitproj.github.io/coding-context-cli/)**  
 **📊 [View Slide Deck](./SLIDES.md)** | [Download PDF](./SLIDES.pdf) | [How to Present](./SLIDES_README.md)
 
+## Generated Context Structure
+
+The tool assembles context into a structured prompt with the following components:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Generated Coding Context Prompt                             │
+├─────────────────────────────────────────────────────────────┤
+│                                                               │
+│  ┌───────────────────────────────────────────────────────┐  │
+│  │ 1. Task Frontmatter (YAML)                            │  │
+│  │    • Task metadata (selectors, agent, etc.)           │  │
+│  │    • Always included when task has frontmatter        │  │
+│  └───────────────────────────────────────────────────────┘  │
+│                                                               │
+│  ┌───────────────────────────────────────────────────────┐  │
+│  │ 2. Skills Metadata (XML) - Optional                   │  │
+│  │    • Available skills with names & descriptions       │  │
+│  │    • Progressive disclosure - full content on demand  │  │
+│  │    • Only included if skills are discovered           │  │
+│  └───────────────────────────────────────────────────────┘  │
+│                                                               │
+│  ┌───────────────────────────────────────────────────────┐  │
+│  │ 3. Rules Content (Markdown)                           │  │
+│  │    • Coding standards and guidelines                  │  │
+│  │    • Team conventions and best practices              │  │
+│  │    • Filtered by selectors (-s flag)                  │  │
+│  │    • Skipped in resume mode (-r flag)                 │  │
+│  └───────────────────────────────────────────────────────┘  │
+│                                                               │
+│  ┌───────────────────────────────────────────────────────┐  │
+│  │ 4. Task Content (Markdown)                            │  │
+│  │    • Task-specific instructions                       │  │
+│  │    • Parameter substitutions (${param})               │  │
+│  │    • Command expansions (!`command`)                  │  │
+│  │    • Path expansions (@file)                          │  │
+│  └───────────────────────────────────────────────────────┘  │
+│                                                               │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Key Points:**
+- **Task Frontmatter**: Provides metadata for agent decision-making and workflow automation
+- **Skills**: Enable progressive disclosure of specialized capabilities
+- **Rules**: Reusable context that applies across multiple tasks
+- **Task Content**: Specific instructions for the current task with dynamic content expansion
+
 ## Features
 
 - **Dynamic Context Assembly**: Merges context from various source files.