@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/dist/templates/common/commands/continue.md

@@ -1,62 +1,60 @@
-# Continue Selected Task
-
-Resume work **only** when this live session already has a `selected_task`. If no task is selected, show the Task Dashboard and ask for an explicit route. Do not auto-resume a previous or unique task.
-
-This command is a Cursor `/` escape hatch. It does not implement the Session compiler and does not treat `workflow.md` or `get_context.py --mode phase` as runtime SSOT. Run CLI yourself; do not ask the user to type `python`. Do not open with a “loaded” probe. No selected task → answer directly.
-
----
-
-## Step 1: Load Kernel / Dashboard
-
-```bash
-{{PYTHON_CMD}} ./.pactile/scripts/get_context.py
-```
-
-Confirms: selected task, Kernel projection (Open / Define / Approve / Execute / Verify / Integrate? / Close), Task Dashboard, git state, recent commits.
-
-If a **compiled session pack** is already in context (SessionStart injected it), use that pack. If `./.pactile/scripts/compile_session_pack.py` exists, you MAY call it to refresh the pack. Do **not** implement or patch the compiler.
-
-Do **not** treat `{{PYTHON_CMD}} ./.pactile/scripts/get_context.py --mode phase` (Phase Index) as runtime SSOT. That extractor is a human overview of `workflow.md`, not Kernel truth.
-
-If the output says `Selected task: none`, stop. Show the dashboard and ask the user to choose one route:
-
-- select a task with `{{PYTHON_CMD}} ./.pactile/scripts/task.py select <task>`
-- create a task (Open Proposal first; no create without consent)
-- inspect details
-- continue without a task for read-only Q&A (Ask if the user is already there; otherwise Agent read-only)
-
-## Step 2: Search Session Memory
-
-**Skip this step** if Step 1 reported `Selected task: none`.
-
-When a task is selected, search past session memory so resume work can reuse journal context instead of re-asking the user:
-
-```bash
-{{PYTHON_CMD}} ./.pactile/scripts/search_memory.py --query "<task topic or title>" --json
-```
-
-Use the selected task's title or topic as the query. From the JSON results, summarize **1–3** most relevant hits for the user (title, summary, and next steps when present). Carry that context into the rest of the continue flow.
-
-## Step 3: Route by Kernel phase
-
-When a task is selected, route by Kernel / Dashboard human phase and persisted `required_controls.rigor` / `topology.kind`. `status` is a projection, not the sole truth. This command does not itself approve Execute.
-
-- **Open** → Intake / Open Proposal only; no product code
-- **Define** → Full: `SwitchMode(plan)` immediately; if the switch fails, one sentence (what happened, where `prd.md` landed) and keep writing artifacts. Lite may stay in Agent. Full follows `required_controls`, not mere file presence. Unlanded Plan is not Execute.
-- **Approve** → run `task.py start-execution <task> --check`, report PASS, ask for explicit Execute approval, then `task.py start-execution <task> --approved`. `--check` is not approval
-- **Execute** → implement under the approved contract in Agent. No product-code edits until this gate. Isolatable units: ask the user to open Multitask and hand worker packs; if they do not, `Task()` plus one sentence — do not block
-- **Verify** → map every AC to evidence in `verify.md`; Debug when runtime-stuck
-- **Integrate?** (parent-child / already integrating) → Parent `integrate-child` path (`merge_limit: 1`), serial, not ordinary Child closeout. `parent_id` alone does **not** make a Child a Parent
-- **Close** → wrap-up via `{{CMD_REF:finish-work}}` when the user is ready; `UpdateGoal` complete or cancel (failure does not block)
-
-Return-to-Define when scope, AC, execution contract, verification strategy, or capability assumptions change.
-
-If this Cursor Task API has no `pactile-implement` / `pactile-check` enum, dispatch workers as `generalPurpose`. Never label that run `true-independent`.
-
-Official `/goal` / CreateGoal is **not** a Pactile Task. Do not restore `pactile-goal`.
-
----
-
-## Reference
-
-Human overview: `.pactile/workflow.md` (not runtime SSOT). Native mode bindings: `.pactile/framework/cursor-native-modes-guide.md` (on-demand).
+# Continue Selected Task
+
+Resume work **only** when this live session already has a `selected_task`. If no task is selected, show the Task Dashboard and ask for an explicit route. Do not auto-resume a previous or unique task.
+
+This Skill does not implement the Session compiler and does not treat `workflow.md` or `pactile context --mode phase` as runtime SSOT. Run the available CLI yourself. Do not open with a “loaded” probe. No selected task → answer directly.
+
+---
+
+## Step 1: Load Kernel / Dashboard
+
+```bash
+pactile context
+```
+
+Confirms: selected task, Kernel projection (Open / Define / Approve / Execute / Verify / Integrate? / Close), Task Dashboard, git state, recent commits.
+
+If a **compiled session pack** is already in context, use that pack. Run `pactile context --mode session --json` to refresh it when needed. Do **not** implement or patch the compiler.
+
+Do **not** treat `pactile context --mode phase` (Phase Index) as runtime SSOT. That extractor is a human overview of `workflow.md`, not Kernel truth.
+
+If the output says `Selected task: none`, stop. Show the dashboard and ask the user to choose one route:
+
+- select a task with `pactile task select <task>`
+- create a task (Open Proposal first; no create without consent)
+- inspect details
+- continue without a task for read-only Q&A (Ask if the user is already there; otherwise Agent read-only)
+
+## Step 2: Search Session Memory
+
+**Skip this step** if Step 1 reported `Selected task: none`.
+
+When a task is selected, search past session memory so resume work can reuse journal context instead of re-asking the user:
+
+```bash
+pactile session search --query "<task topic or title>" --json
+```
+
+Use the selected task's title or topic as the query. From the JSON results, summarize **1–3** most relevant hits for the user (title, summary, and next steps when present). Carry that context into the rest of the continue flow.
+
+## Step 3: Route by Kernel phase
+
+When a task is selected, route by Kernel / Dashboard human phase and persisted `required_controls.rigor` / `topology.kind`. `status` is a projection, not the sole truth. This command does not itself approve Execute.
+
+- **Open** → Intake / Open Proposal only; no product code
+- **Define** → Full: `SwitchMode(plan)` immediately; if the switch fails, one sentence (what happened, where `prd.md` landed) and keep writing artifacts. Lite may stay in Agent. Full follows `required_controls`, not mere file presence. Unlanded Plan is not Execute.
+- **Approve** → run `pactile task start-execution <task> --check`, report PASS, ask for explicit Execute approval, then `pactile task start-execution <task> --approved`. `--check` is not approval
+- **Execute** → implement under the approved contract. No product-code edits until this gate. Pi worker dispatch uses `pactile pi run`; Codex desktop planning and review use `pactile codex` request/receipt records with native App tools
+- **Verify** → map every AC to evidence in `verify.md`; Debug when runtime-stuck
+- **Integrate?** (parent-child / already integrating) → Parent `integrate-child` path (`merge_limit: 1`), serial, not ordinary Child closeout. `parent_id` alone does **not** make a Child a Parent
+- **Close** → wrap-up via `{{CMD_REF:finish-work}}` when the user is ready; `UpdateGoal` complete or cancel (failure does not block)
+
+Return-to-Define when scope, AC, execution contract, verification strategy, or capability assumptions change.
+
+Official `/goal` / CreateGoal is **not** a Pactile Task. Do not restore `pactile-goal`.
+
+---
+
+## Reference
+
+Human overview: `.pactile/workflow.md` (not runtime SSOT). Codex worker boundary: `.pactile/framework/codex-worker-dispatch.md` (on demand).

package/dist/templates/common/commands/finish-work.md

@@ -1,82 +1,84 @@
-# Finish Work
-
-Wrap up the current session: archive the selected task (and any other completed-but-unarchived tasks the user wants to clean up) and record the session journal. Product-code commits are **not** done here — those belong to Close / Finalize (`vcs-integration`) **before** you invoke this command.
-
-Before archive, confirm `verify.md` includes a **Durable learning decision** (`update-spec` | `no-update` | `unsure`, or a grep-friendly `Durable learning decision:` / `no durable learning` line) and gate-compatible evidence per `.pactile/spec/guides/durable-learning-decision-guide.md`. Run `task.py archive <task> --check` when unsure.
-
-Human lifecycle names: Open / Define / Approve / Execute / Verify / Integrate? / Close. This command is the Close wrap-up hatch, not Execute. On Close, `UpdateGoal` complete or cancel plus one sentence; Goal failure does not block Close. Do not ask the user to type `python`.
-
-## Evidence pack reference (optional — graceful skip)
-
-When the selected task has `{TASK}/research/retrieval-pack-latest.json` (written by the research-end `stop` hook via `get_context --mode retrieval-pack`, or by an explicit pack run during Verify):
-
-1. Read the JSON; note top `contextPack.selected` items (`title`, `source`, `reference`, `score`) and `collection` counts.
-2. Ensure `verify.md` includes an `## Evidence pack reference` section citing those ranked sources or documenting explicit gaps.
-3. If the section is missing, add it before proceeding to archive.
-
-If the file does not exist: **skip silently** — no error, no user prompt. Pack absence is normal when the task did not use research/smart-search.
-
-Pack format: `version`, `source` (`retrieval-pack-orchestrator`), `contextPack.selected[]`, `scoredEvidence`, `collection`. Smart-search manifests that feed scoring live under `{TASK}/research/smart-search/<run-id>/` (from `run_smart_search.py`).
-
-## Step 1: Survey current state
-
-```bash
-{{PYTHON_CMD}} ./.pactile/scripts/get_context.py --mode record
-```
-
-This prints:
-
-- **My active tasks** — review whether any besides the selected one are actually done (code merged, AC met) and should be archived this round.
-- **Git status** — quick visual on what's dirty.
-- **Recent commits** — you'll need their hashes in Step 4 for `--commit`.
-
-If `--mode record` surfaces other completed tasks not tied to the current selection, surface them to the user with a one-shot confirmation: "These N tasks look done — archive them too in this round? [y/N]". Default is no; the selected task is always archived in Step 3 when one exists.
-
-## Step 2: Sanity check — classify dirty paths
-
-Run:
-
-```bash
-git status --porcelain
-```
-
-Filter out paths under `.pactile/workspace/` and `.pactile/tasks/` — those are managed by `add_session.py` and `task.py archive` auto-commits and will appear dirty as part of this skill's own work.
-
-For each remaining dirty path, decide whether it belongs to **the selected task** or to **other parallel work** (e.g., another terminal window editing the same repo). Heuristics:
-
-- Paths referenced in the selected task's `prd.md` / `implement.jsonl` / `check.jsonl` → selected task
-- Paths in code areas matching the selected task's stated scope, or that you remember editing this session → selected task
-- Paths in unrelated areas you have no recollection of touching this session → other parallel work
-
-Then route:
-
-- **Any remaining path looks like selected-task work** — bail out with:
-  > "Working tree has uncommitted code changes from this task: `<list>`. Return to Close / Finalize and commit them before running `{{CMD_REF:finish-work}}`."
-
-  Do NOT run `git commit` here. Do NOT prompt the user to commit. The user goes back to Close / Finalize and the AI drives the batched commit there.
-- **All remaining paths look unrelated** (other parallel-window work) — report them once and continue to Step 3:
-  > "FYI, dirty files outside this task's scope — leaving them for the other window: `<list>`."
-- **Genuinely unsure** — ask the user once: "Are `<list>` this task's work I forgot to commit, or another window's? (commit / ignore)" — then route per their answer.
-
-## Step 3: Archive task(s)
-
-```bash
-{{PYTHON_CMD}} ./.pactile/scripts/task.py archive <task-name>
-```
-
-At minimum: the selected task (if any). Plus any extra tasks the user confirmed in Step 1. Each archive produces a `chore(task): archive ...` commit via the script's auto-commit.
-
-If there is no selected task and the user did not confirm any cleanup archives, skip this step.
-
-## Step 4: Record session journal
-
-```bash
-{{PYTHON_CMD}} ./.pactile/scripts/add_session.py \
-  --title "Session Title" \
-  --commit "hash1,hash2" \
-  --summary "Brief summary"
-```
-
-Use the work-commit hashes produced in Close / Finalize (visible in Step 1's `Recent commits` list, or via `git log --oneline`) for `--commit`. Do not include the archive commit hashes from Step 3. This produces a `chore: record journal` commit.
-
-Final git log order: `<work commits from Close / Finalize>` → `chore(task): archive ...` (one or more) → `chore: record journal`.
+# Finish Work
+
+Wrap up the current session: archive the selected task (and any other completed-but-unarchived tasks the user wants to clean up) and record the session journal. Product-code commits are **not** done here — those belong to Close / Finalize (`vcs-integration`) **before** you invoke this command.
+
+Before archive, confirm `verify.md` includes a **Durable learning decision** (`update-spec` | `no-update` | `unsure`, or a grep-friendly `Durable learning decision:` / `no durable learning` line) and gate-compatible evidence per `.pactile/spec/guides/durable-learning-decision-guide.md`. Run `pactile task archive <task> --check` when unsure.
+
+Human lifecycle names: Open / Define / Approve / Execute / Verify / Integrate? / Close. This command is the Close wrap-up hatch, not Execute. On Close, `UpdateGoal` complete or cancel plus one sentence; Goal failure does not block Close. Do not ask the user to type `python`.
+
+## Evidence pack reference (optional — graceful skip)
+
+When the selected task already has `{TASK}/research/retrieval-pack-latest.json`:
+
+1. Read the JSON; note top `contextPack.selected` items (`title`, `source`, `reference`, `score`) and `collection` counts.
+2. Ensure `verify.md` includes an `## Evidence pack reference` section citing those ranked sources or documenting explicit gaps.
+3. If the section is missing, add it before proceeding to archive.
+
+If the file does not exist: **skip silently** — no error, no user prompt. Pack absence is normal when the task did not use research/smart-search.
+
+Pack format: `version`, `source` (`retrieval-pack-orchestrator`), `contextPack.selected[]`, `scoredEvidence`, `collection`. Smart Search manifests that feed scoring live under `{TASK}/research/smart-search/<run-id>/`.
+
+When research evidence has already been collected, generate or refresh the file with `pactile context --mode retrieval-pack --input <collected-evidence.json> --output {TASK}/research/retrieval-pack-latest.json --json`. Each input item needs `path` and `provider`; the Node quality layer scores, arbitrates, and budgets the collected items. It does not search, and its pack is never AC or Close evidence.
+
+## Step 1: Survey current state
+
+```bash
+pactile context --mode record
+```
+
+This prints:
+
+- **My active tasks** — review whether any besides the selected one are actually done (code merged, AC met) and should be archived this round.
+- **Git status** — quick visual on what's dirty.
+- **Recent commits** — you'll need their hashes in Step 4 for `--commit`.
+
+If `--mode record` surfaces other completed tasks not tied to the current selection, surface them to the user with a one-shot confirmation: "These N tasks look done — archive them too in this round? [y/N]". Default is no; the selected task is always archived in Step 3 when one exists.
+
+## Step 2: Sanity check — classify dirty paths
+
+Run:
+
+```bash
+git status --porcelain
+```
+
+Filter out paths under `.pactile/workspace/` and `.pactile/tasks/` — those are managed by `pactile session add` and `pactile task archive` auto-commits and will appear dirty as part of this skill's own work.
+
+For each remaining dirty path, decide whether it belongs to **the selected task** or to **other parallel work** (e.g., another terminal window editing the same repo). Heuristics:
+
+- Paths referenced in the selected task's `prd.md` / `implement.jsonl` / `check.jsonl` → selected task
+- Paths in code areas matching the selected task's stated scope, or that you remember editing this session → selected task
+- Paths in unrelated areas you have no recollection of touching this session → other parallel work
+
+Then route:
+
+- **Any remaining path looks like selected-task work** — bail out with:
+  > "Working tree has uncommitted code changes from this task: `<list>`. Return to Close / Finalize and commit them before running `{{CMD_REF:finish-work}}`."
+
+  Do NOT run `git commit` here. Do NOT prompt the user to commit. The user goes back to Close / Finalize and the AI drives the batched commit there.
+- **All remaining paths look unrelated** (other parallel-window work) — report them once and continue to Step 3:
+  > "FYI, dirty files outside this task's scope — leaving them for the other window: `<list>`."
+- **Genuinely unsure** — ask the user once: "Are `<list>` this task's work I forgot to commit, or another window's? (commit / ignore)" — then route per their answer.
+
+## Step 3: Archive task(s)
+
+```bash
+pactile task archive <task-name>
+```
+
+At minimum: the selected task (if any). Plus any extra tasks the user confirmed in Step 1. Each archive produces a `chore(task): archive ...` commit via the script's auto-commit.
+
+If there is no selected task and the user did not confirm any cleanup archives, skip this step.
+
+## Step 4: Record session journal
+
+```bash
+pactile session add \
+  --title "Session Title" \
+  --commit "hash1,hash2" \
+  --summary "Brief summary"
+```
+
+Use the work-commit hashes produced in Close / Finalize (visible in Step 1's `Recent commits` list, or via `git log --oneline`) for `--commit`. Do not include the archive commit hashes from Step 3. This produces a `chore: record journal` commit.
+
+Final git log order: `<work commits from Close / Finalize>` → `chore(task): archive ...` (one or more) → `chore: record journal`.

package/dist/templates/common/commands/start.md

@@ -1,66 +1,66 @@
-# Framework Start
-
-Enter or refresh the Pactile Framework Context. This is a dashboard entry surface; it must not select, resume, or start a task by itself.
-
-On **agent-capable Cursor** this command is **not** installed as a `/` slash (SessionStart + `/pactile-continue` cover entry). Keep this template for agent-less platforms only.
-
----
-
-## Step 1: Framework state
-Identity, git status, selected task, Kernel / Task Dashboard, journal location.
-
-```bash
-{{PYTHON_CMD}} ./.pactile/scripts/get_context.py
-```
-
-If this output includes a line beginning `Pactile update available:`, copy the full line verbatim when summarizing session context. Do not shorten operational command hints.
-
-If a compiled session pack is already in context, use it. Do **not** implement the Session compiler. Do **not** treat `get_context.py --mode phase` Phase Index as runtime SSOT.
-
-## Step 2: Guideline indexes
-Discover packages + spec layers, then read each relevant index file.
-
-```bash
-{{PYTHON_CMD}} ./.pactile/scripts/get_context.py --mode packages
-cat .pactile/spec/guides/index.md
-cat .pactile/spec/<package>/<layer>/index.md   # for each relevant layer
-```
-
-Index files list the specific guideline docs to read when you actually start coding. Human overview: `.pactile/workflow.md` (read on demand; not runtime SSOT).
-
-## Step 3: Decide next action
-From Step 1 you know whether a task is selected. Route by Kernel human phase (Open / Define / Approve / Execute / Verify / Integrate? / Close), not by Phase Index step ids.
-
-- If `Selected task: none` → show the Task Dashboard; do **not** load `pactile-continue`. For read-only Q&A, stay no-task (Ask if the user is already there).
-- If a task **is** selected and you need the next lifecycle step → use `pactile-continue` instead of repeating Steps 1–2 here.
-
-If `Selected task: none`, ask the user to choose: select a task, create a task, inspect details, or continue without a task.
-
-If a task is selected, check Kernel / Dashboard:
-
-- **Open / Define** → stay in definition until AC exists; prefer Plan for Define when useful
-- **Approve** → Execution gate (`task.py start-execution <task> --check`); `--check` is not approval
-- **Execute** → implement under contract
-- **Verify / Close** → evidence then wrap-up (`pactile-finish-work`)
-- **No selected task** → use dashboard routing. Do not auto-select an existing task
-
-Official `/goal` / CreateGoal is not a Pactile Task.
-
----
-
-## Skill routing (quick reference)
-
-Internal names below are **workflow routing**, not a `/` palette. On Cursor, user slash commands are only Continue / Finish-work / Handoff.
-
-| User intent | Route |
-|---|---|
-| Resume **selected** in-progress task | `pactile-continue` |
-| New feature / unclear requirements | Define / brainstorm discipline (on-demand) |
-| Small request, no task yet | no-task read-only or Open Proposal |
-| About to write code | Execute (after Execute gate) |
-| Done coding / quality check | Verify |
-| Session wrap-up after Close / Finalize commit | `pactile-finish-work` |
-| Stuck / fixed same bug multiple times | Debug → `verify.md`; break-loop when looped |
-| Learned something worth capturing | learning disposition in `verify.md` |
-
-Full human overview in `.pactile/workflow.md`. Native mode bindings: `.pactile/framework/cursor-native-modes-guide.md`.
+# Framework Start
+
+Enter or refresh the Pactile Framework Context. This is a dashboard entry surface; it must not select, resume, or start a task by itself.
+
+This entry is available as a Codex Skill. It does not dispatch another task.
+
+---
+
+## Step 1: Framework state
+Identity, git status, selected task, Kernel / Task Dashboard, journal location.
+
+```bash
+pactile context
+```
+
+If this output includes a line beginning `Pactile update available:`, copy the full line verbatim when summarizing session context. Do not shorten operational command hints.
+
+If a compiled session pack is already in context, use it. Do **not** implement the Session compiler. Do **not** treat `pactile context --mode phase` Phase Index as runtime SSOT.
+
+## Step 2: Guideline indexes
+Discover packages + spec layers, then read each relevant index file.
+
+```bash
+pactile context --mode packages
+cat .pactile/spec/guides/index.md
+cat .pactile/spec/<package>/<layer>/index.md   # for each relevant layer
+```
+
+Index files list the specific guideline docs to read when you actually start coding. Human overview: `.pactile/workflow.md` (read on demand; not runtime SSOT).
+
+## Step 3: Decide next action
+From Step 1 you know whether a task is selected. Route by Kernel human phase (Open / Define / Approve / Execute / Verify / Integrate? / Close), not by Phase Index step ids.
+
+- If `Selected task: none` → show the Task Dashboard; do **not** load `pactile-continue`. For read-only Q&A, stay no-task (Ask if the user is already there).
+- If a task **is** selected and you need the next lifecycle step → use `pactile-continue` instead of repeating Steps 1–2 here.
+
+If `Selected task: none`, ask the user to choose: select a task, create a task, inspect details, or continue without a task.
+
+If a task is selected, check Kernel / Dashboard:
+
+- **Open / Define** → stay in definition until AC exists; prefer Plan for Define when useful
+- **Approve** → Execution gate (`pactile task start-execution <task> --check`); `--check` is not approval
+- **Execute** → implement under contract
+- **Verify / Close** → evidence then wrap-up (`pactile-finish-work`)
+- **No selected task** → use dashboard routing. Do not auto-select an existing task
+
+Official `/goal` / CreateGoal is not a Pactile Task.
+
+---
+
+## Skill routing (quick reference)
+
+Internal names below are workflow routing, not a host command palette.
+
+| User intent | Route |
+|---|---|
+| Resume **selected** in-progress task | `pactile-continue` |
+| New feature / unclear requirements | Define / brainstorm discipline (on-demand) |
+| Small request, no task yet | no-task read-only or Open Proposal |
+| About to write code | Execute (after Execute gate) |
+| Done coding / quality check | Verify |
+| Session wrap-up after Close / Finalize commit | `pactile-finish-work` |
+| Stuck / fixed same bug multiple times | Debug → `verify.md`; break-loop when looped |
+| Learned something worth capturing | learning disposition in `verify.md` |
+
+Full human overview in `.pactile/workflow.md`. Codex worker boundary: `.pactile/framework/codex-worker-dispatch.md`.

package/dist/templates/common/index.d.ts

@@ -28,17 +28,6 @@ export interface CommonBundledSkill {
     /** Files that must be written under the skill directory */
     files: CommonBundledSkillFile[];
 }
-/**
- * Optional/experimental skill — same shape as bundled skills, but lives under
- * `optional-skills/` which `getBundledSkillTemplates()` does NOT scan.
- * Installed only via `pactile init --with-optional <name>` (default off).
- */
-export interface CommonOptionalSkill {
-    /** Skill directory name, e.g. "chrome-cdp" */
-    name: string;
-    /** Files that must be written under the skill directory */
-    files: CommonBundledSkillFile[];
-}
 /**
  * Get all command templates (stay as slash commands on all platforms).
  * Results are cached after first call.
@@ -56,13 +45,4 @@ export declare function getSkillTemplates(): CommonTemplate[];
  * lazy-loadable instead of being flattened into one oversized SKILL.md.
  */
 export declare function getBundledSkillTemplates(): CommonBundledSkill[];
-/**
- * Get all optional/experimental skills (e.g. `optional-skills/chrome-cdp/`).
- *
- * Deliberately separate from {@link getBundledSkillTemplates}: `optional-skills/`
- * is NOT scanned by the bundled pipeline, so default `pactile init` never installs
- * these. They are installed only through `pactile init --with-optional <name>`.
- * Results are cached after first call.
- */
-export declare function getOptionalSkillTemplates(): CommonOptionalSkill[];
 //# sourceMappingURL=index.d.ts.map

package/dist/templates/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuBH,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,sBAAsB,EAAE,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,sBAAsB,EAAE,CAAC;CACjC;AAQD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAMtD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,EAAE,CAMpD;AA2CD;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,EAAE,CAM/D;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,IAAI,mBAAmB,EAAE,CAMjE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuBH,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,sBAAsB,EAAE,CAAC;CACjC;AAOD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,EAAE,CAMtD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,EAAE,CAMpD;AA2CD;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,kBAAkB,EAAE,CAM/D"}

package/dist/templates/common/index.js

@@ -32,7 +32,6 @@ function listMarkdownFiles(dir) {
 let cachedCommands;
 let cachedSkills;
 let cachedBundledSkills;
-let cachedOptionalSkills;
 /**
  * Get all command templates (stay as slash commands on all platforms).
  * Results are cached after first call.
@@ -105,19 +104,4 @@ export function getBundledSkillTemplates() {
     }));
     return cachedBundledSkills;
 }
-/**
- * Get all optional/experimental skills (e.g. `optional-skills/chrome-cdp/`).
- *
- * Deliberately separate from {@link getBundledSkillTemplates}: `optional-skills/`
- * is NOT scanned by the bundled pipeline, so default `pactile init` never installs
- * these. They are installed only through `pactile init --with-optional <name>`.
- * Results are cached after first call.
- */
-export function getOptionalSkillTemplates() {
-    cachedOptionalSkills ??= listDirectories("optional-skills").map((name) => ({
-        name,
-        files: listSkillFiles("optional-skills", name),
-    }));
-    return cachedOptionalSkills;
-}
 //# sourceMappingURL=index.js.map

package/dist/templates/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/common/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/common/index.ts"],"names":[],"mappings":"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"}

package/dist/templates/common/skills/before-dev.md

@@ -1,35 +1,35 @@
-Read the relevant development guidelines before starting your task.
-
-Execute these steps:
-
-1. **Read selected task artifacts**:
-   - `prd.md` for requirements and acceptance criteria
-   - `design.md` if present for technical design
-   - `implement.md` if present for execution order and validation plan
-
-2. **Discover packages and their spec layers**:
-   ```bash
-   python3 ./.pactile/scripts/get_context.py --mode packages
-   ```
-
-3. **Identify which specs apply** to your task based on:
-   - Which package you're modifying (e.g., `cli/`, `docs-site/`)
-   - What type of work (backend, frontend, unit-test, docs, etc.)
-   - Any spec/research paths referenced by the task artifacts
-
-4. **Read the spec index** for each relevant module:
-   ```bash
-   cat .pactile/spec/<package>/<layer>/index.md
-   ```
-   Follow the **"Pre-Development Checklist"** section in the index.
-
-5. **Read the specific guideline files** listed in the Pre-Development Checklist that are relevant to your task. The index is NOT the goal — it points you to the actual guideline files (e.g., `error-handling.md`, `conventions.md`, `mock-strategies.md`). Read those files to understand the coding standards and patterns.
-
-6. **Always read shared guides**:
-   ```bash
-   cat .pactile/spec/guides/index.md
-   ```
-
-7. Understand the coding standards and patterns you need to follow, then proceed with your development plan.
-
-This step is **mandatory** before writing any code.
+Read the relevant development guidelines before starting your task.
+
+Execute these steps:
+
+1. **Read selected task artifacts**:
+   - `prd.md` for requirements and acceptance criteria
+   - `design.md` if present for technical design
+   - `implement.md` if present for execution order and validation plan
+
+2. **Discover packages and their spec layers**:
+   ```bash
+   pactile context --mode packages
+   ```
+
+3. **Identify which specs apply** to your task based on:
+   - Which package you're modifying (e.g., `cli/`, `docs-site/`)
+   - What type of work (backend, frontend, unit-test, docs, etc.)
+   - Any spec/research paths referenced by the task artifacts
+
+4. **Read the spec index** for each relevant module:
+   ```bash
+   cat .pactile/spec/<package>/<layer>/index.md
+   ```
+   Follow the **"Pre-Development Checklist"** section in the index.
+
+5. **Read the specific guideline files** listed in the Pre-Development Checklist that are relevant to your task. The index is NOT the goal — it points you to the actual guideline files (e.g., `error-handling.md`, `conventions.md`, `mock-strategies.md`). Read those files to understand the coding standards and patterns.
+
+6. **Always read shared guides**:
+   ```bash
+   cat .pactile/spec/guides/index.md
+   ```
+
+7. Understand the coding standards and patterns you need to follow, then proceed with your development plan.
+
+This step is **mandatory** before writing any code.