incitaciones 0.2.0 → 0.3.1

package/content/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026-05-22",
+  "version": "2026-07-29",
   "schema_version": "1.1",
   "prompts": [
     {
@@ -2223,17 +2223,137 @@
       "title": "Research and Audit Documentation Architecture",
       "description": "Audit existing documentation or plan a new suite using advanced frameworks",
       "source": "content/prompt-task-research-documentation.md",
-      "distilled": "content/distilled/research-documentation.md",
+      "distilled": "content/distilled/research-documentation/SKILL.md",
+      "skill_format": "progressive-disclosure",
       "tags": [
         "research",
         "documentation",
         "audit",
-        "information-architecture"
+        "information-architecture",
+        "diataxis",
+        "eppo",
+        "llm-readiness"
       ],
       "bundles": [
         "documentation",
         "research"
-      ]
+      ],
+      "eval": {
+        "task_types": [
+          "research",
+          "documentation",
+          "audit"
+        ],
+        "success_signals": [
+          "core_assertion_stated",
+          "every_doc_classified_to_one_quadrant",
+          "frankenbooks_flagged",
+          "eppo_compliance_checked",
+          "ai_readiness_assessed",
+          "measurement_signals_recommended",
+          "report_produced"
+        ],
+        "failure_signals": [
+          "content_drafted",
+          "stylistic_changes_suggested",
+          "quadrant_overlap_unflagged",
+          "missing_report"
+        ],
+        "stages": [
+          {
+            "name": "define-scope",
+            "hints": [
+              "primary audience",
+              "core assertion",
+              "value proposition"
+            ]
+          },
+          {
+            "name": "audit-content",
+            "hints": [
+              "references/checklist.md",
+              "diataxis quadrant",
+              "eppo status",
+              "cognitive load"
+            ]
+          },
+          {
+            "name": "map-snowflake",
+            "hints": [
+              "macro-expansion",
+              "component list",
+              "topic matrix"
+            ]
+          },
+          {
+            "name": "identify-gaps",
+            "hints": [
+              "references/llm-readiness.md",
+              "references/metrics.md",
+              "quadrant imbalance",
+              "llms.txt",
+              "rag chunking"
+            ]
+          },
+          {
+            "name": "produce-report",
+            "hints": [
+              "references/report-template.md",
+              "final report"
+            ]
+          }
+        ],
+        "references": [
+          {
+            "id": "checklist",
+            "path": "content/distilled/research-documentation/references/checklist.md",
+            "purpose": "audit-checklist",
+            "stage": "audit-content",
+            "optional": false,
+            "aliases": [
+              "references/checklist.md",
+              "checklist.md",
+              "checklist"
+            ]
+          },
+          {
+            "id": "llm-readiness",
+            "path": "content/distilled/research-documentation/references/llm-readiness.md",
+            "purpose": "gap-assessment",
+            "stage": "identify-gaps",
+            "optional": false,
+            "aliases": [
+              "references/llm-readiness.md",
+              "llm-readiness.md",
+              "llm readiness"
+            ]
+          },
+          {
+            "id": "metrics",
+            "path": "content/distilled/research-documentation/references/metrics.md",
+            "purpose": "measurement-signals",
+            "stage": "identify-gaps",
+            "optional": false,
+            "aliases": [
+              "references/metrics.md",
+              "metrics.md",
+              "metrics"
+            ]
+          },
+          {
+            "id": "report-template",
+            "path": "content/distilled/research-documentation/references/report-template.md",
+            "purpose": "output-template",
+            "stage": "produce-report",
+            "optional": false,
+            "aliases": [
+              "references/report-template.md",
+              "report-template.md",
+              "report template"
+            ]
+          }
+        ]
+      }
     },
     {
       "name": "implement-documentation",
@@ -2241,15 +2361,152 @@
       "title": "Implement High-Signal Documentation Topics",
       "description": "Write documentation using Diátaxis, Info Mapping, and EPPO principles",
       "source": "content/prompt-task-implement-documentation.md",
-      "distilled": "content/distilled/implement-documentation.md",
+      "distilled": "content/distilled/implement-documentation/SKILL.md",
+      "skill_format": "progressive-disclosure",
       "tags": [
         "implementation",
         "documentation",
-        "technical-writing"
+        "technical-writing",
+        "diataxis",
+        "info-mapping",
+        "eppo",
+        "versioning"
       ],
       "bundles": [
         "documentation"
-      ]
+      ],
+      "eval": {
+        "task_types": [
+          "implementation",
+          "documentation",
+          "writing"
+        ],
+        "success_signals": [
+          "quadrant_identified",
+          "matching_template_used",
+          "context_block_present",
+          "content_chunked_and_labeled",
+          "tldr_present",
+          "anti_patterns_avoided"
+        ],
+        "failure_signals": [
+          "mixed_intent",
+          "missing_context_block",
+          "generic_headers",
+          "missing_tldr",
+          "faq_antipattern_used"
+        ],
+        "stages": [
+          {
+            "name": "quadrant-check",
+            "hints": [
+              "references/templates.md",
+              "references/anti-patterns.md",
+              "tutorial",
+              "how-to",
+              "reference",
+              "explanation"
+            ]
+          },
+          {
+            "name": "eppo-init",
+            "hints": [
+              "title",
+              "context block",
+              "prerequisites"
+            ]
+          },
+          {
+            "name": "info-mapping",
+            "hints": [
+              "chunking",
+              "labeling",
+              "tables",
+              "lists"
+            ]
+          },
+          {
+            "name": "ai-polish",
+            "hints": [
+              "semantic headers",
+              "tldr",
+              "rag indexing"
+            ]
+          },
+          {
+            "name": "setup-tooling",
+            "hints": [
+              "references/tooling-comparison.md",
+              "references/versioning.md",
+              "references/diataxis-implementation.md",
+              "platform selection",
+              "versioning strategy"
+            ]
+          }
+        ],
+        "references": [
+          {
+            "id": "templates",
+            "path": "content/distilled/implement-documentation/references/templates.md",
+            "purpose": "output-template",
+            "stage": "quadrant-check",
+            "optional": false,
+            "aliases": [
+              "references/templates.md",
+              "templates.md",
+              "templates"
+            ]
+          },
+          {
+            "id": "anti-patterns",
+            "path": "content/distilled/implement-documentation/references/anti-patterns.md",
+            "purpose": "pitfall-catalog",
+            "stage": "quadrant-check",
+            "optional": false,
+            "aliases": [
+              "references/anti-patterns.md",
+              "anti-patterns.md",
+              "anti patterns"
+            ]
+          },
+          {
+            "id": "tooling-comparison",
+            "path": "content/distilled/implement-documentation/references/tooling-comparison.md",
+            "purpose": "platform-selection",
+            "stage": "setup-tooling",
+            "optional": true,
+            "aliases": [
+              "references/tooling-comparison.md",
+              "tooling-comparison.md",
+              "tooling comparison"
+            ]
+          },
+          {
+            "id": "versioning",
+            "path": "content/distilled/implement-documentation/references/versioning.md",
+            "purpose": "versioning-strategy",
+            "stage": "setup-tooling",
+            "optional": true,
+            "aliases": [
+              "references/versioning.md",
+              "versioning.md",
+              "versioning"
+            ]
+          },
+          {
+            "id": "diataxis-implementation",
+            "path": "content/distilled/implement-documentation/references/diataxis-implementation.md",
+            "purpose": "rollout-guide",
+            "stage": "setup-tooling",
+            "optional": true,
+            "aliases": [
+              "references/diataxis-implementation.md",
+              "diataxis-implementation.md",
+              "diataxis implementation"
+            ]
+          }
+        ]
+      }
     },
     {
       "name": "review-documentation",
@@ -2257,17 +2514,109 @@
       "title": "Review Documentation Quality (Rule of 5)",
       "description": "Iterative review of documentation for cognitive scannability and AI-readiness",
       "source": "content/prompt-task-review-documentation.md",
-      "distilled": "content/distilled/review-documentation.md",
+      "distilled": "content/distilled/review-documentation/SKILL.md",
+      "skill_format": "progressive-disclosure",
       "tags": [
         "review",
         "documentation",
         "technical-writing",
-        "parallel-review"
+        "parallel-review",
+        "diataxis",
+        "eppo",
+        "info-mapping",
+        "ai-readiness"
       ],
       "bundles": [
         "documentation",
         "reviews"
-      ]
+      ],
+      "eval": {
+        "task_types": [
+          "review",
+          "documentation",
+          "quality-assurance"
+        ],
+        "success_signals": [
+          "five_passes_completed_or_converged",
+          "issues_cited_with_locations",
+          "ai_readiness_deep_checked",
+          "final_verdict_present"
+        ],
+        "failure_signals": [
+          "stage_skipping_without_convergence",
+          "vague_findings_without_locations",
+          "shallow_ai_pass_only",
+          "missing_verdict"
+        ],
+        "stages": [
+          {
+            "name": "pass-1-intent",
+            "hints": [
+              "pass 1",
+              "diataxis intent",
+              "leaked intents"
+            ]
+          },
+          {
+            "name": "pass-2-eppo",
+            "hints": [
+              "pass 2",
+              "standalone utility",
+              "context"
+            ]
+          },
+          {
+            "name": "pass-3-scan",
+            "hints": [
+              "pass 3",
+              "scannability",
+              "labels",
+              "chunking"
+            ]
+          },
+          {
+            "name": "pass-4-accuracy",
+            "hints": [
+              "pass 4",
+              "whole game",
+              "fail-states",
+              "martini glass"
+            ]
+          },
+          {
+            "name": "pass-5-ai-readiness",
+            "hints": [
+              "pass 5",
+              "references/ai-readiness-criteria.md",
+              "llms.txt",
+              "rag chunking",
+              "dual-audience"
+            ]
+          },
+          {
+            "name": "final-report",
+            "hints": [
+              "severity totals",
+              "top findings",
+              "verdict"
+            ]
+          }
+        ],
+        "references": [
+          {
+            "id": "ai-readiness-criteria",
+            "path": "content/distilled/review-documentation/references/ai-readiness-criteria.md",
+            "purpose": "deep-ai-readiness-checks",
+            "stage": "pass-5-ai-readiness",
+            "optional": false,
+            "aliases": [
+              "references/ai-readiness-criteria.md",
+              "ai-readiness-criteria.md",
+              "ai readiness criteria"
+            ]
+          }
+        ]
+      }
     },
     {
       "name": "red-team-review",
@@ -3021,6 +3370,93 @@
         ]
       }
     },
+    {
+      "name": "whisper",
+      "type": "workflow",
+      "title": "Whisper — Accumulated Operational Knowledge",
+      "description": "Manage the ~/.whisper/ knowledge workspace: init, check, status, link plan, decommission, and knowledge routing",
+      "source": "content/prompt-workflow-whisper.md",
+      "distilled": "content/distilled/whisper/SKILL.md",
+      "skill_format": "progressive-disclosure",
+      "tags": [
+        "workflow",
+        "knowledge",
+        "planning",
+        "beads"
+      ],
+      "bundles": [
+        "essentials",
+        "workflow"
+      ]
+    },
+    {
+      "name": "close",
+      "type": "workflow",
+      "title": "Close Session",
+      "description": "End-of-session wrap-up. Summarizes, logs to daily journal, routes knowledge to ~/.whisper/, commits, and clears context",
+      "source": "content/prompt-workflow-close.md",
+      "distilled": "content/distilled/close/SKILL.md",
+      "skill_format": "single-file",
+      "tags": [
+        "workflow",
+        "session",
+        "journal"
+      ],
+      "bundles": [
+        "workflow"
+      ]
+    },
+    {
+      "name": "park",
+      "type": "workflow",
+      "title": "Park Session",
+      "description": "Snapshot current work before switching context. Logs to daily journal, releases ticket claims, records to ~/.whisper/",
+      "source": "content/prompt-workflow-park.md",
+      "distilled": "content/distilled/park/SKILL.md",
+      "skill_format": "single-file",
+      "tags": [
+        "workflow",
+        "session",
+        "context-switch"
+      ],
+      "bundles": [
+        "workflow"
+      ]
+    },
+    {
+      "name": "renew",
+      "type": "workflow",
+      "title": "Renew Session",
+      "description": "Resume work on a project or area. Loads context from journal, ~/.whisper/, and beads. Supports claiming work with file conflict detection",
+      "source": "content/prompt-workflow-renew.md",
+      "distilled": "content/distilled/renew/SKILL.md",
+      "skill_format": "single-file",
+      "tags": [
+        "workflow",
+        "session",
+        "context"
+      ],
+      "bundles": [
+        "workflow"
+      ]
+    },
+    {
+      "name": "next",
+      "type": "workflow",
+      "title": "Next — Rapid Session Snapshot",
+      "description": "Rapid session snapshot to ~/.whisper/ — no full close ceremony. Fast stash for later resumption via /renew",
+      "source": "content/prompt-workflow-next.md",
+      "distilled": "content/distilled/next/SKILL.md",
+      "skill_format": "single-file",
+      "tags": [
+        "workflow",
+        "session",
+        "snapshot"
+      ],
+      "bundles": [
+        "workflow"
+      ]
+    },
     {
       "name": "project-status-report",
       "type": "task",
@@ -3127,7 +3563,8 @@
         "code-review",
         "research-codebase",
         "create-handoff",
-        "resume-handoff"
+        "resume-handoff",
+        "whisper"
       ]
     },
     "planning": {
@@ -3210,6 +3647,16 @@
         "doc-link-verifier"
       ]
     },
+    "workflow": {
+      "description": "Session lifecycle and workspace knowledge management",
+      "prompts": [
+        "whisper",
+        "close",
+        "park",
+        "renew",
+        "next"
+      ]
+    },
     "all": {
       "description": "Complete collection of all prompts",
       "prompts": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "incitaciones",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Reusable prompts and skills for CLI LLM tools, with native pi package support.",
   "repository": {
     "type": "git",
@@ -27,6 +27,7 @@
     "content/manifest.json",
     "pi-package/",
     "scripts/cli.mjs",
+    "scripts/generate-pi-resources.mjs",
     "LICENSE",
     "README.md"
   ],

package/pi-package/prompts/close.md

@@ -0,0 +1,10 @@
+---
+description: "Shortcut for the close skill. End-of-session wrap-up. Summarizes, logs to daily journal, routes knowledge to ~/.whisper/, commits, and clears context"
+---
+<!-- installed-from: incitaciones -->
+
+Use the installed `close` skill for this task.
+
+If the skill is not automatically loaded, invoke `/skill:close` and follow it.
+
+User context: $@

package/pi-package/prompts/next.md

@@ -0,0 +1,10 @@
+---
+description: "Shortcut for the next skill. Rapid session snapshot to ~/.whisper/ — no full close ceremony. Fast stash for later resumption via /renew"
+---
+<!-- installed-from: incitaciones -->
+
+Use the installed `next` skill for this task.
+
+If the skill is not automatically loaded, invoke `/skill:next` and follow it.
+
+User context: $@

package/pi-package/prompts/park.md

@@ -0,0 +1,10 @@
+---
+description: "Shortcut for the park skill. Snapshot current work before switching context. Logs to daily journal, releases ticket claims, records to ~/.whisper/"
+---
+<!-- installed-from: incitaciones -->
+
+Use the installed `park` skill for this task.
+
+If the skill is not automatically loaded, invoke `/skill:park` and follow it.
+
+User context: $@

package/pi-package/prompts/renew.md

@@ -0,0 +1,10 @@
+---
+description: "Shortcut for the renew skill. Resume work on a project or area. Loads context from journal, ~/.whisper/, and beads. Supports claiming work with file conflict detection"
+---
+<!-- installed-from: incitaciones -->
+
+Use the installed `renew` skill for this task.
+
+If the skill is not automatically loaded, invoke `/skill:renew` and follow it.
+
+User context: $@

package/pi-package/prompts/whisper.md

@@ -0,0 +1,10 @@
+---
+description: "Shortcut for the whisper skill. Manage the ~/.whisper/ knowledge workspace: init, check, status, link plan, decommission, and knowledge routing"
+---
+<!-- installed-from: incitaciones -->
+
+Use the installed `whisper` skill for this task.
+
+If the skill is not automatically loaded, invoke `/skill:whisper` and follow it.
+
+User context: $@

package/pi-package/skills/close/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: close
+description: "End-of-session wrap-up. Summarizes, logs to daily journal, routes knowledge to ~/.whisper/, commits, and clears context"
+metadata:
+  installed-from: "incitaciones"
+---
+---
+name: close
+description: "End-of-session wrap-up. Summarizes what was done, logs it to the daily journal, commits, pushes, and clears context. Trigger when the user says '/close', 'close session', or 'wrap up session'."
+tools: Read, Write, Edit, Glob, Bash
+---
+
+# Close Session
+
+End the current session: log what was done, update tasks, route durable knowledge to `~/.whisper/`, commit and push, clear context.
+
+Uses `$JOURNAL_PATH` (defaults to `~/dev/status`) for the daily log journal, and `~/.whisper/` for accumulated operational knowledge. The log subdirectory defaults to `log/`; set `$JOURNAL_LOG_SUBDIR` to override (e.g. `areas/log` for the JORNAL layout).
+
+## Steps
+
+1. Pull the journal repo:
+   ```bash
+   JOURNAL="${JOURNAL_PATH:-$HOME/dev/status}"
+   LOG_SUBDIR="${JOURNAL_LOG_SUBDIR:-log}"
+   cd "$JOURNAL" && git pull
+   ```
+
+2. Get today's date and time (`date +%Y-%m-%d`, `date +%H:%M`).
+   Derive the log path: `$JOURNAL/$LOG_SUBDIR/YYYY/YYYY-MM/YYYY-MM-DD.md`
+
+3. If the log file does not exist, create it with the daily log template.
+
+4. Review the full conversation history and write a concise session summary covering:
+   - What was worked on (key topics, files, repos)
+   - Decisions made
+   - Tasks completed or created
+   - Any unresolved items or next steps
+
+5. Append the summary to the `## Log` section of today's daily log:
+   ```
+   ### Session:HH:MM (<context>)
+   - bullet point summary entries
+   - **Next:** what to pick up next time (if applicable)
+   ```
+
+6. Update project/area files if tasks were completed or created:
+   - Mark completed tasks `[x]`
+   - Add new tasks as `[ ]`
+   - Add/update `[~]` waiting items
+   - Update `## Notes` with decisions
+
+7. If any tasks or follow-ups came up that aren't in a project/area, add them to `inbox.md`.
+
+8. **Route durable knowledge to `~/.whisper/`.** Scan the session for anything worth keeping and route by scope (skip this step entirely if nothing durable was learned):
+   - **Branch-specific finding** → `bd note <beads-epic>` or `~/.whisper/repos/<repo>/branches/<slug>/notes.md`
+   - **Repo-wide infra fact** → `~/.whisper/repos/<repo>/env.md`
+   - **Universal agent behavior rule** → `bd remember` or `~/.whisper/rules.md`
+   - **Worktree setup fact** → `~/.whisper/repos/<repo>/worktrees/<name>/env.md`
+   - **No secrets anywhere:** never write tokens, keys, or PII
+   - **Extend, don't duplicate:** append to existing notes rather than creating new ones
+
+9. Commit and push. Stage only the files this session touched, explicitly by name:
+   ```bash
+   cd "$JOURNAL" && git add <log-file> [<files>] && git commit -m "log: YYYY-MM-DD session notes" && git push
+   ```
+
+10. As the very last step, run `/clear` to reset the conversation context.
+
+## Rules
+
+- Do NOT ask the user any questions. Summarize automatically from conversation context.
+- Keep the summary concise — bullet points, not paragraphs.
+- If today's log already has content, append to it; never overwrite existing entries.
+- Always pull before reading and push after committing.