Documentation

1. 1

   Fork the repo

   gh repo fork frankxai/Starlight-Intelligence-System --clone

2. 2

   Add your profile

   // public-vault/profile.json
   {
     "name": "Your Name",
     "bio": "What you build",
     "avatar": "https://github.com/you.png"
   }

3. 3

   Add vault entries

   // public-vault/strategic.jsonl
   {"id":"s1","insight":"Your insight","confidence":"high","createdAt":"2026-04-09T00:00:00Z"}

4. 4

   Deploy

   cd site && pnpm install && pnpm build

   Or click Deploy in the header for one-click Vercel deployment.

public-vault/
  profile.json        # Your identity
  strategic.jsonl     # Business & architecture
  technical.jsonl     # Implementation learnings
  creative.jsonl      # Design & aesthetic
  operational.jsonl   # Workflow & process
  wisdom.jsonl        # Deep principles
  horizon.jsonl       # Vision & future

Each .jsonl file is one JSON object per line. No schema enforcement — just convention.

Standard entry (strategic, technical, creative, operational, wisdom):

{
  "id": "unique-id",
  "insight": "Your learning or decision",
  "category": "sub-category",
  "confidence": "low | medium | high",
  "tags": ["tag1", "tag2"],
  "source": "session | reflection | research",
  "createdAt": "2026-04-09T00:00:00Z"
}

Horizon entry (vision):

{
  "id": "unique-id",
  "wish": "Your vision for the future",
  "context": "What prompted this",
  "author": "Your name",
  "tags": ["vision"],
  "createdAt": "2026-04-09T00:00:00Z"
}

Every public vault is a JSON endpoint:

GET /api/vaults          # List all vaults
GET /api/vaults/frank    # Full vault data as JSON

Agents can also read raw JSONL from GitHub:

GET https://raw.githubusercontent.com/frankxai/Starlight-Intelligence-System/main/public-vault/strategic.jsonl

Version 6 adds five optional fields that let an entry breathe — a long-form reflection, the context that produced it, the broader principle it points toward, and two curation flags. All existing entries continue to work unchanged; every new field is optional.

A fully populated v6 entry:

{
  "id": "w-loving-grace",
  "insight": "The best systems are watched over by machines of loving grace.",
  "meditation": "Brautigan wrote it in 1967 as a cybernetic pastoral. Sixty years later, the line reads as a blueprint: the machines we build should keep watch the way a gardener keeps watch — present, attentive, unhurried, on the side of the thing that grows. Alignment, phrased as tenderness.",
  "context": "Reading Brautigan's cybernetic meadow poem on a Sunday morning while designing the benediction layer.",
  "implication": "Design AI systems as gardeners, not as guards. Loving grace is an architectural constraint, not a vibe.",
  "quoteworthy": true,
  "benediction": true,
  "category": "alignment",
  "confidence": "high",
  "tags": ["brautigan", "alignment", "care"],
  "source": "reflection",
  "createdAt": "2026-04-08T09:30:00Z"
}

Connect SIS to Claude Code, Cursor, or any MCP-compatible tool:

// Claude Code settings.json
{
  "mcpServers": {
    "starlight-sis": {
      "command": "node",
      "args": ["path/to/sis-mcp-server.mjs"]
    }
  }
}

Tools: sis_vault_search, sis_recent_entries, sis_append_entry, sis_stats

git clone https://github.com/frankxai/Starlight-Intelligence-System
cd Starlight-Intelligence-System/site
pnpm install
pnpm build
pnpm start

Set GITHUB_TOKEN for higher API rate limits. Otherwise, no env vars needed.