arcane-cli 0.32.4 → 0.33.0

package/dist/assets/.claude/commands/spell-check-drift.md

@@ -2,7 +2,7 @@
 description: Use PROACTIVELY to detect contradictions and stale statements across core docs, periodically or after major changes.
 ---
 
-# Check Drift
+# Check Doc Drift
 
 Invoke the Arcane `spell-check-drift` spell workflow.
 

package/dist/assets/.claude/commands/spell-dotnet-expert.md

@@ -2,7 +2,7 @@
 description: Use PROACTIVELY when working on a .NET project and best-practice guidance is needed.
 ---
 
-# Dotnet Expert
+# .NET Expert
 
 Invoke the Arcane `spell-dotnet-expert` spell workflow.
 

package/dist/assets/.github/prompts/_fragments/tracking-mode-declaration.md

@@ -0,0 +1,2 @@
+- `tracking_mode: internal | external`
+- `external_provider: ado | github | jira | other`

package/dist/assets/.github/prompts/spell-address-review.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Address Review
 description: Respond to code-review feedback on a pull request — fetch comment threads, triage each, implement fixes or reply with rationale, and resolve every thread.
+claude_description: Use PROACTIVELY whenever responding to PR review comments — fetch threads, triage, fix or reply, resolve.
 argument-hint: --pr <number> (required) [--fix-all] — the PR to address; --fix-all treats all suggestions/nitpicks as fix-now
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-adopt-docs.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Adopt Docs
 description: Bring an existing document tree under Arcane governance without moving anything first — inventory, propose a mapping, get approval, then apply in reversible steps. Dry-run by default.
+claude_description: Use PROACTIVELY when bringing an existing, ungoverned doc tree under Arcane governance.
 argument-hint: Optional path to the tree to adopt (defaults to the repository root). Add `--apply` only after reviewing a dry run.
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-arcane-version.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Arcane Version
 description: Report the version of Arcane installed in this repository, the active profile, installed components, and whether an update is available.
+claude_description: Use PROACTIVELY when asked about the installed Arcane version, profile, or whether an update is available.
 argument-hint: Optional flag — pass "components" to list all installed components in full detail
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-architect.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Architect
 description: Generate architecture decisions and story breakdown from a PRD, producing architecture.md and stories.json
+claude_description: Use PROACTIVELY once a PRD exists and needs architecture decisions and a story breakdown before implementation starts.
 argument-hint: Path to PRD.md or paste the PRD content
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-brainstorm.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Brainstorm
 description: Divergent ideation — explore multiple solutions to a problem space before committing to a plan
+claude_description: Use PROACTIVELY when exploring multiple solutions to a problem before committing to one.
 argument-hint: "Problem space or opportunity (e.g., 'How should we handle multi-tenant billing?')"
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-bug.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Bug
 description: Document, diagnose, and fix a bug — files a tracker work item (per tracking_mode), traces root cause, implements fix, verifies, and commits
+claude_description: Use PROACTIVELY whenever diagnosing and fixing a bug, even if the user just describes broken behavior.
 argument-hint: Bug description (e.g., "Session detail dialog shows 404 when clicking a mock session")
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-bump.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Bump Version
 description: Determine the correct semver bump type for the current change and apply it to package.json
+claude_description: Use PROACTIVELY before shipping any change that touches distributable content, to determine and apply the correct version bump.
 argument-hint: Optional context about the change (e.g., "new component", "bug fix", "breaking API change")
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-check-drift.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Check Doc Drift
 description: Detect contradictions and stale statements across core Arcane docs and report severity-graded findings (report-only by default; opt-in --fix applies safe mechanical fixes).
+claude_description: Use PROACTIVELY to detect contradictions and stale statements across core docs, periodically or after major changes.
 argument-hint: Optional scope selector --scope all|journal|todos|decisions|git (default all); free-text hints also accepted. Add --fix to apply safe mechanical fixes.
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-close-session.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Close Session
 description: End a work session by logging outcomes in today's journal and pruning completed TODO items with verifiable evidence.
+claude_description: Use PROACTIVELY at the end of any significant work session, even if the user just says 'wrap up' or 'done for now'.
 argument-hint: Optional session focus (e.g., a config change, a fix, infrastructure setup)
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-commit-work.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Commit Work
 description: Generate Conventional Commits message with agent attribution and commit current work during an active session
+claude_description: Use PROACTIVELY whenever committing work during a session, even if the user just says 'commit this'.
 argument-hint: Optional focus (e.g., security, prompts, agents, infrastructure)
 agent: agent
 last_updated: 2026-07-05

package/dist/assets/.github/prompts/spell-compliance.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Compliance
 description: Run a regulatory compliance self-assessment against this repo (GDPR, CCPA, SOC 2, HIPAA) and produce a prioritized remediation checklist. Read-only — never drafts policies or fixes gaps automatically.
+claude_description: Use PROACTIVELY before a launch, an enterprise sales cycle, or a security questionnaire that raises GDPR/CCPA/SOC 2/HIPAA questions.
 argument-hint: Optional focus (e.g., "GDPR only", "pre-launch check", "SOC 2 readiness")
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-create-pull-request.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Create Pull Request
 description: Open a pull request for the current branch with an auto-generated title and description from commit history. Provider-agnostic (GitHub or Azure DevOps).
+claude_description: Use PROACTIVELY whenever opening a pull request for the current branch, even if the user just says 'open a PR'.
 argument-hint: '[--draft] [--reviewers <name,...>] [--target <branch>] [--docs-only]'
 agent: agent
 last_updated: 2026-07-05

package/dist/assets/.github/prompts/spell-document.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Document
 description: Formalize valuable insights, analysis, or decisions from the current conversation into polished, permanent reference documents.
+claude_description: Use PROACTIVELY when conversation content (an analysis, a decision, an investigation) should become a permanent reference doc.
 argument-hint: Topics and output paths (e.g., "capability inventory → docs/capabilities.md")
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-dotnet-expert.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — .NET Expert
 description: Load .NET best practices and patterns for any development agent working on .NET projects
+claude_description: Use PROACTIVELY when working on a .NET project and best-practice guidance is needed.
 argument-hint: Specific .NET topic or question (e.g., "Azure Functions isolated worker", "EF Core migrations")
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-eas-store-deploy.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — EAS Store Deploy
 description: Deploy an Expo app to the Apple App Store and Google Play via EAS Build + EAS Submit — one-time setup, repeat deployments, and the known pitfalls hit dogfooding both flows for real.
+claude_description: Use PROACTIVELY when deploying an Expo app to the App Store or Google Play via EAS.
 argument-hint: Which store(s) to deploy to (ios, android, or both) and whether this is initial setup or a repeat deployment
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-enchant.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Enchant
 description: "Enchant a PRD from functional to exceptional — proactively enhance features, UX, accessibility, security, and performance using a research lens and a marketing/brand lens"
+claude_description: Use PROACTIVELY when a PRD should be enhanced — UX, accessibility, security, performance — before implementation.
 argument-hint: "Path to PRD, pasted PRD content, or tracker work item ID (e.g., 'Enchant PRD.md for {BUSINESS_NAME} <feature> dashboard')"
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-explain-concept.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Explain Concept
 description: "Explain a technical concept, architecture, or system behavior in a balanced way: enough technical depth to be accurate, enough plain language to be accessible. Use when: confused about how something works, need to understand a system before making decisions, want a 'teach me' breakdown."
+claude_description: Use PROACTIVELY when the user needs a concept, architecture, or system behavior explained before deciding or building.
 argument-hint: "Concept or question to explain (e.g., 'how does our auth middleware inject tokens?', 'what is OAuth2 PKCE flow?', 'why can't {AGENT_NAME} see the config?')"
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-feedback.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Feedback
 description: Collect structured feedback on AI-assistance quality and workflow friction, and append it to FEEDBACK.md for continuous improvement. Framework-shaped items can route upstream to arcane's public GitHub issues.
+claude_description: Use PROACTIVELY when the user reports friction with AI assistance or the workflow itself, not the product being built.
 argument-hint: Optional focus area — e.g., "spell-implement loop", "review quality", "session handoff". Use `--flush` instead to re-offer any previously queued upstream items.
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-full-cycle.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Full Cycle
 description: End-to-end autonomous Spell Loop — chains plan, architect, implement, test, review, and ship into a single invocation with one human approval gate at merge time
+claude_description: Use PROACTIVELY for an end-to-end feature request that should chain plan, architect, implement, test, review, and ship.
 argument-hint: "Feature description, optional work item ID, target repo (e.g., 'Add user auth to the mobile app, #507, {REPO_ORG}/{REPO_NAME}')"
 agent: agent
 ---
@@ -38,8 +39,11 @@ Before proceeding, confirm you have all three:
    - Path to a PRD file (e.g., `PRD.md`)
    - **Tracker work item ID** (e.g., `#507`) in `external` mode — fetch it using the detected provider's CLI/API. For an ADO provider, fetch via `az boards work-item show --id {id} --org https://dev.azure.com/{ADO_ORG} --output json` and extract `System.Title`, `System.Description`, and `Microsoft.VSTS.Common.AcceptanceCriteria`; for other providers, fetch the title, description, and acceptance criteria via that provider's equivalent. If the work item has child items, fetch those too. `{ADO_ORG}` resolves from `.arcane.json` or the PRD/feature frontmatter; ask if unset.
 2. **Tracking configuration** — required before execution:
+   <!-- fragment:tracking-mode-declaration:start -->
    - `tracking_mode: internal | external`
-   - `external_provider: ado | github | jira | other` (required when `tracking_mode=external`)
+   - `external_provider: ado | github | jira | other`
+   <!-- fragment:tracking-mode-declaration:end -->
+   - (`external_provider` is required when `tracking_mode=external`)
    - If omitted and an ADO context is already present, default to `external` + `ado` (backward compatibility).
    - If `tracking_mode=external` and `external_provider=ado`, an `adoWorkItemId` is required for commit/PR linkage.
    - If `tracking_mode=external` and `external_provider=github`, a `githubIssueId` is used for commit/PR linkage when one exists (optional, unlike ADO).

package/dist/assets/.github/prompts/spell-generate-bot-icons.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Generate Bot Icons
 description: Generate a bot avatar concept with an image-capable agent, then normalize it into Teams-ready color and outline icons.
+claude_description: Use PROACTIVELY when a bot/agent needs a Teams-ready avatar and icon set generated.
 argument-hint: Bot concept (e.g., "{AGENT_NAME} for ecommerce ops, powerful + modern, flat vector")
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-implement.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Implement
 description: Autonomous implementation loop — pick a story from stories.json, build it, test it, commit it, repeat until all stories pass
+claude_description: Use PROACTIVELY to work through stories.json autonomously once architecture and stories exist.
 argument-hint: Path to stories.json or paste story context (optional - uses current directory stories.json by default)
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-make-discoverable.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Make Discoverable
 description: Audit and fix a web property's search and AI-assistant discoverability — per-route share metadata, robots and sitemap policy, non-production noindexing, and search-engine registration. Read-only by default.
+claude_description: Use PROACTIVELY when auditing a web property's search/AI-assistant discoverability (metadata, robots, sitemap, indexing).
 argument-hint: Optional path or origin of the property to audit (defaults to the repository root). Add --apply only after reviewing a dry run.
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-manifest.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Manifest
 description: Hub-gated interactive triage that promotes idea-book and todo-book entries downstream — to a consumer repo, a PRD scaffold, a tracker item, public disclosure, or another venture's book.
+claude_description: Use PROACTIVELY in a hub repo to triage idea-book/todo-book entries downstream.
 argument-hint: Optional --venture <slug> to restrict triage to one venture's books
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-open-session.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Open Session
 description: Open an Arcane session in a new chat by rebuilding context, identifying highest-priority unfinished work, and proposing concrete next actions.
+claude_description: Use PROACTIVELY at the start of any new session, even if the user just says 'let's start' or asks 'what's next'.
 argument-hint: Optional focus area (e.g., security hardening, a specific feature, infrastructure setup)
 agent: agent
 ---
@@ -85,8 +86,10 @@ Before anything else, check:
   - If an active PR uses the old branch name, do not force-delete the old remote branch; flag it and continue with a follow-up rename plan.
 - **Stale local branches:** Run `git branch --merged main` to list branches already merged that should be deleted — this session's own read-only candidate list (`--merged` also misses every branch landed via this repo's sanctioned rebase-and-fast-forward, so treat a *clean* result as "no ancestry-visible candidates," not "nothing to check"). Open-session only lists; it does not delete. Apply the [Content-Verified Branch Deletion](../../.arcane/governance/git-conventions.md#content-verified-branch-deletion-todomd-merged-branch-cleanup-finding) procedure (git-conventions.md) to any candidate before flagging it as safe, and leave the actual idempotent prune to `spell-close-session`'s sweep.
 - **Tracker configuration check (early):** resolve active tracking settings before planning, in this order: root `.arcane.json` (if present) -> the committed self-hosted source manifest (`src/assets/.arcane.json`, read only when it declares `selfHosted: true` -- this is EF-14's recorded self-hosting resolution tier, distinct from treating the mere presence of a self-host marker as license to infer other, unrelated config) -> the current feature PRD frontmatter -> ask. Persisted once at `spell init`/`spell update` (EF-14); do not re-ask when any of the first three sources already sets it.
+  <!-- fragment:tracking-mode-declaration:start -->
   - `tracking_mode: internal | external`
   - `external_provider: ado | github | jira | other`
+  <!-- fragment:tracking-mode-declaration:end -->
   - If all three sources are absent, ask: "Track work in this repo (TODO.md / PRDs)" [internal] vs "Track work in an external tracker (Azure DevOps / GitHub / Jira / other)" [external]. Default to `external` + `ado` only when existing ADO context already exists (backward compatibility).
 - **Open PRs (external/ado mode only):** if tracking mode is `external` with provider `ado` and ADO MCP is available, list all open PRs across all repos in the configured repo list (resolve from `.arcane.json`; if unset, ask the operator which repos to scan). Flag PRs older than 3 days as stale, older than 7 days as overdue. Format each as a clickable markdown link: `[PR #{id} — {title}](https://dev.azure.com/{ADO_ORG}/{ADO_PROJECT}/_git/{repo}/pullrequest/{id})` — resolve `{ADO_ORG}` and `{ADO_PROJECT}` from `.arcane.json` / PRD frontmatter; ask if unset. Never list a bare `PR #NNN`.
 - **Uncommitted changes:** Run `git status` and report any uncommitted files.

package/dist/assets/.github/prompts/spell-plan.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Plan
 description: Generate a Product Requirements Document (PRD) from a feature description using structured planning
+claude_description: Use PROACTIVELY when a feature description needs to become a PRD before architecture or implementation.
 argument-hint: Feature or initiative to plan (e.g., "user authentication for a mobile app")
 agent: agent
 ---
@@ -26,10 +27,10 @@ Workflow:
 
 1. **Configure tracking mode first** — decide how this work will be tracked before requirement intake:
 
-   ```yaml
-   tracking_mode: internal | external
-   external_provider: ado | github | jira | other
-   ```
+   <!-- fragment:tracking-mode-declaration:start -->
+   - `tracking_mode: internal | external`
+   - `external_provider: ado | github | jira | other`
+   <!-- fragment:tracking-mode-declaration:end -->
 
    Resolve in this order, matching spell-open-session's own resolution chain (EF-14): root
    `.arcane.json` (if present) → the committed self-hosted source manifest (`src/assets/.arcane.json`,

package/dist/assets/.github/prompts/spell-present-arcane.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Present Arcane
 description: Present Arcane in one of three modes — a full 1-hour talk (default), a live-state executive summary document, or a deck-builder meta-prompt sized to a slide count or duration.
+claude_description: Use PROACTIVELY when asked to present, demo, or explain Arcane itself to an audience.
 argument-hint: '[summary|deck] + optional audience/size — e.g., "for investors", "summary exec", "deck 10m", "deck 20 slides"'
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-product-review.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Product Review
 description: Build/Measure/Analyze/Decide cycle — evaluate feature performance and recommend next actions
+claude_description: Use PROACTIVELY when evaluating a shipped feature's real-world performance and deciding next actions.
 argument-hint: Feature or product area to review (e.g., "{BUSINESS_NAME} storefront performance", "{BUSINESS_NAME} beta feedback")
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-review-batch.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Review Batch
 description: Adversarially review many pull requests in one run and emit per-PR verdicts plus a consolidated go/no-go readiness gate report. Provider-agnostic.
+claude_description: Use PROACTIVELY when multiple open PRs need an adversarial review pass and a consolidated go/no-go verdict.
 argument-hint: '--prs <n,n,…> | --pr <n> | --file <path> | --query <q>  [--repos <r,…>] [--html] [--title <t>]'
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-review.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Review
 description: Adversarial code review — must find issues, validate architecture compliance, and check security
+claude_description: Use PROACTIVELY before merging any nontrivial change, even if the user doesn't explicitly ask for review.
 argument-hint: PR number, branch name, or file paths to review
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-save-idea.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Save Idea
 description: Quickly capture a fleeting idea into the repo's idea inbox so it is not lost. Low ceremony, no approval gate, optimized for voice and speed. In a hub repo, optionally target a venture's own idea book.
+claude_description: Use PROACTIVELY to capture a fleeting idea immediately, even if the user just says 'note that' or 'don't forget'.
 argument-hint: The idea itself — a sentence to a couple of paragraphs (e.g., "add a dark-mode toggle to the settings page"), optionally "for <venture>" (hub only, e.g. "save this idea for ordo — …")
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-scope.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Scope
 description: Analyze a large PRD — scope it, split into epics, check architecture and security implications, estimate effort, and produce an execution plan with agent assignments
+claude_description: Use PROACTIVELY when a PRD is too large for one Spell Loop cycle and needs epic-splitting before architecture.
 argument-hint: "Path to PRD or paste PRD content (e.g., 'Analyze PRD.md for {BUSINESS_NAME} mobile app')"
 agent: agent
 ---
@@ -53,8 +54,10 @@ If the input is an external work item ID:
 4. Combine all content into a single PRD view before proceeding.
 
 Resolve tracking settings from PRD frontmatter (preferred) or ask:
+<!-- fragment:tracking-mode-declaration:start -->
 - `tracking_mode: internal | external`
 - `external_provider: ado | github | jira | other`
+<!-- fragment:tracking-mode-declaration:end -->
 
 If unset and ADO context already exists, default to `external` + `ado` for backward compatibility.
 

package/dist/assets/.github/prompts/spell-scry.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Scry
 description: Clear a candidate name before it ships — four outward checks (who coined it, estate still trading, same-audience giants, first-association salience) plus a mandatory inward repo-local collision pass. Use when naming anything new (a spell, a field, a product, an internal concept) before committing to it.
+claude_description: Use PROACTIVELY when naming anything new (a spell, a field, a product, an internal concept) before committing to it — clears a candidate name against both the outside world and this repository itself.
 argument-hint: '<candidate name or term>'
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-security-review.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Security Review
 description: OWASP Top 10 and AI/agent (LLM) security audit plus dependency vulnerability check for any project
+claude_description: Use PROACTIVELY before shipping any change that introduces new attack surface, handles sensitive data, or changes trust boundaries.
 argument-hint: Project path, PR, or specific security concern (e.g., "auth flow in the API")
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-ship.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Ship
 description: Pre-deploy checklist, merge approval workflow, and deployment gate verification
+claude_description: Use PROACTIVELY before any deploy, even if the user just says 'ship it'.
 argument-hint: Branch name or PR number to ship
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-status.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Status
 description: Show a fast, read-only snapshot of the current session — branch, git working state, open TODO count, decision count, and last journal date. Text or JSON.
+claude_description: Use PROACTIVELY when asked for a quick snapshot of session/repo state — branch, TODOs, decisions, last journal.
 argument-hint: Optional flags — e.g., --verbose --format json
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-suggest-feature.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Suggest Feature
 description: Capture a feature suggestion from smoke testing or usage — assesses impact, files a tracker item (provider-aware), and adds to backlog
+claude_description: Use PROACTIVELY when smoke testing or usage surfaces a feature gap worth tracking.
 argument-hint: Feature idea (e.g., "Settings page to change instance name and gateway URL")
 agent: agent
 ---
@@ -54,8 +55,11 @@ Workflow:
 4. **Resolve tracking mode** — before creating a tracker item:
    - Read `tracking_mode` / `external_provider` from `.arcane.json` or the active PRD frontmatter if available.
    - If missing, ask the user:
+     <!-- fragment:tracking-mode-declaration:start -->
      - `tracking_mode: internal | external`
-     - `external_provider: ado | github | jira | other` (required only for external mode)
+     - `external_provider: ado | github | jira | other`
+     <!-- fragment:tracking-mode-declaration:end -->
+     - (`external_provider` is required only for external mode)
    - If ADO context is already active and no explicit choice is provided, default to `external` + `ado` for backward compatibility.
 
 5. **Create tracker item (conditional)**:

package/dist/assets/.github/prompts/spell-summon-venture.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Summon Venture
 description: Create a new venture in a hub repo — folder, overview/config/legal docs, idea and todo books, and a registry entry — in one hub-gated move.
+claude_description: Use PROACTIVELY in a hub repo when creating a new venture from scratch.
 argument-hint: Venture Name | Venture Type | One-line description
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-sync-pull-request.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Sync Pull Request
 description: Safely sync an open PR's branch with its target when it has fallen behind — recoverable pre-rebase ref, mechanical-vs-ambiguous conflict handling, force-with-lease push, provider-verified landing. Use when a PR needs rebasing onto a moved target, or was routed here from spell-create-pull-request/spell-ship's own conflict-stop points.
+claude_description: Use PROACTIVELY whenever an open PR has fallen behind its target branch and needs a safe rebase/sync, or when spell-create-pull-request/spell-ship stop on a conflict they route here.
 argument-hint: '[PR number or branch name]'
 agent: agent
 last_updated: 2026-08-31

package/dist/assets/.github/prompts/spell-test.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Test
 description: Run tests, validate coverage thresholds, and generate test evidence for a completed story or feature
+claude_description: Use PROACTIVELY to validate a completed story or feature against coverage thresholds before marking it done.
 argument-hint: Story ID or test scope (e.g., "STORY-003" or "all")
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-todo.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Todo
 description: Elaborate a raw idea into one or more well-scoped TODO items and place them in the right document(s). In a hub repo, optionally target a venture's own TODO book, or sweep every book's open-item counts.
+claude_description: Use PROACTIVELY whenever a raw idea needs to become one or more well-scoped TODO items, even if the user just says 'add a todo'.
 argument-hint: The raw idea to elaborate (e.g., "add spending limits doc", "automate ADR numbering", "build a dashboard for {AGENT_NAME}"), optionally "for <venture>" (hub only). `{AGENT_NAME}` resolves from `.arcane.json` / frontmatter; ask if unset. Use `--sweep` instead to report open-item counts across every book.
 agent: agent
 ---

package/dist/assets/.github/prompts/spell-verification-ledger.prompt.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Verification Ledger
 description: Extract a structured record of claims that were checked this session and what the check showed — especially the ones that didn't survive. Separate from spell-close-session; run on demand, not every session.
+claude_description: Use PROACTIVELY when a session had real verification events worth a structured record — especially a claim that didn't survive a check.
 argument-hint: Optional focus (e.g., "just the corrections", "since the last commit")
 agent: agent
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-cli",
-  "version": "0.32.4",
+  "version": "0.33.0",
   "description": "Arcane framework CLI — scaffold and manage governance files in consuming repositories",
   "keywords": [
     "arcane",