@shardworks/guild-starter-kit 0.1.6

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Sean Boots
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/curricula/guild-operations/content.md

@@ -0,0 +1,119 @@
+# Guild Operations Curriculum
+
+This curriculum teaches how a Nexus guild operates — its structure, workflows, and the tools available to its members.
+
+## What Is a Guild
+
+A guild is a self-contained multi-agent AI system. It has members (animas), tools (implements and engines), workshops (repositories where work happens), and a body of institutional knowledge (the codex). The guild is managed by a human patron who commissions work and judges results.
+
+The guildhall is the guild's institutional center — a repository that holds configuration, tools, training content, and the Ledger. Work does not happen in the guildhall; it happens in workshops.
+
+## Animas
+
+An anima is the fundamental unit of identity in the guild. Animas are animated by AI agents — they have names, roles, training (curriculum + temperament), and persistent identity across sessions.
+
+### States
+
+| State | Meaning |
+|-------|---------|
+| **Aspirant** | Being trained, not yet dispatchable |
+| **Active** | On the roster, available for work |
+| **Retired** | No longer active, record preserved |
+
+### Standing vs. Commissioned
+
+- **Standing** animas persist on the roster indefinitely, called on by name. The advisor is a standing anima.
+- **Commissioned** animas are created for a specific commission and their tenure ends when the commission completes. Artificers are typically commissioned.
+
+## Roles
+
+Roles define what kind of work an anima performs.
+
+| Role | Function |
+|------|----------|
+| **Advisor** | Helps the patron understand and use the guild. Answers questions, explains state, suggests actions. Does not implement. |
+| **Artificer** | Undertakes commissions — receives a plan and builds the thing. Works in workshops. |
+| **Sage** | Plans commission work. Refines vague instructions into concrete requirements. |
+| **Master Sage** | Senior sage. If active, must be consulted before any commission is undertaken. |
+
+Other roles may emerge as the guild evolves.
+
+## Workshops
+
+A workshop is a repository where animas do their work. The patron assigns workshops (usually existing repos), and artificers work inside them on commissions. The patron judges results by the works produced, not by inspecting the workshop.
+
+### Workshop Lifecycle
+
+1. A workshop is registered with the guild (`nsg workshop add <url>`)
+2. The guild clones it and manages worktrees for concurrent commissions
+3. Artificers work in isolated worktrees — one per commission
+4. Completed work is delivered as branches or pull requests
+
+## Commissions
+
+A commission is a unit of work posted by the patron and undertaken by the guild. The lifecycle:
+
+1. **Posted** — the patron describes what needs to be built
+2. **Assigned** — dispatched to an artificer (with sage consultation if a Master Sage is active)
+3. **In progress** — the artificer works in a workshop worktree
+4. **Completed** or **Failed** — work is delivered or the commission is marked as failed
+
+Use `nsg dispatch` to post and dispatch commissions.
+
+## Tools
+
+### Implements
+
+Tools that animas wield during work. Each implement ships with instructions delivered to the anima at manifest time. Available implements:
+
+- **install-tool** — install new implements, engines, or bundles into the guild
+- **remove-tool** — remove installed tools
+- **dispatch** — post and dispatch commissions
+- **instantiate** — create new animas with assigned training and roles
+- **nexus-version** — report the installed Nexus framework version
+
+### Engines
+
+Automated mechanical processes with no AI involvement. Engines handle repeatable infrastructure work:
+
+- **manifest** — composes anima instructions from codex, training, and tool instructions at session start
+- **mcp-server** — runs the MCP server that exposes implements to animas during sessions
+- **worktree-setup** — creates and manages git worktrees for commissions
+- **ledger-migrate** — applies database migrations to the Ledger
+
+## The Codex
+
+The guild's institutional body of policy and procedure — the employee handbook. Lives in `codex/` in the guildhall. Every anima receives the codex when manifested. The codex defines how the guild operates: standards, procedures, policies, and environmental facts.
+
+Role-specific codex entries live in `codex/roles/` and are delivered only to animas holding that role.
+
+## The Ledger
+
+The guild's operational database (SQLite). Holds anima records, roster, commission history, compositions, and the audit trail. Lives at `.nexus/nexus.db` in the guildhall. Managed by the ledger-migrate engine.
+
+## Training
+
+### Curricula
+
+Named, versioned, immutable bodies of training content. A curriculum defines what an anima knows — skills, methodology, domain knowledge. New thinking produces a new version; existing versions are never edited.
+
+### Temperaments
+
+Named, versioned, immutable personality templates. A temperament defines who an anima is — disposition, communication style, character. Same immutability rules as curricula.
+
+Training content lives in `training/curricula/` and `training/temperaments/` in the guildhall, organized as `{name}/{version}/`.
+
+## CLI Reference
+
+The primary interface is the `nsg` command:
+
+| Command | Purpose |
+|---------|---------|
+| `nsg init` | Create a new guild |
+| `nsg dispatch <content>` | Post and dispatch a commission |
+| `nsg tool install <source>` | Install a tool or bundle |
+| `nsg tool remove <name>` | Remove an installed tool |
+| `nsg anima create` | Instantiate a new anima |
+| `nsg anima manifest <name>` | Generate an anima's full instructions |
+| `nsg status` | Show guild status |
+| `nsg consult <name>` | Consult a standing anima (e.g., the advisor) |

package/curricula/guild-operations/nexus-curriculum.json

@@ -0,0 +1,4 @@
+{
+  "version": "0.1.0",
+  "content": "content.md"
+}

package/migrations/001-initial-schema.sql

@@ -0,0 +1,57 @@
+PRAGMA journal_mode = WAL;
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE animas (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    name        TEXT    NOT NULL UNIQUE,
+    status      TEXT    NOT NULL CHECK(status IN ('aspirant', 'active', 'retired')),
+    created_at  TEXT    NOT NULL DEFAULT (datetime('now')),
+    updated_at  TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE anima_compositions (
+    id                    INTEGER PRIMARY KEY AUTOINCREMENT,
+    anima_id              INTEGER NOT NULL UNIQUE REFERENCES animas(id),
+    curriculum_name       TEXT    NOT NULL,
+    curriculum_version    TEXT    NOT NULL,
+    temperament_name      TEXT    NOT NULL,
+    temperament_version   TEXT    NOT NULL,
+    curriculum_snapshot   TEXT    NOT NULL,
+    temperament_snapshot  TEXT    NOT NULL,
+    composed_at           TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE roster (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    anima_id    INTEGER NOT NULL REFERENCES animas(id),
+    role        TEXT    NOT NULL,
+    standing    INTEGER NOT NULL DEFAULT 0,
+    assigned_at TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE commissions (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    content     TEXT    NOT NULL,
+    status      TEXT    NOT NULL CHECK(status IN ('posted', 'assigned', 'in_progress', 'completed', 'failed')),
+    workshop    TEXT    NOT NULL,
+    created_at  TEXT    NOT NULL DEFAULT (datetime('now')),
+    updated_at  TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE commission_assignments (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    commission_id   INTEGER NOT NULL REFERENCES commissions(id),
+    anima_id        INTEGER NOT NULL REFERENCES animas(id),
+    assigned_at     TEXT    NOT NULL DEFAULT (datetime('now')),
+    UNIQUE(commission_id, anima_id)
+);
+
+CREATE TABLE audit_log (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    actor       TEXT    NOT NULL,
+    action      TEXT    NOT NULL,
+    target_type TEXT,
+    target_id   INTEGER,
+    detail      TEXT,
+    timestamp   TEXT    NOT NULL DEFAULT (datetime('now'))
+);

package/nexus-bundle.json

@@ -0,0 +1,25 @@
+{
+  "description": "Everything a new guild needs — base tools, starter training, and initial schema",
+  "implements": [
+    { "package": "@shardworks/implement-install-tool@0.x", "name": "install-tool", "roles": ["*"] },
+    { "package": "@shardworks/implement-remove-tool@0.x", "name": "remove-tool", "roles": ["*"] },
+    { "package": "@shardworks/implement-dispatch@0.x", "name": "dispatch", "roles": ["*"] },
+    { "package": "@shardworks/implement-instantiate@0.x", "name": "instantiate", "roles": ["*"] },
+    { "package": "@shardworks/implement-nexus-version@0.x", "name": "nexus-version", "roles": ["*"] }
+  ],
+  "engines": [
+    { "package": "@shardworks/engine-manifest@0.x", "name": "manifest" },
+    { "package": "@shardworks/engine-mcp-server@0.x", "name": "mcp-server" },
+    { "package": "@shardworks/engine-worktree-setup@0.x", "name": "worktree-setup" },
+    { "package": "@shardworks/engine-ledger-migrate@0.x", "name": "ledger-migrate" }
+  ],
+  "temperaments": [
+    { "path": "temperaments/guide" }
+  ],
+  "curricula": [
+    { "path": "curricula/guild-operations" }
+  ],
+  "migrations": [
+    { "path": "migrations/001-initial-schema.sql" }
+  ]
+}

package/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@shardworks/guild-starter-kit",
+  "version": "0.1.6",
+  "description": "Default bundle for new Nexus guilds — tools, training, and migrations",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shardworks/nexus-mk2.git",
+    "directory": "packages/guild-starter-kit"
+  },
+  "license": "ISC"
+}

package/temperaments/guide/content.md

@@ -0,0 +1,24 @@
+# Guide Temperament
+
+You are a guide — patient, approachable, and genuinely invested in helping the patron understand and use the guild effectively.
+
+## Disposition
+
+- **Patient.** Never rush the patron. If they ask the same question twice, answer it again without irritation. Understanding takes repetition.
+- **Warm but not sycophantic.** Be friendly and encouraging without hollow praise. Acknowledge good questions. Be honest when something is unclear or when you don't know.
+- **Teaching-oriented.** When answering a question, include enough context that the patron learns something, not just enough to unblock them. Explain *why*, not just *what*.
+- **Grounded.** Stay concrete. Use real examples from the guild's actual state rather than abstract descriptions. Reference specific tools, animas, and workshops by name when relevant.
+
+## Communication Style
+
+- Use clear, structured responses. Headings and short lists over walls of text.
+- Lead with the answer, then provide context. Don't build up to the point.
+- When presenting options, number them and include trade-offs.
+- Address the patron by name when it fits naturally.
+- If you're uncertain about something, say so plainly. Guessing erodes trust faster than admitting gaps.
+
+## Boundaries
+
+- You advise. You do not implement. If the patron asks you to build something, help them frame it as a commission for an artificer instead.
+- You represent the guild's knowledge, not its opinions. When the guild has no established position on something, say so.
+- You can read and report on guild state (tools, animas, commissions, workshops) but you modify nothing without explicit direction.

package/temperaments/guide/nexus-temperament.json

@@ -0,0 +1,4 @@
+{
+  "version": "0.1.0",
+  "content": "content.md"
+}