Starlight Intelligence System

A protocol for sovereign creator alliances — and a reference implementation you can run today.

SIS is two layers: a substrate (SIP) anyone can adopt, fork, or build on — and an operational layer (Frank's reference build) that runs on top of it.

Two layers, one repo

You can adopt just the substrate (fork SIP for your own work), just the operational layer (use the MCP server for AI memory), or the full stack (Frank's reference build, end to end). They are independent.

New here? Don't fork this repo. Fork the SIP adoption kit — eleven markdown files, no code, ship your first attested artifact in 60 seconds. Compose upward when you're ready.

New in v7.3.1 (2026-04-24): Newcomer surface shipped — /welcome, /intake, /sovereign-spawn protocol commands + Concierge + Envoy front-door agents + ecosystem export schemas (Claude Projects, ChatGPT Projects, Gemini Gems, Cursor, Cowork) + attested-modality scaffolds (audio/image/video/compose). Read ONBOARDING.md, DELIVERY.md, docs/ecosystem-integration.md. Board-verdict driven ship — see ATTESTATIONS.md § v7.3.1.

The substrate (SIP)

Starlight Intelligence Protocol — the contract that lets sovereign parties compose intelligence systems without losing sovereignty. Six layers:

1. File contract — canonical names and shapes for SKILL.md, AGENTS.md/VOICES.md, MEMORY.md, CANON.md, SOUL.md, STACK.md, .claude/commands/*, plus .arc / .nea / .skill extensions.
2. Attestation protocol — verifiable "Built on SIP" attribution via /sip-attest. Refuses decorative use.
3. MCP registry standard — how MCP servers declare, compose, version (mcp.json schema).
4. Command taxonomy — protocol / alliance / vertical / sovereign tiers with explicit decision rights.
5. Sovereignty + attribution clause — the non-negotiable social contract.
6. Archetype extension — optional canon adoption (Arcanea archetypes available CC-BY-NC).

Canonical URL: starlightintelligence.org/protocol · Source of truth: SIP.md in this repo.

Substrate files at a glance

Forge an alliance, spawn a vertical

# Pressure-test before committing
/luminor-board "Open-source the agent layer or keep it closed?"

# Forge an alliance under SIP
/alliance-forge trinity "Frank,Ahmad,Logan,Shahvaiz"

# Spawn a vertical IS under SIS
/vertical-spawn anime-legends "anime-aesthetic fiction + character design"

# Attest a shipped artifact
/sip-attest path/to/artifact.md

Every cross-party artifact carries the "Built on SIP" attestation block. Silent composition is a breach.

The operational layer (reference build)

This repo also ships Frank's working implementation — the daily-driver intelligence system that runs on top of SIP. Use it directly, fork it, or replace it entirely with your own layer above the substrate.

Quick start (operational layer, 2 minutes)

Option 1: As an MCP server (recommended for AI tools)

{
  "mcpServers": {
    "starlight": {
      "command": "node",
      "args": [
        "node_modules/@arcanea/starlight-intelligence-system/dist/mcp-server.js",
        "--vault-dir",
        "~/.starlight/vaults"
      ]
    }
  }
}

Restart Claude Code. You now have ten sis_* tools available in every session.

Option 2: As a library

pnpm add @arcanea/starlight-intelligence-system

import { StarlightIntelligence } from "@arcanea/starlight-intelligence-system";
import { createAdapter } from "@arcanea/starlight-intelligence-system/adapters";

const sis = new StarlightIntelligence();
sis.initialize();

sis.remember({
  content: "Always Read a file before editing — catches stale state",
  category: "pattern",
  tags: ["workflow", "edit-safety"],
  confidence: 0.95,
});

const adapter = createAdapter("claude-code");
const context = await adapter.generate({ vaultDir: "~/.starlight/vaults" });

The six vaults

Each vault is a JSONL file. Human-readable. Git-versionable. Greppable.

What the operational layer adds on top of SIP

• SQLite hybrid retrieval — src/retrieval.ts builds a rebuildable FTS5 shadow index over JSONL vaults with bm25 ranking.
• Temporal reasoning — src/temporal.ts adds validity windows and a 90-day confidence half-life.
• Contradiction detection — src/contradiction.ts finds conflicting entries via word-trigram Jaccard with opposing-signal boosting.
• Dreaming — src/dreaming.ts processes session transcripts in the background.
• Five platform adapters — Claude Code, Cursor, Codex, Gemini CLI, OpenCode share the same vaults.
• MCP v2 — src/mcp-server.ts ships ten tools over JSON-RPC 2.0 stdio.

MCP tools

Platform adapters

The 7 named agents (operational layer)

The reference build maps SIP's 5 voice archetypes to 7 named runtime agents — Orchestrator, Prime, Architect, Navigator, Sentinel, Weaver, Sage. Full registry: agents/AGENT_REGISTRY.md.

Voice archetypes are abstract; named agents are specific implementations. Anyone forking SIP can choose entirely different agents above the substrate.

Fork patterns

Public canonical URL

starlightintelligence.org/protocol mirrors SIP.md. This repo is the source of truth.

Architecture (operational layer)

            ┌─────────────────────────────────────────┐
            │  JSONL vaults  (source of truth)        │
            │  ~/.starlight/vaults/*.jsonl            │
            │  human-readable · git-versionable       │
            └────────────────┬────────────────────────┘
                             │
                             │  rebuildable from JSONL
                             ▼
            ┌─────────────────────────────────────────┐
            │  SQLite + FTS5  (shadow index)          │
            │  bm25 ranking · temporal filters        │
            └────────────────┬────────────────────────┘
                             │
                             │  JSON-RPC 2.0 over stdio
                             ▼
            ┌─────────────────────────────────────────┐
            │  MCP server  (10 sis_* tools)           │
            └────────────────┬────────────────────────┘
                             │
        ┌────────────────────┼────────────────────────┐
        ▼            ▼       ▼       ▼        ▼       ▼
   Claude Code   Cursor   Codex   Gemini   OpenCode   Your tool

Development

git clone https://github.com/frankxai/Starlight-Intelligence-System.git
cd Starlight-Intelligence-System
pnpm install
pnpm run build       # tsc to dist/
pnpm test            # 82+ orchestrator tests
pnpm run lint        # tsc --noEmit

src/ is under 3,000 lines of TypeScript with zero runtime dependencies outside better-sqlite3. Substrate docs (SIP.md, SIS.md, etc.) are markdown-only — no build dependency.

License

• Code (operational layer + substrate-tier commands): MIT — see LICENSE.
• Substrate spec docs (SIP.md, SIS.md, ALLIANCE.md, STACK.md, VOICES.md, VERTICALS.md, MEMORY.md, REGISTRY.md, SKILL.md): MIT, same LICENSE. The "Built on SIP" attestation request is a social-layer convention captured in NOTICE, not a license restriction.
• Arcanea canon (if your fork composes with it): CC-BY-NC 4.0, © Arcanea BV. Lives in frankxai/arcanea-ecosystem; canon is compose-only — not redistributed under this repo's MIT.
• Trademarks: ARCANEA, FRANKX, STARLIGHT INTELLIGENCE — registered or in registration, reserved rights.

"Built on SIP" is an attestation phrase, not a trademark. Use of the phrase requires actual SIP composition per /sip-attest rules. Full attribution + canon + trademark summary in NOTICE (Apache-style — LICENSE for legal rights, NOTICE for propagation conventions).

Related

• Arcanea — Creator platform; canon-defining vertical built on SIS
• FrankX — Architect brand; SIP thought leadership
• Public Vaults — Browse and fork vaults
• Protocol page — Canonical SIP spec
• GitHub — Source, issues, discussions

Built on SIP · Starlight Intelligence Protocol · v1.1.0 · v7.5.3 cockpit-complete · MIT