arcane-cli 1.12.3 → 1.13.0

package/README.md

@@ -174,7 +174,7 @@ Every line says how it holds, because a rule nobody checks should not read like
 
 **What it does not do.**
 - It does not run your agents or call an AI model. The spells are instructions your AI client follows; the CLI installs them, keeps them current and checks the repository.
-- It does not intercept raw git. A commit you type by hand skips the spells' approval and test gates.
+- It does not intercept raw git. A commit you type by hand skips the spells' approval and test gates; any hook it installed still runs.
 - The credential scan looks for known patterns: it can find a leak, never prove a commit is clean.
 - The push controls stop an accidental push, not a determined operator.
 

package/dist/assets/.arcane/governance/agent-approved-paths.md

@@ -1,5 +1,6 @@
 ---
 title: Agent Approved Paths Registry
+tagline: The registry of paths agents may touch
 audience: both
 last_updated: YYYY-MM-DD
 status: template

package/dist/assets/.arcane/governance/agent-policies.md

@@ -1,5 +1,6 @@
 ---
 title: Agent Policies
+tagline: What agents may do — and must never do
 audience: both
 status: active
 distributable: true

package/dist/assets/.arcane/governance/agent-work-queue-model.md

@@ -1,5 +1,6 @@
 ---
 title: Agent Work Queue Model
+tagline: How agents pick up, hand off, and finish work
 audience: both
 last_updated: YYYY-MM-DD
 status: draft

package/dist/assets/.arcane/governance/authentication-strategy.md

@@ -1,5 +1,6 @@
 ---
 title: Authentication Strategy
+tagline: How identity and access work, end to end
 audience: both
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/governance/cicd-standards.md

@@ -1,5 +1,6 @@
 ---
 title: CI/CD Standards
+tagline: Build, verify, and release gates
 audience: both
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/governance/compliance-standards.md

@@ -1,5 +1,6 @@
 ---
 title: Compliance Standards
+tagline: GDPR/CCPA/SOC 2/HIPAA, tiered by applicability
 audience: both
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/governance/decision-documentation-standard.md

@@ -1,5 +1,6 @@
 ---
 title: Decision Documentation Standard
+tagline: ADR format — every decision leaves a trace
 audience: both
 status: active
 distributable: true

package/dist/assets/.arcane/governance/development-methodology.md

@@ -1,5 +1,6 @@
 ---
 title: Development Methodology — The Spell Loop
+tagline: The Spell Loop itself, as enforceable text
 audience: both
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/governance/external-verification-standards.md

@@ -1,5 +1,6 @@
 ---
 title: External Verification Standards
+tagline: Confirm a write actually took effect out there
 audience: both
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/governance/framework-decisions.md

@@ -1,5 +1,6 @@
 ---
 title: Legacy Framework Decision Reference
+tagline: Offline reference for legacy ADR citations
 audience: both
 status: active
 distributable: true

package/dist/assets/.arcane/governance/git-conventions.md

@@ -1,5 +1,6 @@
 ---
 title: Git Conventions — Commit Format and Branching Model
+tagline: Branch names, commit format, merge rules
 audience: both
 status: active
 distributable: true

package/dist/assets/.arcane/governance/hardening-checklist.md

@@ -1,5 +1,6 @@
 ---
 title: Linux Security Hardening Checklist
+tagline: The Linux hardening baseline, as a checklist
 audience: human
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/governance/mobile-release-standards.md

@@ -1,5 +1,6 @@
 ---
 title: Mobile Release Standards
+tagline: App Store and Play Store release-track facts
 audience: both
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/governance/naming-conventions.md

@@ -1,5 +1,6 @@
 ---
 title: Naming Conventions
+tagline: One vocabulary across code, docs, and agents
 audience: both
 last_updated: YYYY-MM-DD
 status: template

package/dist/assets/.arcane/governance/new-business-setup.md

@@ -1,5 +1,6 @@
 ---
 title: New Business Setup Guide
+tagline: Stand up a new venture from zero
 audience: both
 status: draft
 distributable: true

package/dist/assets/.arcane/governance/poc-management-pattern.md

@@ -1,5 +1,6 @@
 ---
 title: POC Management Pattern
+tagline: How proofs of concept graduate — or get killed
 audience: both
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/governance/portable-bootstrap.md

@@ -1,5 +1,6 @@
 ---
 title: Portable Bootstrap — Quick Context for Ad-Hoc AI Clients
+tagline: Quick context to brief any ad-hoc AI client
 audience: ai
 status: active
 tags: [ai-context, bootstrap, multi-client, portable]

package/dist/assets/.arcane/governance/product-excellence-standards.md

@@ -1,5 +1,6 @@
 ---
 title: Product Excellence Standards
+tagline: The bar a feature must clear to ship
 audience: both
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/governance/rca-process-standard.md

@@ -1,5 +1,6 @@
 ---
 title: Root Cause Analysis (RCA) Process Standard
+tagline: Root cause, not blame, when things break
 audience: both
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/governance/records-conventions.md

@@ -1,5 +1,6 @@
 ---
 title: Records Conventions
+tagline: Supersession, tombstone, and retention rules
 audience: both
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/governance/spell-authoring-standards.md

@@ -1,5 +1,6 @@
 ---
 title: Spell Authoring Standards
+tagline: How to write a spell that holds up
 audience: contributor
 last_updated: YYYY-MM-DD
 status: active
@@ -40,10 +41,27 @@ this broader ≥ Silver gate is not fully verified by any coded scorer or workfl
 
 | Tier | Bar |
 | --- | --- |
-| Bronze | Front-matter complete: `name`, `description`, `argument-hint`, `agent`. Enforcement: explicitly advisory prose (ARC-023) — self-graded during spell audit; a CI check (`npm run check:spell-catalog`, running `scripts/spell-catalog.ts`) incidentally validates only the `name`/`description` fields as a side effect of catalog generation, not the full front-matter set this bar requires. |
+| Bronze | Front-matter complete: `name`, `description`, `tagline`, `argument-hint`, `agent`. The `tagline` is one sentence of at most 60 characters with no trailing period — a marketing-quality one-liner a catalog consumer can show as-is (`Start a logged working session`), distinct from `description`, which tells the AI client when to invoke the spell. Enforcement: executable check for `name`, `description` and `tagline` (ARC-023) — `npm run check:spell-catalog` (`scripts/spell-catalog.ts`) fails CI when a spell or a distributed governance doc lacks one, or when a `tagline` is empty, longer than 60 characters, more than one sentence, or ends with a period; `argument-hint` and `agent` are explicitly advisory prose, self-graded during spell audit. |
 | Silver | + an accurate **Executive Summary** stating purpose, when to use it, and what it produces. |
 | Gold | + explicitly disambiguates itself from sibling spells a user might confuse it with. |
 
+A new spell starts from this front-matter block, every field filled (the generated client shims copy
+it verbatim, so there is no second place to fill it in):
+
+```yaml
+---
+name: Spell — <Title Case Name>
+description: <What the spell does and when the AI client should invoke it, in one or two sentences>
+tagline: <One sentence, at most 60 characters, no trailing period>
+claude_description: Use PROACTIVELY when <the situation that should trigger it, even unprompted>
+argument-hint: <What the user passes, with an example>
+agent: agent
+---
+```
+
+Governance documents carry the same `tagline` field beside their `title`; `npm run check:spell-catalog`
+holds both to the same rule.
+
 ### D2 — Distributability / no org-coupling **(HARD GATE ≥ Silver)**
 
 | Tier | Bar |

package/dist/assets/.arcane/governance/testing-standards.md

@@ -1,5 +1,6 @@
 ---
 title: Testing Standards
+tagline: Coverage thresholds and what counts as tested
 audience: both
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/governance/threat-model.md

@@ -1,5 +1,6 @@
 ---
 title: Threat Model
+tagline: Security posture, attack surfaces, mitigations
 audience: both
 last_updated: YYYY-MM-DD
 status: draft

package/dist/assets/.arcane/governance/universal-agent-rules.md

@@ -1,5 +1,6 @@
 ---
 title: Universal Agent Rules — Single Source of Truth
+tagline: The single source of truth every agent obeys
 audience: ai
 status: active
 tags: [rules, governance, ai-agents, multi-client]

package/dist/assets/.arcane/governance/web-discoverability-standards.md

@@ -1,5 +1,6 @@
 ---
 title: Web Discoverability Standards
+tagline: Search-engine and AI-assistant discoverability rules
 audience: both
 last_updated: YYYY-MM-DD
 status: active

package/dist/assets/.arcane/spells/spell-address-review.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.
+tagline: Resolve reviewer feedback systematically
 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/.arcane/spells/spell-adopt-docs.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.
+tagline: Bring an existing doc tree under governance
 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/.arcane/spells/spell-arcane-version.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.
+tagline: What is installed, what is current
 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/.arcane/spells/spell-architect.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Architect
 description: Generate architecture decisions and story breakdown from a PRD, producing architecture.md and stories.json
+tagline: Break the plan into stories + criteria
 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/.arcane/spells/spell-brainstorm.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Brainstorm
 description: Divergent ideation — explore multiple solutions to a problem space before committing to a plan
+tagline: Structured divergent thinking
 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/.arcane/spells/spell-bug.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
+tagline: File a reproducible bug report
 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/.arcane/spells/spell-bump.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
+tagline: Version bump + changelog entry
 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/.arcane/spells/spell-check-drift.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).
+tagline: Detect divergence from the plan
 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/.arcane/spells/spell-close-session.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.
+tagline: Wrap up; journal the session
 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/.arcane/spells/spell-commit-work.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
+tagline: Conventional commits, written for you
 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

package/dist/assets/.arcane/spells/spell-compliance.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.
+tagline: GDPR/CCPA/SOC 2/HIPAA, before you need it
 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/.arcane/spells/spell-create-pull-request.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).
+tagline: Open a PR with full context
 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

package/dist/assets/.arcane/spells/spell-document.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Document
 description: Formalize valuable insights, analysis, or decisions from the current conversation into polished, permanent reference documents.
+tagline: Write the docs that match the code
 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/.arcane/spells/spell-dotnet-expert.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — .NET Expert
 description: Load .NET best practices and patterns for any development agent working on .NET projects
+tagline: Summon deep .NET expertise
 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/.arcane/spells/spell-eas-store-deploy.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.
+tagline: Ship an Expo app to the App Store or Play
 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/.arcane/spells/spell-enchant.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"
+tagline: Harden a PRD — tighter scope, security, edge cases
 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/.arcane/spells/spell-explain-concept.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."
+tagline: Explain any concept, in context
 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/.arcane/spells/spell-feedback.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.
+tagline: Send feedback upstream to Arcane
 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/.arcane/spells/spell-full-cycle.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
+tagline: Run the whole loop end-to-end
 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

package/dist/assets/.arcane/spells/spell-generate-bot-icons.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.
+tagline: Generate avatars for your roster
 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/.arcane/spells/spell-implement.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
+tagline: Build against stories, never freestyle
 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/.arcane/spells/spell-make-discoverable.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.
+tagline: Audit a site's search/AI-assistant discoverability
 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/.arcane/spells/spell-manifest.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.
+tagline: Triage idea and todo books across ventures
 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/.arcane/spells/spell-open-session.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.
+tagline: Start a logged working session
 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

package/dist/assets/.arcane/spells/spell-plan.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Plan
 description: Generate a Product Requirements Document (PRD) from a feature description using structured planning
+tagline: Turn intent into a reviewable PRD
 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

package/dist/assets/.arcane/spells/spell-present-arcane.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.
+tagline: Pitch Arcane to your team
 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/.arcane/spells/spell-product-review.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Product Review
 description: Build/Measure/Analyze/Decide cycle — evaluate feature performance and recommend next actions
+tagline: Judge the product, not the diff
 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/.arcane/spells/spell-review-batch.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.
+tagline: Review a stack of changes at once
 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/.arcane/spells/spell-review.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Review
 description: Adversarial code review — must find issues, validate architecture compliance, and check security
+tagline: Adversarial review before merge
 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/.arcane/spells/spell-save-idea.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.
+tagline: Bank an idea before it evaporates
 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/.arcane/spells/spell-scope.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
+tagline: Cut the work down to shippable size
 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

package/dist/assets/.arcane/spells/spell-scry.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.
+tagline: Clear a name before you commit 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/.arcane/spells/spell-security-review.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
+tagline: Threat-model the change
 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/.arcane/spells/spell-ship.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Ship
 description: Pre-deploy checklist, merge approval workflow, and deployment gate verification
+tagline: Merge, version, release
 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/.arcane/spells/spell-status.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.
+tagline: Where the work stands, at a glance
 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/.arcane/spells/spell-suggest-feature.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
+tagline: Propose the next thing worth building
 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

package/dist/assets/.arcane/spells/spell-summon-venture.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.
+tagline: Stand up a new venture from zero
 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/.arcane/spells/spell-sync-pull-request.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 / regenerable / 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.
+tagline: Rebase a stale PR, resolve conflicts safely
 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

package/dist/assets/.arcane/spells/spell-test.md

@@ -1,6 +1,7 @@
 ---
 name: Spell — Test
 description: Run tests, validate coverage thresholds, and generate test evidence for a completed story or feature
+tagline: Prove it works; enforce thresholds
 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/.arcane/spells/spell-todo.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.
+tagline: Capture and track loose ends
 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