incitaciones 0.10.0 → 0.10.1

package/content/distilled/doc-link-verifier/SKILL.md

@@ -1,8 +1,3 @@
----
-name: doc-link-verifier
-description: Audit repository documentation for broken links and contextual correctness — HTTP status, relative paths, anchors, and semantic mismatches between link text and target content.
----
-
 # doc-link-verifier
 
 Audit a repository's documentation for link problems. Two problems, actually:

package/content/distilled/pointers/close.md

@@ -4,4 +4,4 @@ This skill was consolidated into the **session** skill (router + references/ lay
 
 Use `/close` no more: invoke `/skill:session` and follow its mode table — this task is the **close** mode, which reads `references/close/SKILL.md`.
 
-This pointer exists so old invocations keep working; it will be removed in a future release. Update your notes and configs to `/skill:session`.
+This pointer is a permanent compiled alias (incitaciones-06i): every distribution surface renders it as banner + full member content. It is never deleted; old URLs and /skill invocations keep working forever.

package/content/distilled/pointers/create-handoff.md

@@ -4,4 +4,4 @@ This skill was consolidated into the **session** skill (router + references/ lay
 
 Use `/create-handoff` no more: invoke `/skill:session` and follow its mode table — this task is the **create-handoff** mode, which reads `references/create-handoff/SKILL.md`.
 
-This pointer exists so old invocations keep working; it will be removed in a future release. Update your notes and configs to `/skill:session`.
+This pointer is a permanent compiled alias (incitaciones-06i): every distribution surface renders it as banner + full member content. It is never deleted; old URLs and /skill invocations keep working forever.

package/content/distilled/pointers/create-issues.md

@@ -4,4 +4,4 @@ This skill was consolidated into the **issues** skill (router + references/ layo
 
 Use `/create-issues` no more: invoke `/skill:issues` and follow its mode table — this task is the **create-issues** mode, which reads `references/create-issues/SKILL.md`.
 
-This pointer exists so old invocations keep working; it will be removed in a future release. Update your notes and configs to `/skill:issues`.
+This pointer is a permanent compiled alias (incitaciones-06i): every distribution surface renders it as banner + full member content. It is never deleted; old URLs and /skill invocations keep working forever.

package/content/distilled/pointers/issue-review.md

@@ -4,4 +4,4 @@ This skill was consolidated into the **issues** skill (router + references/ layo
 
 Use `/issue-review` no more: invoke `/skill:issues` and follow its mode table — this task is the **issue-review** mode, which reads `references/issue-review/SKILL.md`.
 
-This pointer exists so old invocations keep working; it will be removed in a future release. Update your notes and configs to `/skill:issues`.
+This pointer is a permanent compiled alias (incitaciones-06i): every distribution surface renders it as banner + full member content. It is never deleted; old URLs and /skill invocations keep working forever.

package/content/distilled/pointers/next.md

@@ -4,4 +4,4 @@ This skill was consolidated into the **session** skill (router + references/ lay
 
 Use `/next` no more: invoke `/skill:session` and follow its mode table — this task is the **next** mode, which reads `references/next/SKILL.md`.
 
-This pointer exists so old invocations keep working; it will be removed in a future release. Update your notes and configs to `/skill:session`.
+This pointer is a permanent compiled alias (incitaciones-06i): every distribution surface renders it as banner + full member content. It is never deleted; old URLs and /skill invocations keep working forever.

package/content/distilled/pointers/park.md

@@ -4,4 +4,4 @@ This skill was consolidated into the **session** skill (router + references/ lay
 
 Use `/park` no more: invoke `/skill:session` and follow its mode table — this task is the **park** mode, which reads `references/park/SKILL.md`.
 
-This pointer exists so old invocations keep working; it will be removed in a future release. Update your notes and configs to `/skill:session`.
+This pointer is a permanent compiled alias (incitaciones-06i): every distribution surface renders it as banner + full member content. It is never deleted; old URLs and /skill invocations keep working forever.

package/content/distilled/pointers/renew.md

@@ -4,4 +4,4 @@ This skill was consolidated into the **session** skill (router + references/ lay
 
 Use `/renew` no more: invoke `/skill:session` and follow its mode table — this task is the **renew** mode, which reads `references/renew/SKILL.md`.
 
-This pointer exists so old invocations keep working; it will be removed in a future release. Update your notes and configs to `/skill:session`.
+This pointer is a permanent compiled alias (incitaciones-06i): every distribution surface renders it as banner + full member content. It is never deleted; old URLs and /skill invocations keep working forever.

package/content/distilled/pointers/rule-of-5-universal.md

@@ -4,4 +4,4 @@ This skill was consolidated into the **review** skill (router + references/ layo
 
 Use `/rule-of-5-universal` no more: invoke `/skill:review` and follow its mode table — this task is the **rule-of-5-universal** mode, which reads `references/rule-of-5-universal/SKILL.md`.
 
-This pointer exists so old invocations keep working; it will be removed in a future release. Update your notes and configs to `/skill:review`.
+This pointer is a permanent compiled alias (incitaciones-06i): every distribution surface renders it as banner + full member content. It is never deleted; old URLs and /skill invocations keep working forever.

package/content/distilled/whisper/SKILL.md

@@ -1,9 +1,3 @@
----
-name: whisper
-description: "Knowledge workspace management: init, check, status, link plan, decommission, routing. Delegates to the turu CLI when installed."
-tools: Read, Write, Edit, Bash
----
-
 # Whisper — Deterministic Operational Knowledge
 
 > **This skill is a thin pointer.** The canonical, versioned copy ships with

package/content/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026-09-15",
+  "version": "2026-09-18",
   "schema_version": "1.1",
   "prompts": [
     {
@@ -1991,7 +1991,7 @@
       "name": "close",
       "type": "workflow",
       "title": "Close (moved)",
-      "description": "Moved into the session skill. Hidden pointer for /skill:close compatibility; will be removed in a future release.",
+      "description": "Compiled alias of the end-of-session wrap-up mode of the session skill. Hidden from model invocation; invocable via /skill:close; serves the legacy site URL with full compiled content.",
       "source": "content/prompt-system-skill-router-architecture.md",
       "distilled": "content/distilled/pointers/close.md",
       "skill_format": "single-file",
@@ -2008,13 +2008,14 @@
         "documentation",
         "workflow"
       ],
-      "disable_model_invocation": true
+      "disable_model_invocation": true,
+      "pointer_for": "session/close"
     },
     {
       "name": "park",
       "type": "workflow",
       "title": "Park (moved)",
-      "description": "Moved into the session skill. Hidden pointer for /skill:park compatibility; will be removed in a future release.",
+      "description": "Compiled alias of the context-switch stash mode of the session skill. Hidden from model invocation; invocable via /skill:park; serves the legacy site URL with full compiled content.",
       "source": "content/prompt-system-skill-router-architecture.md",
       "distilled": "content/distilled/pointers/park.md",
       "skill_format": "single-file",
@@ -2031,13 +2032,14 @@
         "documentation",
         "workflow"
       ],
-      "disable_model_invocation": true
+      "disable_model_invocation": true,
+      "pointer_for": "session/park"
     },
     {
       "name": "next",
       "type": "workflow",
       "title": "Next (moved)",
-      "description": "Moved into the session skill. Hidden pointer for /skill:next compatibility; will be removed in a future release.",
+      "description": "Compiled alias of the quick stash mode of the session skill. Hidden from model invocation; invocable via /skill:next; serves the legacy site URL with full compiled content.",
       "source": "content/prompt-system-skill-router-architecture.md",
       "distilled": "content/distilled/pointers/next.md",
       "skill_format": "single-file",
@@ -2054,13 +2056,14 @@
         "documentation",
         "workflow"
       ],
-      "disable_model_invocation": true
+      "disable_model_invocation": true,
+      "pointer_for": "session/next"
     },
     {
       "name": "renew",
       "type": "workflow",
       "title": "Renew (moved)",
-      "description": "Moved into the session skill. Hidden pointer for /skill:renew compatibility; will be removed in a future release.",
+      "description": "Compiled alias of the resume prior work mode of the session skill. Hidden from model invocation; invocable via /skill:renew; serves the legacy site URL with full compiled content.",
       "source": "content/prompt-system-skill-router-architecture.md",
       "distilled": "content/distilled/pointers/renew.md",
       "skill_format": "single-file",
@@ -2077,13 +2080,14 @@
         "documentation",
         "workflow"
       ],
-      "disable_model_invocation": true
+      "disable_model_invocation": true,
+      "pointer_for": "session/renew"
     },
     {
       "name": "create-handoff",
       "type": "workflow",
       "title": "Create Handoff (moved)",
-      "description": "Moved into the session skill. Hidden pointer for /skill:create-handoff compatibility; will be removed in a future release.",
+      "description": "Compiled alias of the handoff document mode of the session skill. Hidden from model invocation; invocable via /skill:create-handoff; serves the legacy site URL with full compiled content.",
       "source": "content/prompt-system-skill-router-architecture.md",
       "distilled": "content/distilled/pointers/create-handoff.md",
       "skill_format": "single-file",
@@ -2100,13 +2104,14 @@
         "documentation",
         "workflow"
       ],
-      "disable_model_invocation": true
+      "disable_model_invocation": true,
+      "pointer_for": "session/create-handoff"
     },
     {
       "name": "rule-of-5-universal",
       "type": "workflow",
       "title": "Rule Of 5 Universal (moved)",
-      "description": "Moved into the review skill. Hidden pointer for /skill:rule-of-5-universal compatibility; will be removed in a future release.",
+      "description": "Compiled alias of the Rule-of-5 universal review mode of the review skill. Hidden from model invocation; invocable via /skill:rule-of-5-universal; serves the legacy site URL with full compiled content.",
       "source": "content/prompt-system-skill-router-architecture.md",
       "distilled": "content/distilled/pointers/rule-of-5-universal.md",
       "skill_format": "single-file",
@@ -2123,13 +2128,14 @@
         "documentation",
         "workflow"
       ],
-      "disable_model_invocation": true
+      "disable_model_invocation": true,
+      "pointer_for": "review/rule-of-5-universal"
     },
     {
       "name": "create-issues",
       "type": "workflow",
       "title": "Create Issues (moved)",
-      "description": "Moved into the issues skill. Hidden pointer for /skill:create-issues compatibility; will be removed in a future release.",
+      "description": "Compiled alias of the issue creation mode of the issues skill. Hidden from model invocation; invocable via /skill:create-issues; serves the legacy site URL with full compiled content.",
       "source": "content/prompt-system-skill-router-architecture.md",
       "distilled": "content/distilled/pointers/create-issues.md",
       "skill_format": "single-file",
@@ -2146,13 +2152,14 @@
         "documentation",
         "workflow"
       ],
-      "disable_model_invocation": true
+      "disable_model_invocation": true,
+      "pointer_for": "issues/create-issues"
     },
     {
       "name": "issue-review",
       "type": "workflow",
       "title": "Issue Review (moved)",
-      "description": "Moved into the issues skill. Hidden pointer for /skill:issue-review compatibility; will be removed in a future release.",
+      "description": "Compiled alias of the issue review mode of the issues skill. Hidden from model invocation; invocable via /skill:issue-review; serves the legacy site URL with full compiled content.",
       "source": "content/prompt-system-skill-router-architecture.md",
       "distilled": "content/distilled/pointers/issue-review.md",
       "skill_format": "single-file",
@@ -2169,7 +2176,8 @@
         "documentation",
         "workflow"
       ],
-      "disable_model_invocation": true
+      "disable_model_invocation": true,
+      "pointer_for": "issues/issue-review"
     }
   ],
   "bundles": {
@@ -2316,4 +2324,4 @@
       ]
     }
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "incitaciones",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Reusable prompts and skills for CLI LLM tools, with native pi package support.",
   "repository": {
     "type": "git",

package/pi-package/prompts/close.md

@@ -1,5 +1,5 @@
 ---
-description: "Shortcut for the close skill. Moved into the session skill. Hidden pointer for /skill:close compatibility; will be removed in a future release."
+description: "Shortcut for the close skill. Compiled alias of the end-of-session wrap-up mode of the session skill. Hidden from model invocation; invocable via /skill:close; serves the legacy site URL with full compiled content."
 ---
 <!-- installed-from: incitaciones -->
 

package/pi-package/prompts/create-handoff.md

@@ -1,5 +1,5 @@
 ---
-description: "Shortcut for the create-handoff skill. Moved into the session skill. Hidden pointer for /skill:create-handoff compatibility; will be removed in a future release."
+description: "Shortcut for the create-handoff skill. Compiled alias of the handoff document mode of the session skill. Hidden from model invocation; invocable via /skill:create-handoff; serves the legacy site URL with full compiled content."
 ---
 <!-- installed-from: incitaciones -->
 

package/pi-package/prompts/create-issues.md

@@ -1,5 +1,5 @@
 ---
-description: "Shortcut for the create-issues skill. Moved into the issues skill. Hidden pointer for /skill:create-issues compatibility; will be removed in a future release."
+description: "Shortcut for the create-issues skill. Compiled alias of the issue creation mode of the issues skill. Hidden from model invocation; invocable via /skill:create-issues; serves the legacy site URL with full compiled content."
 ---
 <!-- installed-from: incitaciones -->
 

package/pi-package/prompts/issue-review.md

@@ -1,5 +1,5 @@
 ---
-description: "Shortcut for the issue-review skill. Moved into the issues skill. Hidden pointer for /skill:issue-review compatibility; will be removed in a future release."
+description: "Shortcut for the issue-review skill. Compiled alias of the issue review mode of the issues skill. Hidden from model invocation; invocable via /skill:issue-review; serves the legacy site URL with full compiled content."
 ---
 <!-- installed-from: incitaciones -->
 

package/pi-package/prompts/next.md

@@ -1,5 +1,5 @@
 ---
-description: "Shortcut for the next skill. Moved into the session skill. Hidden pointer for /skill:next compatibility; will be removed in a future release."
+description: "Shortcut for the next skill. Compiled alias of the quick stash mode of the session skill. Hidden from model invocation; invocable via /skill:next; serves the legacy site URL with full compiled content."
 ---
 <!-- installed-from: incitaciones -->
 

package/pi-package/prompts/park.md

@@ -1,5 +1,5 @@
 ---
-description: "Shortcut for the park skill. Moved into the session skill. Hidden pointer for /skill:park compatibility; will be removed in a future release."
+description: "Shortcut for the park skill. Compiled alias of the context-switch stash mode of the session skill. Hidden from model invocation; invocable via /skill:park; serves the legacy site URL with full compiled content."
 ---
 <!-- installed-from: incitaciones -->
 

package/pi-package/prompts/renew.md

@@ -1,5 +1,5 @@
 ---
-description: "Shortcut for the renew skill. Moved into the session skill. Hidden pointer for /skill:renew compatibility; will be removed in a future release."
+description: "Shortcut for the renew skill. Compiled alias of the resume prior work mode of the session skill. Hidden from model invocation; invocable via /skill:renew; serves the legacy site URL with full compiled content."
 ---
 <!-- installed-from: incitaciones -->
 

package/pi-package/prompts/rule-of-5-universal.md

@@ -1,5 +1,5 @@
 ---
-description: "Shortcut for the rule-of-5-universal skill. Moved into the review skill. Hidden pointer for /skill:rule-of-5-universal compatibility; will be removed in a future release."
+description: "Shortcut for the rule-of-5-universal skill. Compiled alias of the Rule-of-5 universal review mode of the review skill. Hidden from model invocation; invocable via /skill:rule-of-5-universal; serves the legacy site URL with full compiled content."
 ---
 <!-- installed-from: incitaciones -->
 

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

@@ -1,14 +1,86 @@
 ---
 name: close
-description: "Moved into the session skill. Hidden pointer for /skill:close compatibility; will be removed in a future release."
+description: "Compiled alias of the end-of-session wrap-up mode of the session skill. Hidden from model invocation; invocable via /skill:close; serves the legacy site URL with full compiled content."
 metadata:
   installed-from: "incitaciones"
 disable-model-invocation: true
 ---
-# Moved: close
+> **Moved:** this entry is now the **close** mode of the **session** skill.
+> The full method is compiled below from `content/distilled/session/references/close/SKILL.md`.
+> Invoke via `/skill:close`, invoke `/skill:session` for the mode table,
+> or use this URL directly in a chat interface.
 
-This skill was consolidated into the **session** skill (router + references/ layout).
+#### Core Instructions (content/distilled/session/references/close/SKILL.md)
 
-Use `/close` no more: invoke `/skill:session` and follow its mode table — this task is the **close** mode, which reads `references/close/SKILL.md`.
+**Tools:** Read, Write, Edit, Glob, Bash
 
-This pointer exists so old invocations keep working; it will be removed in a future release. Update your notes and configs to `/skill:session`.
+# 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` for the daily log journal, and `~/.whisper/` for accumulated operational knowledge. Agent shells run non-interactive and never source `.bashrc`, so the environment may be missing these exports — resolve both values per step 1 (env → shell config → convention → legacy fallback).
+
+## Steps
+
+1. Pull the journal repo:
+   ```bash
+   # Non-interactive shells never source .bashrc, so $JOURNAL_PATH etc. are
+   # usually unset here. Source the config in a throwaway shell — bash itself
+   # handles comments, quotes, and nested vars ($JORNAL) — then fall back.
+   shellval() { bash -c 'source ~/.bashrc >/dev/null 2>&1; printf "%s\n" "${'"'$1'"'}"' 2>/dev/null; }
+   JOURNAL="${JOURNAL_PATH:-$(shellval JOURNAL_PATH)}"
+   [ -n "$JOURNAL" ] || JOURNAL="$(shellval JORNAL)"
+   [ -n "$JOURNAL" ] || JOURNAL="$HOME/para/areas/jornal"   # JORNAL convention
+   [ -d "$JOURNAL/.git" ] || JOURNAL="$HOME/dev/status"     # legacy clone; flag this fallback in the reply
+   LOG_SUBDIR="${JOURNAL_LOG_SUBDIR:-$(shellval JOURNAL_LOG_SUBDIR)}"
+   [ -n "$LOG_SUBDIR" ] || LOG_SUBDIR="areas/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.

package/pi-package/skills/create-handoff/SKILL.md

@@ -1,14 +1,112 @@
 ---
 name: create-handoff
-description: "Moved into the session skill. Hidden pointer for /skill:create-handoff compatibility; will be removed in a future release."
+description: "Compiled alias of the handoff document mode of the session skill. Hidden from model invocation; invocable via /skill:create-handoff; serves the legacy site URL with full compiled content."
 metadata:
   installed-from: "incitaciones"
 disable-model-invocation: true
 ---
-# Moved: create-handoff
+> **Moved:** this entry is now the **create-handoff** mode of the **session** skill.
+> The full method is compiled below from `content/distilled/session/references/create-handoff/SKILL.md`.
+> Invoke via `/skill:create-handoff`, invoke `/skill:session` for the mode table,
+> or use this URL directly in a chat interface.
 
-This skill was consolidated into the **session** skill (router + references/ layout).
+#### Core Instructions (content/distilled/session/references/create-handoff/SKILL.md)
 
-Use `/create-handoff` no more: invoke `/skill:session` and follow its mode table — this task is the **create-handoff** mode, which reads `references/create-handoff/SKILL.md`.
+# Create Handoff Document
 
-This pointer exists so old invocations keep working; it will be removed in a future release. Update your notes and configs to `/skill:session`.
+Create a concise handoff document for another agent session.
+
+## Procedure
+
+1. Gather current repository metadata.
+2. Choose a handoff filename using `references/naming.md`.
+3. Write the document using `references/handoff-template.md`.
+4. Tell the user where the handoff was written and how to resume from it.
+
+## Rules
+
+- Be specific and include file references where they matter.
+- Capture decisions, learnings, and next steps, not just a task list.
+- Reference artifacts instead of copying large code blocks.
+
+---
+
+#### Reference: references/handoff-template.md
+
+```markdown
+---
+date: [ISO timestamp with timezone]
+git_commit: [short hash]
+branch: [branch name]
+directory: [working directory]
+issue: [issue-123 if applicable]
+status: handoff
+---
+
+# Handoff: [brief description]
+
+## Context
+
+[1-2 paragraph overview]
+
+## Current Status
+
+### Completed
+- [x] [Task with file references]
+
+### In Progress
+- [ ] [Task with current state]
+
+### Planned
+- [ ] [Next task]
+
+## Critical Files
+
+1. `path/to/file.ext:123` - [Why it matters]
+2. `path/to/file.ext:456` - [Why it matters]
+
+## Recent Changes
+
+- `path/to/file.ext:123` - [What changed]
+
+## Key Learnings
+
+1. [Learning]
+   - Evidence: [file reference or reasoning]
+
+## Open Questions
+
+- [ ] [Unresolved question]
+
+## Next Steps
+
+1. [Priority action]
+
+## Artifacts
+
+New files:
+- `path/to/new-file.ext`
+
+Modified files:
+- `path/to/modified-file.ext`
+
+## Related Links
+
+- [Relevant documentation, plan, or discussion]
+
+## Additional Context
+
+[Anything another session needs immediately]
+```
+
+---
+
+#### Reference: references/naming.md
+
+## Handoff Naming
+
+Create files at `handoffs/YYYY-MM-DD_HH-MM-SS_description.md`
+
+Examples:
+- `handoffs/2026-01-12_14-30-00_issue-123_add-oauth.md`
+- `handoffs/2026-01-12_14-30-00_refactor-auth-system.md`