logicsrc/docs/openspec-comparison.md
Anthony Ettinger 850cf5ea44
feat(agentstack): add @logicsrc/agentstack coordination module (#5)
* feat(agentstack): add @logicsrc/agentstack coordination module

AgentStack is the LogicSRC module for portable agent, task, payment, and
reputation coordination across Profullstack apps. Reference implementation of
the `agentstack` capability in the Profullstack Shared AppKit OpenSpec.

- packages/agentstack: DID helpers (did:coinpay:user/agent), DidTask model +
  lifecycle, AgentStack in-memory coordinator (agents, tasks, delegation,
  events), and a validated LogicSRC plugin definition. 9 vitest cases.
- Wire @logicsrc/agentstack into the root build chain (after plugin-core).
- docs/agentstack.md + mention in openspec-comparison.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs(agentstack): note dual-runtime support (Bun + Node.js + Workers + browser)

Matches the revised Shared AppKit PRD's Runtime Compatibility Strategy.
AgentStack is runtime-neutral (no Bun/Node-only APIs; time is injected).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-10 16:39:32 -07:00

32 lines
2.7 KiB
Markdown

# 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` as the canonical OpenStandards CLI. | `@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, AgentStack, AgentByte, Credential Sharing, 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 import
logicsrc openspec export --out logicsrc-openspec-summary.md
logicsrc --openspec-only task validate ./task.yaml
```
- `--openspec` enables OpenSpec.dev-compatible repo-local planning conventions where supported.
- `--openspec-only` restricts work to LogicSRC-published OpenSpec contracts.
- `openspec import` summarizes repo-local OpenSpec.dev-style specs and changes.
- `openspec export` writes a LogicSRC-readable markdown summary of those artifacts.