Add OpenSpec comparison and compatibility mode

README.md

@@ -35,6 +35,7 @@ scripts/
 ```bash
 npm install
 npm run check
+npm --workspace @logicsrc/cli run dev -- --openspec agentswarm --yolo --repo profullstack/logicsrc
 npm --workspace @logicsrc/cli run dev -- --openspec-only task validate packages/schemas/fixtures/task.yaml
 npm --workspace @logicsrc/cli run dev -- agentswarm --yolo --repo profullstack/logicsrc
 npm --workspace @logicsrc/cli run dev -- plugins

apps/logicsrc-web/src/main.ts

@@ -42,11 +42,45 @@ const agentByteSurfaces = [
 const pages = [
   { id: "docs", title: "Docs", detail: "Specification guides, CLI conventions, schemas, plugin contracts, SDK conventions, and MCP resources." },
   { id: "blog", title: "Blog", detail: "Project notes for LogicSRC, AgentSwarm, AgentByte, OpenSpec workflows, and reference implementations." },
+  { id: "openspec", title: "OpenSpec", detail: "Comparison and compatibility notes for OpenSpec.dev-style repo-local specs, proposals, tasks, and deltas." },
   { id: "about", title: "About", detail: "LogicSRC is the Profullstack open specification project for human and AI agent coordination." },
   { id: "terms", title: "Terms", detail: "Draft terms will cover acceptable use, reference implementation boundaries, and hosted-product responsibilities." },
   { id: "privacy", title: "Privacy", detail: "Draft privacy notes will cover telemetry, audit events, identity data, and hosted-product data boundaries." }
 ];
 
+const comparisonRows = [
+  {
+    area: "Primary scope",
+    logicsrc: "Open coordination standards for humans, agents, plugins, payments, hosted products, and reference implementations.",
+    openspec: "Lightweight spec-driven planning for code changes and agent work."
+  },
+  {
+    area: "Artifacts",
+    logicsrc: "Schemas, plugin manifests, task/agent/run docs, event contracts, SDKs, MCP resources, CLI/TUI/PWA/API surfaces.",
+    openspec: "Repo-local specs, proposals, design docs, implementation tasks, and spec deltas."
+  },
+  {
+    area: "Agents",
+    logicsrc: "Agent profiles, runs, audit logs, model routing, AgentSwarm orchestration, and provider-neutral execution records.",
+    openspec: "Persistent requirements and planning context for coding agents."
+  },
+  {
+    area: "CLI",
+    logicsrc: "`logicsrc`, `commandboard`, `cb`, and `sh1pt logicsrc ...`.",
+    openspec: "`@fission-ai/openspec` plus native coding-tool slash command integrations."
+  },
+  {
+    area: "MCP",
+    logicsrc: "Standards MCP server with schemas, validation tools, and prompts.",
+    openspec: "OpenSpec.dev currently positions itself as no-MCP."
+  },
+  {
+    area: "Compatibility",
+    logicsrc: "`--openspec` should read/write OpenSpec.dev-style repo-local planning artifacts where useful.",
+    openspec: "Can remain the lightweight planning layer inside repos."
+  }
+];
+
 document.querySelector<HTMLDivElement>("#app")!.innerHTML = `
   <main class="shell">
     <aside class="rail">
@@ -65,6 +99,7 @@ document.querySelector<HTMLDivElement>("#app")!.innerHTML = `
         <a href="#cli">CLI</a>
         <a href="/docs">Docs</a>
         <a href="/blog">Blog</a>
+        <a href="/openspec">OpenSpec</a>
         <a href="/about">About</a>
         <a href="/terms">Terms</a>
         <a href="/privacy">Privacy</a>
@@ -182,6 +217,36 @@ sh1pt logicsrc --openspec-only \\
         </div>
       </section>
 
+      <section id="openspec" class="band">
+        <div class="section-head">
+          <h2>LogicSRC vs OpenSpec.dev</h2>
+          <p>OpenSpec.dev is adjacent: it focuses on lightweight repo-local planning artifacts. LogicSRC is the broader coordination standard and can support OpenSpec-compatible workflows.</p>
+        </div>
+        <div class="compare-table" role="table" aria-label="LogicSRC and OpenSpec.dev comparison">
+          <div class="compare-row compare-head" role="row">
+            <strong role="columnheader">Area</strong>
+            <strong role="columnheader">LogicSRC.com</strong>
+            <strong role="columnheader">OpenSpec.dev</strong>
+          </div>
+          ${comparisonRows.map((row) => `
+            <div class="compare-row" role="row">
+              <strong role="cell">${row.area}</strong>
+              <p role="cell">${row.logicsrc}</p>
+              <p role="cell">${row.openspec}</p>
+            </div>
+          `).join("")}
+        </div>
+        <div class="cli-panel compare-note">
+          <h2>Compatibility Mode</h2>
+          <pre><code>logicsrc --openspec agentswarm --yolo \\
+  --repo profullstack/logicsrc
+
+sh1pt logicsrc --openspec \\
+  agentswarm --yolo</code></pre>
+          <p><code>--openspec</code> enables OpenSpec.dev-compatible repo-local specs, proposals, tasks, and deltas where supported. <code>--openspec-only</code> restricts work to LogicSRC-published contracts.</p>
+        </div>
+      </section>
+
       <section id="reference" class="band">
         <div class="section-head">
           <h2>Reference Implementations</h2>
@@ -236,6 +301,6 @@ if (window.location.pathname === "/agentbyte") {
 }
 
 const pageRoute = window.location.pathname.slice(1);
-if (["docs", "blog", "about", "terms", "privacy"].includes(pageRoute)) {
+if (["docs", "blog", "openspec", "about", "terms", "privacy"].includes(pageRoute)) {
   document.querySelector(`#${pageRoute}`)?.scrollIntoView();
 }

apps/logicsrc-web/src/styles.css

@@ -333,6 +333,47 @@ pre {
   background: #f0c56a;
 }
 
+.compare-table {
+  display: grid;
+  overflow: hidden;
+  border: 1px solid #d6ddd2;
+  border-radius: 8px;
+  background: #ffffff;
+}
+
+.compare-row {
+  display: grid;
+  grid-template-columns: minmax(8rem, 0.6fr) repeat(2, minmax(0, 1fr));
+  border-top: 1px solid #e1e6dc;
+}
+
+.compare-row:first-child {
+  border-top: 0;
+}
+
+.compare-row > * {
+  margin: 0;
+  padding: 0.85rem;
+  border-left: 1px solid #e1e6dc;
+  line-height: 1.45;
+}
+
+.compare-row > *:first-child {
+  border-left: 0;
+}
+
+.compare-head {
+  background: #eef7f3;
+}
+
+.compare-row p {
+  color: #58615b;
+}
+
+.compare-note {
+  margin-top: 0.75rem;
+}
+
 @media (max-width: 980px) {
   .primitive-grid,
   .implementation-list {
@@ -380,6 +421,19 @@ pre {
     grid-template-columns: 1fr;
   }
 
+  .compare-row {
+    grid-template-columns: 1fr;
+  }
+
+  .compare-row > * {
+    border-left: 0;
+    border-top: 1px solid #e1e6dc;
+  }
+
+  .compare-row > *:first-child {
+    border-top: 0;
+  }
+
   h1 {
     font-size: 2.4rem;
   }

docs/cli.md

@@ -20,9 +20,12 @@ Product CLIs may embed LogicSRC as a sub-command:
 
 ```bash
 sh1pt logicsrc <resource> <action> [options]
+sh1pt logicsrc --openspec <resource> <action> [options]
 sh1pt logicsrc --openspec-only <resource> <action> [options]
 ```
 
+`--openspec` enables OpenSpec.dev-compatible repo-local planning conventions where supported, such as specs, proposals, implementation tasks, and requirement deltas.
+
 `--openspec-only` means the workflow must stay inside LogicSRC-published schemas, CLI/TUI conventions, SDK contracts, MCP resources/tools/prompts, PWA states, and curl-compatible API surfaces.
 
 Required v1 command groups:
@@ -48,6 +51,7 @@ AgentSwarm master-agent command:
 
 ```bash
 logicsrc agentswarm --yolo --repo profullstack/logicsrc --agents reproduce,patch,review
+logicsrc --openspec agentswarm --yolo --repo profullstack/logicsrc
 sh1pt logicsrc --openspec-only agentswarm --yolo --repo profullstack/logicsrc
 ```
 

docs/openspec-comparison.md

@@ -0,0 +1,29 @@
+# LogicSRC and OpenSpec.dev
+
+Status: working comparison
+
+OpenSpec.dev appears focused on lightweight, repo-local feature planning for coding agents: specs, proposals, design notes, tasks, and requirement deltas that live alongside code. LogicSRC is broader: an open coordination standard for humans, AI agents, plugins, payments, hosted products, SDKs, MCP servers, CLIs, TUIs, PWAs, and API/curl surfaces.
+
+The projects can be complementary. LogicSRC should support an `--openspec` compatibility mode for teams that already use OpenSpec.dev-style planning artifacts.
+
+| Area | LogicSRC | OpenSpec.dev |
+|---|---|---|
+| Primary scope | Open coordination standards for humans, AI agents, plugins, payments, hosted products, and reference implementations. | Lightweight spec-driven planning framework for code changes and agent work. |
+| Main artifact shape | Versioned schemas, plugin manifests, event contracts, task/agent/run documents, SDK contracts, MCP resources, CLI/TUI/PWA/API surfaces. | Repo-local specs, proposals, design docs, tasks, and spec deltas. |
+| Agent relationship | Agent profiles, runs, audit logs, model routing, AgentSwarm orchestration, and provider-neutral execution records. | Planning layer that gives coding agents persistent requirements and change context. |
+| CLI direction | `logicsrc`, plus compatible product aliases and `sh1pt logicsrc ...`. | `@fission-ai/openspec` CLI and slash-command integrations with coding tools. |
+| MCP | LogicSRC has a standards MCP server and should expose resources, tools, and prompts. | Site states "No MCP" as a product trait. |
+| SDK/API | Planned Rust, Bun, Node, Python, curl, and PWA surfaces with matching contracts. | Focus appears to be repo workflow and agent planning artifacts rather than a cross-language SDK/API standard. |
+| Plugins | Plugin manifest standard plus CoinPay, uGig, sh1pt, AgentByte, and future integration specs. | Integrates with many coding agents and editors; plugin-contract scope is not the main positioning. |
+| Compatibility idea | `logicsrc --openspec` reads/writes OpenSpec.dev-style specs/proposals/tasks where useful. | Can remain the lightweight planning layer inside repos. |
+
+## CLI Flags
+
+```bash
+logicsrc --openspec agentswarm --yolo --repo profullstack/logicsrc
+logicsrc --openspec-only task validate ./task.yaml
+sh1pt logicsrc --openspec agentswarm --yolo --repo profullstack/logicsrc
+```
+
+- `--openspec` enables OpenSpec.dev-compatible repo-local planning conventions where supported.
+- `--openspec-only` restricts work to LogicSRC-published OpenSpec contracts.

packages/cli/src/index.ts

@@ -16,6 +16,7 @@ program
   .name(commandName)
   .aliases(["commandboard", "cb"])
   .description("LogicSRC OpenSpec CLI for schemas, boards, tasks, agents, payments, plugins, and TUI.")
+  .option("--openspec", "Enable OpenSpec.dev-compatible repo-local specs, proposals, tasks, and deltas where supported.")
   .option("--openspec-only", "Restrict workflows to LogicSRC OpenSpec schemas, SDKs, MCP, CLI, TUI, and PWA contracts.")
   .version("0.1.0");
 
@@ -152,6 +153,7 @@ program
         master_agent: "agentswarm-master",
         slave_agents: slaveAgents,
         repo: options.repo ?? null,
+        openspec_compatible: program.opts().openspec || process.env.LOGICSRC_OPENSPEC_COMPAT === "1",
         openspec_only: program.opts().openspecOnly || process.env.LOGICSRC_OPENSPEC_ONLY === "1"
       },
       "json"