wotann 0.5.0 → 0.5.39

package/skills/scientific/markdown-mermaid-writing/templates/kanban.md

@@ -0,0 +1,223 @@
+<!-- Source: https://github.com/SuperiorByteWorks-LLC/agent-project | License: Apache-2.0 | Author: Clayton Young / Superior Byte Works, LLC (Boreal Bytes) -->
+
+# Kanban Board Documentation Template
+
+> **Back to [Markdown Style Guide](../markdown_style_guide.md)** — Read the style guide first for formatting, citation, and emoji rules.
+
+**Use this template for:** Tracking work items, sprint boards, project task management, release planning, or any scenario where you need a persistent, markdown-based view of work status. This board IS the tracking system — a file in your repo that evolves with your codebase.
+
+**Key features:** Visual Mermaid kanban diagram, work item tables with status tracking, WIP limits, blocked items, explicit Won't Do decisions, aging indicators, flow efficiency metrics, and historical throughput.
+
+**Philosophy:** This board is a file. Modify it in your branch, merge it with your PR. The board evolves WITH the codebase — no external board tool required. Anyone with repo access sees the board, AI agents included.
+
+A kanban board's job is to make work visible. This template serves two purposes: (1) a living board that gets updated as work progresses, and (2) a historical snapshot when archived. The Mermaid diagram gives the instant visual overview; the tables give the detail. Together they answer: What's being worked on? What's blocked? What's done? What's next?
+
+When archived, the board becomes the historical record of what was worked on, what was blocked, and what was completed — all in git history, with full attribution and timestamps. This is the [Everything is Code](../markdown_style_guide.md#-everything-is-code) philosophy: project management data lives in the repo, versioned and portable.
+
+---
+
+## File Convention
+
+```
+docs/project/kanban/sprint-2026-w07-agentic-template-modernization.md
+docs/project/kanban/release-v2.3.0-launch-readiness.md
+docs/project/kanban/project-auth-migration-phase-1.md
+```
+
+- **Directory:** `docs/project/kanban/`
+- **Naming:** Prefix with board scope (`sprint-`, `release-`, `project-`) + identifier + short lowercase hyphenated description
+- **Archiving:** When a board is complete, keep it in place — it becomes the historical record
+
+---
+
+## The Template
+
+Everything below the line is the template. Copy from here:
+
+---
+
+# [Board Name] — Kanban Board
+
+_[Scope: Sprint W07 2026 / Release v2.3.0 / Project: Auth Migration]_
+_[Team/Owner] · Last updated: [YYYY-MM-DD HH:MM]_
+
+---
+
+## 📋 Board Overview
+
+**Period:** [Start date] → [End date]
+**Goal:** [One sentence — what does "done" look like for this board?]
+**WIP Limit:** [Max items in "In Progress" — e.g., 3 per person, 6 total]
+
+### Visual board
+
+_Kanban board showing current work distribution across backlog, in-progress, review, done, blocked, and Won't Do columns:_
+
+```mermaid
+kanban
+    Backlog
+        task1[🔧 Deploy monitoring]
+        task2[📝 Write API docs]
+    In Progress
+        task3[⚙️ Build user dashboard]
+        task4[🐛 Fix payment timeout]
+    In Review
+        task5[👀 Add export feature]
+    Done
+        task6[🚀 Set up CI pipeline]
+        task7[📊 Database migration]
+    Blocked
+        task8[⛔ Waiting for security approval]
+    Won't Do
+        task9[❌ Drop mobile support in this sprint]
+```
+
+> ⚠️ Always show all 6 columns — Even if a column has no items, include it with a placeholder. This makes the board structure explicit and ensures categories are never forgotten. Use a placeholder like [No items yet] when a column is empty.
+
+---
+
+## 🚦 Board Status
+
+| Column             | Count | WIP Limit | Status                                         |
+| ------------------ | ----- | --------- | ---------------------------------------------- |
+| 📋 **Backlog**     | [N]   | —         | [Notes]                                        |
+| 🔄 **In Progress** | [N]   | [Limit]   | [🟢 Under limit / 🟡 At limit / 🔴 Over limit] |
+| 🔍 **In Review**   | [N]   | [Limit]   | [Status]                                       |
+| ✅ **Done**        | [N]   | —         | [This period]                                  |
+| 🚫 **Blocked**     | [N]   | —         | [See blocked section below]                    |
+| 🚫 **Won't Do**    | [N]   | —         | [Explicitly declined with rationale]           |
+
+> ⚠️ **Always include all 6 columns** — Each column represents a workflow state. Even if count is 0, keep the row visible. This prevents categories from being overlooked.
+
+---
+
+## 📋 Backlog
+
+_Prioritized top-to-bottom. Top items are next to be pulled. Include at least one placeholder item if empty._
+
+| #   | Item              | Priority  | Estimate | Assignee | Notes                   |
+| --- | ----------------- | --------- | -------- | -------- | ----------------------- |
+| 1   | [Work item title] | 🔴 High   | [S/M/L]  | [Person] | [Context or dependency] |
+| 2   | [Work item title] | 🟡 Medium | [Size]   | [Person] | [Notes]                 |
+|     | _[No items yet]_  |           |          |          |                         |
+
+---
+
+## 🔄 In Progress
+
+_Items currently being worked on. Include at least one placeholder item if empty._
+
+| Item        | Assignee | Started | Expected | Days in column | Aging | Status           |
+| ----------- | -------- | ------- | -------- | -------------- | ----- | ---------------- |
+| [Work item] | [Person] | [Date]  | [Date]   | [N]            | 🟢    | 🟢 On track      |
+|             |          |         |          |                |       | _[No items yet]_ |
+
+> 💡 **Aging indicator:** 🟢 Under expected time · 🟡 At expected time · 🔴 Over expected time — items aging red need attention or re-scoping.
+
+> ⚠️ **WIP limit:** [N] / [Limit]. [Under limit / At limit — pull more work / Over limit — finish something before starting new work]
+
+---
+
+## 🔍 In Review
+
+_Items awaiting or in code review. Include at least one placeholder item if empty._
+
+| Item        | Author   | Reviewer | PR                                                                                   | Days in review | Aging | Status                                           |
+| ----------- | -------- | -------- | ------------------------------------------------------------------------------------ | -------------- | ----- | ------------------------------------------------ |
+| [Work item] | [Person] | [Person] | [#NNN](../../docs/project/pr/pr-00000001-agentic-docs-and-monorepo-modernization.md) | [N]            | 🟢    | [Awaiting review / Changes requested / Approved] |
+|             |          |          |                                                                                      |                |       | _[No items yet]_                                 |
+
+---
+
+## ✅ Done
+
+_Completed this period. Include at least one placeholder item if empty._
+
+| Item        | Assignee | Completed | Cycle time | PR                                                                                   |
+| ----------- | -------- | --------- | ---------- | ------------------------------------------------------------------------------------ |
+| [Work item] | [Person] | [Date]    | [N days]   | [#NNN](../../docs/project/pr/pr-00000001-agentic-docs-and-monorepo-modernization.md) |
+|             |          |           |            | _[No items completed this period]_                                                   |
+
+---
+
+## 🚫 Blocked
+
+_Items that cannot proceed. Always include at least the placeholder — blocked items are high-signal and should never be hidden._
+
+| Item        | Assignee | Blocked since | Blocked by                                              | Escalated to  | Unblock action         |
+| ----------- | -------- | ------------- | ------------------------------------------------------- | ------------- | ---------------------- |
+| [Work item] | [Person] | [Date]        | [What's blocking — dependency, decision, external team] | [Person/team] | [What needs to happen] |
+|             |          |               |                                                         |               | _[No blocked items]_   |
+
+> 🔴 **[N] items blocked.** [Summary of what's needed to unblock them.]
+
+---
+
+## 🚫 Won't Do
+
+_Explicitly out of scope for this board period. Capture rationale so these decisions are transparent and auditable. Include placeholder if empty._
+
+| Item        | Date decided | Decision owner | Rationale                                      | Revisit trigger                      |
+| ----------- | ------------ | -------------- | ---------------------------------------------- | ------------------------------------ |
+| [Work item] | [Date]       | [Person/team]  | [Why this is intentionally excluded right now] | [What change would reopen this item] |
+|             |              |                | _[No items explicitly declined]_               |                                      |
+
+---
+
+## 📊 Metrics
+
+### This period
+
+| Metric                             | Value    | Target   | Trend   |
+| ---------------------------------- | -------- | -------- | ------- |
+| **Throughput** (items completed)   | [N]      | [Target] | [↑/→/↓] |
+| **Avg cycle time** (start → done)  | [N days] | [Target] | [↑/→/↓] |
+| **Avg lead time** (created → done) | [N days] | [Target] | [↑/→/↓] |
+| **Avg review time**                | [N days] | [Target] | [↑/→/↓] |
+| **Flow efficiency**                | [N%]     | [Target] | [↑/→/↓] |
+| **Blocked items**                  | [N]      | 0        | [↑/→/↓] |
+| **WIP limit breaches**             | [N]      | 0        | [↑/→/↓] |
+| **Items aging red**                | [N]      | 0        | [↑/→/↓] |
+
+> 💡 **Flow efficiency** = active work time ÷ total cycle time × 100. A healthy team targets 40%+. Below 15% means items spend most of their time waiting, not being worked on.
+
+<details>
+<summary><strong>📊 Historical Throughput</strong></summary>
+
+| Period              | Items completed | Avg cycle time | Blocked days |
+| ------------------- | --------------- | -------------- | ------------ |
+| [Previous period 3] | [N]             | [N days]       | [N]          |
+| [Previous period 2] | [N]             | [N days]       | [N]          |
+| [Previous period 1] | [N]             | [N days]       | [N]          |
+| **Current**         | [N]             | [N days]       | [N]          |
+
+</details>
+
+---
+
+## 📝 Board Notes
+
+### Decisions made this period
+
+- **[Date]:** [Decision and context — e.g., "Deprioritized auth refactor to focus on payment bug"]
+- **[Date]:** [Added/updated Won't Do decision with explicit rationale and revisit trigger]
+
+### Carryover from last period
+
+- [Item carried over] — [Why it wasn't completed and current status]
+
+### Upcoming dependencies
+
+- [Date]: [External dependency, release, or event that affects this board]
+
+---
+
+## 🔗 References
+
+- [Live project board](../../docs/project/kanban/sprint-2026-w08-crewai-review-hardening-and-memory.md) — Real-time tracking
+- [Previous board](../../docs/project/kanban/sprint-2026-w07-agentic-template-modernization.md) — Last period's snapshot
+- [Status report](../../docs/project/pr/pr-00000001-agentic-docs-and-monorepo-modernization.md) — Executive summary of this period
+
+---
+
+_Next update: [Date] · Board owner: [Person/Team]_

package/skills/scientific/markdown-mermaid-writing/templates/presentation.md

@@ -0,0 +1,312 @@
+<!-- Source: https://github.com/SuperiorByteWorks-LLC/agent-project | License: Apache-2.0 | Author: Clayton Young / Superior Byte Works, LLC (Boreal Bytes) -->
+
+# Presentation / Briefing Template
+
+> **Back to [Markdown Style Guide](../markdown_style_guide.md)** — Read the style guide first for formatting, citation, and emoji rules.
+
+**Use this template for:** Slide-deck-style documents, research presentations, briefings, lectures, walkthroughs, or any content that would traditionally be a PowerPoint. Designed to read well as a standalone document AND to serve as speaker-ready presentation notes.
+
+**Key features:** Collapsible speaker notes under every section, structured flow from context through content to action items, figure captions, and footnote citations.
+
+---
+
+## How to Use
+
+1. Copy this file to your project
+2. Replace all `[bracketed placeholders]` with your content
+3. Delete sections that don't apply (but keep the core flow)
+4. Add/remove content topics (H3s under 📚 Content) as needed
+5. Follow the [Markdown Style Guide](../markdown_style_guide.md) for all formatting
+6. Add [Mermaid diagrams](../mermaid_style_guide.md) wherever a concept benefits from a visual
+
+---
+
+## Template Structure
+
+The presentation follows a 6-section flow. Each section has an H2 with one emoji, content, and optional collapsible speaker notes.
+
+```
+1. 🏠 Housekeeping — Logistics, context, announcements
+2. 📍 Agenda — What we'll cover, with time estimates
+3. 🎯 Objectives — What the audience will walk away with
+4. 📚 Content — The main body (multiple H3 topics)
+5. ✍️ Action Items — What happens next, who owns what
+6. 🔗 References — Citations, resources, further reading
+```
+
+---
+
+## The Template
+
+Everything below the line is the template. Copy from here:
+
+---
+
+# [Presentation Title]
+
+_[Context line — project, team, date, or purpose]_
+
+---
+
+## 🏠 Housekeeping
+
+- [Logistics item or announcement]
+- [Important deadline or reminder]
+- [Any prerequisite context the audience needs]
+
+<details>
+<summary><strong>💬 Speaker Notes</strong></summary>
+
+- **Timing:** 2–3 minutes for this section
+- **Tone:** Conversational, get the room settled
+- [Specific note about announcement context]
+- [Transition line:] "With that covered, here's our plan for today..."
+
+</details>
+
+---
+
+## 📍 Agenda
+
+- [x] Housekeeping (3 min)
+- [ ] [Topic 1 name] (10 min)
+- [ ] [Topic 2 name] (15 min)
+- [ ] [Topic 3 name] (15 min)
+- [ ] Action items and Q&A (10 min)
+
+**Total:** [estimated time]
+
+<details>
+<summary><strong>💬 Speaker Notes</strong></summary>
+
+- Reference this agenda when transitioning between topics
+- If running long on a topic, note what you'll compress
+- "We have a natural break around the halfway point"
+- Adjust timing based on audience engagement — questions are good
+
+</details>
+
+---
+
+## 🎯 Objectives
+
+After this presentation, you'll be able to:
+
+- **[Action verb]** [specific, measurable outcome]
+- **[Action verb]** [specific, measurable outcome]
+- **[Action verb]** [specific, measurable outcome]
+
+<details>
+<summary><strong>💬 Speaker Notes</strong></summary>
+
+- Reference these objectives throughout the presentation
+- "This connects back to our first objective..."
+- At the end, revisit: "Let's check — did we hit all three?"
+- **Strong action verbs:** Identify, Analyze, Compare, Evaluate, Design, Implement, Explain, Distinguish, Create, Apply
+
+</details>
+
+---
+
+## 📚 Content
+
+### [Topic 1 title]
+
+[Opening context — why this matters, what problem it solves]
+
+**Key points:**
+
+- [Point 1 with brief explanation]
+- [Point 2 with brief explanation]
+- [Point 3 with brief explanation]
+
+Image placeholder: `images/slide-[filename].png`
+_Figure 1: [What this image demonstrates]_
+
+> 💡 **Key insight:** [The one-liner the audience should remember from this topic]
+
+<details>
+<summary><strong>💬 Speaker Notes</strong></summary>
+
+### Teaching strategy
+
+- **Open with a question:** "[Engaging question for the audience]?"
+- Take 2–3 responses
+- "Good thinking. Here's how this actually works..."
+
+### Core explanation (3–5 min)
+
+- Start with the definition/concept
+- Walk through step by step
+- Use a real-world example: "[Specific scenario]"
+
+### Common misconceptions
+
+- **What people think:** [Misconception]
+- **What's actually true:** [Reality]
+- **How to address it:** [Reframe]
+
+### Transition
+
+- "Now that we understand [concept], let's look at how it applies to..."
+
+</details>
+
+---
+
+### [Topic 2 title]
+
+[Context and explanation]
+
+**Comparison of approaches:**
+
+| Approach   | Best for   | Tradeoffs |
+| ---------- | ---------- | --------- |
+| [Option A] | [Scenario] | [Pro/con] |
+| [Option B] | [Scenario] | [Pro/con] |
+| [Option C] | [Scenario] | [Pro/con] |
+
+```mermaid
+flowchart LR
+    accTitle: [Short title for this diagram]
+    accDescr: [One sentence describing what the diagram shows]
+
+    step1[⚙️ Step one] --> step2[🔍 Step two] --> step3[✅ Step three]
+```
+
+[Explanation of what the diagram shows and why it matters]
+
+<details>
+<summary><strong>💬 Speaker Notes</strong></summary>
+
+### Walk through each option (5–6 min)
+
+**Option A:**
+
+- "Used when [scenario]"
+- "Advantage: [benefit]"
+- "Disadvantage: [drawback]"
+
+**Option B:**
+
+- "Used when [scenario]"
+- "Advantage: [benefit]"
+- "Disadvantage: [drawback]"
+
+### Decision-making exercise
+
+- Ask: "Given [scenario], which would you choose?"
+- Take responses, discuss reasoning
+- "In practice, professionals choose based on [criteria]"
+
+### Real-world example
+
+- "[Company/project] chose Option B because [reasoning]"
+- "The result was [outcome]"
+- "This matters because [relevance to audience]"[^1]
+
+</details>
+
+---
+
+### [Topic 3 title]
+
+[Context and explanation]
+
+**Process:**
+
+1. [First step with explanation]
+2. [Second step with explanation]
+3. [Third step with explanation]
+
+> ⚠️ **Common pitfall:** [What goes wrong and how to avoid it]
+
+[Deeper explanation, examples, or data supporting the topic]
+
+<details>
+<summary><strong>💬 Speaker Notes</strong></summary>
+
+### Interactive element
+
+- Pause at step 2: "What happens next?"
+- Take guesses before revealing step 3
+- "Why does this matter? Because [stakes]"
+
+### If audience is advanced
+
+- Skip the basics, jump to: "[Advanced angle]"
+- Challenge question: "What if [scenario changed]?"
+
+### If audience is struggling
+
+- Slow down, repeat the analogy
+- "Think of it like [simple comparison]"
+- Offer to cover more in Q&A
+
+### Timing
+
+- This should take about [N] minutes
+- If running long, compress the [specific part]
+
+</details>
+
+---
+
+## ✍️ Action items
+
+### Next steps
+
+| Action                 | Owner         | Due    |
+| ---------------------- | ------------- | ------ |
+| [Specific action item] | [Person/team] | [Date] |
+| [Specific action item] | [Person/team] | [Date] |
+| [Specific action item] | [Person/team] | [Date] |
+
+### Key takeaways
+
+1. **[Takeaway 1]** — [one sentence summary]
+2. **[Takeaway 2]** — [one sentence summary]
+3. **[Takeaway 3]** — [one sentence summary]
+
+<details>
+<summary><strong>💬 Speaker Notes</strong></summary>
+
+- Walk through each action item explicitly
+- "Who owns this? When is it due?"
+- "Questions about any of these?"
+- Revisit the objectives: "Did we hit all three?"
+- "Thank you for your time. I'm available for follow-up at [contact]."
+
+</details>
+
+---
+
+## 🔗 References
+
+### Sources cited
+
+_All footnote references from the presentation are collected here:_
+
+[^1]: [Author/Org]. ([Year]). "[Title]." _[Publication]_. <https://example.com>
+
+### Further reading
+
+- [Resource title](https://example.com) — Why this is useful
+- [Resource title](https://example.com) — What it provides
+
+### Tools mentioned
+
+- [Tool name](https://example.com) — Purpose and how to access
+
+<details>
+<summary><strong>💬 Speaker Notes</strong></summary>
+
+- "These resources are available in the shared document"
+- "Start with [specific resource] — it's the most practical"
+- "If you want to go deeper, [specific resource] covers the advanced topics"
+
+</details>
+
+---
+
+_Last updated: [Date]_