docs: capture agent workflow decisions

docs/.obsidian/workspace.json

@@ -219,6 +219,15 @@
   },
   "active": "daab69fc3faab88f",
   "lastOpenFiles": [
+    "00 INBOX/ai/tldr-design.md",
+    "00 INBOX/ai/caps-escape-design.md",
+    "AGENTS.md",
+    "00 INBOX/ai/tldr-design-tree.md",
+    "00 INBOX/ai/grill-skill-design.md",
+    "03 wrk/tasks/0012-gitea-axi-pr-merge-guardrail.md",
+    "03 wrk/tasks/0011-gitea-axi-rust-migration.md",
+    "00 INBOX/ai/gitea-axi-pr-merge-guardrail.md",
+    "00 INBOX/ai/gitea-axi-rust-migration.md",
     "00 INBOX/valheim progression.md",
     "03 wrk/tasks/0010-fix-main-monitor-detection.md",
     "00 INBOX/credits.md",
@@ -236,15 +245,6 @@
     "03 wrk/monorepo.md",
     "03 wrk/tasks/0001-todo-cli.md",
     "03 wrk/productivity.md",
-    "99 meta/templates/task.md",
-    "03 wrk/dotfiles.md",
-    "03 wrk/machoke.md",
-    "03 wrk/falinks.md",
-    "03 wrk/ariadne.md",
-    "03 wrk/tasks/0005-modules-services-navidrome.md",
-    "03 wrk/tasks/0003-registry-homepage.md",
-    "03 wrk/tasks/0039-hosts-zeus-hardware-configuration.md",
-    "03 wrk/tasks/0030-dotfiles-hosts.md",
     "03 wrk/tasks",
     "00 INBOX/let order name resolution.md~",
     "00 INBOX/nix name resolution.md~",

docs/00 INBOX/ai/caps-escape-design.md

@@ -0,0 +1,39 @@
+# Caps Escape Design
+
+## Facts
+
+- Commit `250b0b71f` removed `services.xserver.xkb.options` from the shared host module.
+- The removed option was `caps:escape_shifted_capslock`.
+- That XKB option maps Caps Lock to Escape.
+- Shift+Caps Lock still enables Caps Lock.
+- The shared host module configures Neogaia, Zeus, and Pikachu.
+- Zeus has QMK firmware that provides equivalent keyboard behavior.
+- Neogaia and Zeus enable `modules.host.cachyos` and `modules.desktop`.
+- Pikachu enables neither module.
+- `configs/nixos/hosts/neogaia/default.nix` directly sets Neogaia-specific hardware, networking, desktop application, and Waybar settings.
+- The current configuration has no Caps Lock or Escape remapping.
+- This session runs on Zeus, not Neogaia.
+
+## Design Tree
+
+- Restore Caps Lock behavior
+  - Scope the configuration
+    - Configure Neogaia only. ✓
+  - Select the mapping behavior.
+    - Restore `caps:escape_shifted_capslock`. ✓
+    - Set `services.xserver.xkb.options` in `configs/nixos/hosts/neogaia/default.nix`. ✓
+  - Define validation for Neogaia.
+    - Run static checks and manually verify both keys after deployment. ✓
+    - Stop after source and static validation. ✓
+
+## Settled Decisions
+
+1. Configure the mapping on Neogaia only.
+2. Restore `caps:escape_shifted_capslock`.
+3. Set `services.xserver.xkb.options` directly in Neogaia's host configuration.
+4. Run static checks and manually verify both keys on Neogaia after deployment.
+5. Stop after source and static validation.
+
+## Frontier
+
+None.

docs/00 INBOX/ai/tldr-design.md

@@ -0,0 +1,39 @@
+# TL;DR command design
+
+## Goal
+
+Add a Pi command that summarizes the preceding agent response by default.
+An explicit command argument identifies the source to summarize.
+
+## Decision tree
+
+- Command form and scope
+  - Settled: Create a project prompt template at `.pi/prompts/tldr.md`.
+  - Command interface
+    - Settled: Pass arguments through as a free-form source request.
+    - Default source selection
+      - Settled: Summarize the preceding agent response when no source request exists.
+      - Summary format and length
+        - Settled: Use a compact, format-free summary.
+        - Ambiguous-source behavior
+          - Settled: Add no special handling policy.
+
+## Settled decisions
+
+- **Q1 — Command form and scope:** Create a project prompt template.
+- **Q2 — Explicit source interface:** Accept a free-form source request.
+- **Default source selection:** Summarize the preceding agent response when the command has no arguments.
+- **Q3 — Summary shape:** Use a compact, format-free summary.
+- **Q4 — Unavailable source:** Add no special handling policy.
+
+## 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.
+The prompt adds no special policy for unavailable or unclear sources.

docs/TODO.md

@@ -29,7 +29,6 @@
 # Migration
 
 - [[technical-writing]] -> skill?
-- gitea-axi
 - skills
   - claude-code/codebase-design
   - claude-code/implement