From 042238476afa0a4e1389df812c576ea824ee276d Mon Sep 17 00:00:00 2001
From: alexion <contact@alexion.dev>
Date: Mon, 19 Oct 2026 16:04:30 -0400
Subject: [PATCH] feat(pi): add tldr prompt command

---
 .pi/prompts/tldr.md                  |  8 +++++++
 docs/00 INBOX/ai/tldr-design-tree.md | 36 ++++++++++++++++++++++++++++
 2 files changed, 44 insertions(+)
 create mode 100644 .pi/prompts/tldr.md
 create mode 100644 docs/00 INBOX/ai/tldr-design-tree.md

diff --git a/.pi/prompts/tldr.md b/.pi/prompts/tldr.md
new file mode 100644
index 0000000..d7cb9fd
--- /dev/null
+++ b/.pi/prompts/tldr.md
@@ -0,0 +1,8 @@
+---
+description: Summarize an agent response
+argument-hint: "[source request]"
+---
+
+Summarize `${ARGUMENTS:-the preceding agent response}`.
+Keep the summary compact.
+Use no fixed format.
diff --git a/docs/00 INBOX/ai/tldr-design-tree.md b/docs/00 INBOX/ai/tldr-design-tree.md
new file mode 100644
index 0000000..169c883
--- /dev/null
+++ b/docs/00 INBOX/ai/tldr-design-tree.md	
@@ -0,0 +1,36 @@
+# TL;DR command design tree
+
+This tree reviews the implementation decisions in `tldr-design.md`.
+
+## Settled decisions
+
+- **Command form and scope:** Add the project prompt template `.pi/prompts/tldr.md`.
+- **Explicit source interface:** Interpret command arguments as a free-form source request.
+- **Default source:** Summarize the preceding agent response when no source request exists.
+- **Summary shape:** Produce a compact summary without a fixed format.
+- **Unavailable or unclear sources:** Add no special handling policy.
+
+## Decision tree
+
+- Command behavior
+  - Source selection
+    - Settled: Use the preceding agent response without arguments.
+    - Settled: Interpret arguments as a free-form source request.
+  - Output
+    - Settled: Produce a compact summary without a fixed format.
+    - Summary language
+      - Settled: Do not prescribe a language policy.
+  - Error behavior
+    - Settled: Add no special handling policy for unavailable or unclear sources.
+
+## Frontier
+
+The frontier is empty.
+
+## Shared understanding pending confirmation
+
+The project gets a `/tldr` prompt command in `.pi/prompts/tldr.md`.
+Without arguments, it summarizes the preceding agent response.
+With arguments, it interprets them as a free-form source request.
+It produces a compact summary with no fixed format or language policy.
+The prompt adds no special policy for unavailable or unclear sources.