# @maestria/pi

<div class="plugin-root">
  <div class="home-inner">
    <PlatformHero
      title="Structured workflows for Pi."
      lead="Install the Pi extension for four specialist subagents, workflow modes, and session-aware orchestration."
      primaryCta={{ href: '/pi/getting-started/installation/', label: 'Get started' }}
      secondaryCta={{ href: '/pi/reference/', label: 'Reference' }}
      installCommand="npx maestria install pi"
    />

    <PluginSection
      title="A native Pi extension."
      class="pt-[clamp(3.5rem,7vw,5rem)] mb-[clamp(4rem,9vw,7rem)]"
    >
      <FeatureGrid
        items={[
          { title: '4 specialist subagents', desc: 'Pi registers the adventurer, architect, builder, and reviewer roles. Adventurer handles read-only diagnosis with the diagnose skill (on Pi, a diagnosis that must reproduce a failure goes through builder, since adventurer has no shell tool); architect handles phased plans with the plan skill; builder handles implementation and documentation.' },
          { title: 'Workflow modes', desc: '/fein runs the full pipeline, /sonar stays research-only, and /blitz takes the fast path.' },
          { title: 'Session tracking', desc: 'The extension records subagent runs and handoff history in the session; `/maestria-status` summarizes the mode, delegated specialists, and recent handoffs.' },
          { title: 'Host-owned controls', desc: 'Pi supplies the runtime; subagent dispatch needs the `@gotgenes/pi-subagents` extension, which the CLI installs. Read-only and lifecycle behavior follows the installed extension and host configuration.' },
        ]}
      />
    </PluginSection>

    <RelatedDocs
      links={[
        { label: 'Quick start', href: '/pi/getting-started/quick-start/' },
        { label: 'Specialist reference', href: '/core/agents/' },
        { label: 'Reference', href: '/pi/reference/' },
        { label: 'Changelog', href: '/pi/changelog/' },
        { label: 'Contributing', href: '/pi/contributing/' },
        { label: 'Oh My Pi portable integration', href: '/agent-plugins/installation/#omp' },
      ]}
    />

    <SiteFooter />

  </div>
</div>