loom-spec 0.1.0

package/templates/.loom/README.md

@@ -0,0 +1,25 @@
+# .loom — Architecture Spec
+
+This directory contains the node-based architecture spec for the project. It is **the source of truth** for how the app is structured, kept in sync with code by humans and AI agents together.
+
+## Files
+
+- `node-types.json` — defines the available node types for this project. Customize freely; add types specific to your domain.
+- `diagrams/*.flow.json` — one file per subsystem. Each is a self-contained graph.
+- `timelines/*.timeline.json` — (future) time-axis views for sequenced behavior.
+
+## Viewing and editing
+
+```bash
+npx loom-spec view
+```
+
+Opens a browser-based editor on `localhost:7777`. Changes are written back to the JSON files.
+
+## For AI agents
+
+See `.claude/skills/loom-spec/SKILL.md`. The skill explains when to read and update these files.
+
+## Format
+
+See the JSON Schemas shipped with the `loom-spec` package.

package/templates/.loom/diagrams/overview.flow.json

@@ -0,0 +1,8 @@
+{
+  "version": "1",
+  "id": "overview",
+  "title": "Overview",
+  "description": "Top-level architecture of this project.",
+  "nodes": [],
+  "edges": []
+}

package/templates/.loom/node-types.json

@@ -0,0 +1,56 @@
+{
+  "types": {
+    "ui": {
+      "label": "UI Component",
+      "description": "User-facing component (page, view, widget).",
+      "color": "#60a5fa",
+      "icon": "monitor",
+      "fields": [
+        { "name": "framework", "type": "string", "required": false }
+      ]
+    },
+    "service": {
+      "label": "Service",
+      "description": "Backend service, API, or business-logic module.",
+      "color": "#34d399",
+      "icon": "server",
+      "fields": [
+        { "name": "language", "type": "string", "required": false },
+        { "name": "runtime", "type": "string", "required": false }
+      ]
+    },
+    "data": {
+      "label": "Data Store",
+      "description": "Persistent or cached data location.",
+      "color": "#a78bfa",
+      "icon": "database",
+      "fields": [
+        {
+          "name": "engine",
+          "type": "enum",
+          "values": ["postgres", "mysql", "sqlite", "redis", "s3", "file", "memory"],
+          "required": false
+        },
+        { "name": "ttl_seconds", "type": "number", "required": false }
+      ]
+    },
+    "event": {
+      "label": "Event",
+      "description": "Asynchronous message or domain event.",
+      "color": "#fbbf24",
+      "icon": "zap",
+      "fields": [
+        { "name": "channel", "type": "string", "required": false }
+      ]
+    },
+    "external": {
+      "label": "External System",
+      "description": "Third-party service or system outside this codebase.",
+      "color": "#94a3b8",
+      "icon": "globe",
+      "fields": [
+        { "name": "url", "type": "string", "required": false }
+      ]
+    }
+  }
+}