# @maestria/cursor

<div class="plugin-root">
  <div class="home-glow" aria-hidden="true"></div>
  <div class="home-grid" aria-hidden="true"></div>

  <div class="home-inner">
    <PlatformHero
      eyebrow="@MAESTRIA/CURSOR"
      title="One bundle for IDE and CLI."
      lead="Install one plugin. Get 7 specialist agents, an orchestrator skill, always-on rules, and fein/sonar/blitz commands."
      mark={marks.cursorMark}
      primaryCta={{ href: '/cursor/getting-started/installation/', label: 'Get started' }}
      secondaryCta={{ href: '/cursor/getting-started/quick-start/', label: 'Quick start' }}
      installCommand="npx maestria install cursor"
    />

    <PluginSection
      index="01"
      kicker="WHAT YOU GET"
      title="Same bundle, both surfaces."
      class="pt-[clamp(3.5rem,7vw,5rem)] mb-[clamp(4rem,9vw,7rem)]"
    >
      <FeatureGrid
        items={[
          { title: '7 specialist agents', desc: 'adventurer, architect, builder, diagnose, planner, reviewer, and writer run as Cursor Task agents.' },
          { title: 'Always-on global rules', desc: 'rules/maestria-global.mdc ships with alwaysApply: true - workflow directives apply to every Agent session.' },
          { title: 'Orchestrator skill', desc: 'Loads when a task needs the pipeline, or invoke it directly via /orchestrator.' },
          { title: 'Workflow mode commands', desc: '/fein, /sonar, and /blitz select the pipeline depth from Agent chat - in the IDE or the CLI.' },
          { title: 'One install, both surfaces', desc: 'The same plugin drives Cursor IDE and Cursor CLI - restart the IDE or point the CLI at the plugin directory.' },
          { title: 'Declarative plugin', desc: '.cursor-plugin/plugin.json declares rules/, agents/, skills/, and commands/ - Cursor discovers and auto-loads each directory.' },
        ]}
      />
    </PluginSection>

    <PluginSection
      index="02"
      kicker="HOW IT WIRES IN"
      title="Rules always on, specialists on call."
      class="mb-[clamp(4rem,9vw,7rem)]"
    >
      <ol class="list-none m-0 p-0 border-t border-home-border">
        <li class="flex items-baseline gap-4 py-3.5 px-0.5 border-b border-home-border">
          <span class="font-mono text-sm text-home-accent opacity-75 tabular-nums">1</span>
          <p class="m-0 text-[0.9375rem] leading-[1.6] text-home-text-soft"><strong class="font-semibold text-home-text">Plugin loads</strong> - Cursor discovers <code>.cursor-plugin/plugin.json</code> and auto-loads <code>rules/</code>, <code>agents/</code>, <code>skills/</code>, <code>commands/</code></p>
        </li>
        <li class="flex items-baseline gap-4 py-3.5 px-0.5 border-b border-home-border">
          <span class="font-mono text-sm text-home-accent opacity-75 tabular-nums">2</span>
          <p class="m-0 text-[0.9375rem] leading-[1.6] text-home-text-soft"><strong class="font-semibold text-home-text">Global rules apply</strong> - <code>rules/maestria-global.mdc</code> uses <code>alwaysApply: true</code></p>
        </li>
        <li class="flex items-baseline gap-4 py-3.5 px-0.5 border-b border-home-border">
          <span class="font-mono text-sm text-home-accent opacity-75 tabular-nums">3</span>
          <p class="m-0 text-[0.9375rem] leading-[1.6] text-home-text-soft"><strong class="font-semibold text-home-text">Orchestrator skill</strong> - available when relevant or via <code>/orchestrator</code></p>
        </li>
        <li class="flex items-baseline gap-4 py-3.5 px-0.5 border-b border-home-border">
          <span class="font-mono text-sm text-home-accent opacity-75 tabular-nums">4</span>
          <p class="m-0 text-[0.9375rem] leading-[1.6] text-home-text-soft"><strong class="font-semibold text-home-text">Specialists run as Task agents</strong> - adventurer, architect, builder, diagnose, planner, reviewer, writer</p>
        </li>
      </ol>
    </PluginSection>

    <PluginSection
      index="03"
      kicker="INSTALL PATHS"
      title="Install once, restart or point the CLI."
      class="mb-[clamp(4rem,9vw,7rem)]"
    >
      <div class="flex flex-col gap-6 max-w-46rem">
        <p class="m-0 text-[0.9375rem] leading-[1.65] text-home-text-soft">
          The chip above uses the maestria CLI. Prefer your own package runner?
        </p>
      </div>

      <PackageManagers type="dlx" pkg="maestria@latest" args="install cursor" />

      <p class="!mt-6 mb-0 text-[0.9375rem] leading-[1.65] text-home-text-soft">
        Then restart Cursor IDE, or launch the CLI against the plugin directory:
      </p>

      ```bash
      agent --plugin-dir ~/.cursor/plugins/local/maestria
      ```
    </PluginSection>

    <PluginSection
      index="04"
      kicker="FIND YOUR WAY"
      title="Start with the plugin."
      class="mb-[clamp(4rem,9vw,7rem)]"
    >
      <div>
        <a class="group grid grid-cols-[minmax(0,15rem)_minmax(0,1fr)_auto] items-baseline gap-4 py-3.5 px-0.5 border-t border-home-border no-underline min-w-0 max-md:grid-cols-[minmax(0,1fr)_auto] focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-[var(--home-focus)]" href="/cursor/getting-started/installation/">
          <span class="text-[0.9375rem] font-[560] text-home-text transition-colors group-hover:text-home-accent">Getting Started</span>
          <span class="text-sm leading-[1.5] text-home-text-muted max-md:col-span-full">Installation, setup, and your first session with the plugin.</span>
          <span class="text-home-text-muted transition-colors group-hover:text-home-accent group-hover:translate-x-[3px] max-md:col-2 max-md:row-1 max-md:justify-self-end" aria-hidden="true">→</span>
        </a>
        <a class="group grid grid-cols-[minmax(0,15rem)_minmax(0,1fr)_auto] items-baseline gap-4 py-3.5 px-0.5 border-t border-home-border no-underline min-w-0 max-md:grid-cols-[minmax(0,1fr)_auto] focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-[var(--home-focus)]" href="/cursor/getting-started/quick-start/">
          <span class="text-[0.9375rem] font-[560] text-home-text transition-colors group-hover:text-home-accent">Quick Start</span>
          <span class="text-sm leading-[1.5] text-home-text-muted max-md:col-span-full">Run your first workflow command and delegate to specialists.</span>
          <span class="text-home-text-muted transition-colors group-hover:text-home-accent group-hover:translate-x-[3px] max-md:col-2 max-md:row-1 max-md:justify-self-end" aria-hidden="true">→</span>
        </a>
        <a class="group grid grid-cols-[minmax(0,15rem)_minmax(0,1fr)_auto] items-baseline gap-4 py-3.5 px-0.5 border-t border-home-border no-underline min-w-0 max-md:grid-cols-[minmax(0,1fr)_auto] focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-[var(--home-focus)]" href="/core/agents/">
          <span class="text-[0.9375rem] font-[560] text-home-text transition-colors group-hover:text-home-accent">Agent Reference</span>
          <span class="text-sm leading-[1.5] text-home-text-muted max-md:col-span-full">The 7 specialists and orchestrator methodology.</span>
          <span class="text-home-text-muted transition-colors group-hover:text-home-accent group-hover:translate-x-[3px] max-md:col-2 max-md:row-1 max-md:justify-self-end" aria-hidden="true">→</span>
        </a>
        <a class="group grid grid-cols-[minmax(0,15rem)_minmax(0,1fr)_auto] items-baseline gap-4 py-3.5 px-0.5 border-t border-home-border no-underline min-w-0 max-md:grid-cols-[minmax(0,1fr)_auto] focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-[var(--home-focus)]" href="/cursor/changelog/">
          <span class="text-[0.9375rem] font-[560] text-home-text transition-colors group-hover:text-home-accent">Changelog</span>
          <span class="text-sm leading-[1.5] text-home-text-muted max-md:col-span-full">Release history for @maestria/cursor.</span>
          <span class="text-home-text-muted transition-colors group-hover:text-home-accent group-hover:translate-x-[3px] max-md:col-2 max-md:row-1 max-md:justify-self-end" aria-hidden="true">→</span>
        </a>
        <a class="group grid grid-cols-[minmax(0,15rem)_minmax(0,1fr)_auto] items-baseline gap-4 py-3.5 px-0.5 border-t border-b border-home-border no-underline min-w-0 max-md:grid-cols-[minmax(0,1fr)_auto] focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-[var(--home-focus)]" href="/cursor/contributing/">
          <span class="text-[0.9375rem] font-[560] text-home-text transition-colors group-hover:text-home-accent">Contributing</span>
          <span class="text-sm leading-[1.5] text-home-text-muted max-md:col-span-full">How to edit sync config and regenerate plugin files.</span>
          <span class="text-home-text-muted transition-colors group-hover:text-home-accent group-hover:translate-x-[3px] max-md:col-2 max-md:row-1 max-md:justify-self-end" aria-hidden="true">→</span>
        </a>
      </div>
    </PluginSection>

    <SiblingPlatforms excludeId="cursor" />

    <SiteFooter />

  </div>
</div>