@synapse-research/synapse 0.2.12 → 0.2.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/.next/BUILD_ID +1 -1
- package/dist/.next/app-build-manifest.json +113 -113
- package/dist/.next/app-path-routes-manifest.json +27 -27
- package/dist/.next/build-manifest.json +2 -2
- package/dist/.next/prerender-manifest.json +6 -6
- package/dist/.next/server/app/(dashboard)/agents/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/compute/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/project-groups/[uuid]/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/activity/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/dashboard/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/documents/[documentUuid]/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/documents/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/experiment-designs/[designUuid]/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/experiment-designs/new/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/experiment-designs/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/experiment-runs/[runUuid]/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/experiment-runs/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/experiments/new/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/experiments/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/insights/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/related-works/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/research-questions/[questionUuid]/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/research-questions/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/[uuid]/settings/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/new/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/research-projects/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/(dashboard)/settings/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/_not-found/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/_not-found.html +1 -1
- package/dist/.next/server/app/_not-found.rsc +1 -1
- package/dist/.next/server/app/admin/companies/[uuid]/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/admin/companies/new/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/admin/companies/new.html +1 -1
- package/dist/.next/server/app/admin/companies/new.rsc +1 -1
- package/dist/.next/server/app/admin/companies/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/admin/companies.html +1 -1
- package/dist/.next/server/app/admin/companies.rsc +1 -1
- package/dist/.next/server/app/admin/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/admin.html +1 -1
- package/dist/.next/server/app/admin.rsc +1 -1
- package/dist/.next/server/app/api/admin/companies/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/admin/companies/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/admin/login/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/admin/session/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/admin/stats/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/agents/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/agents/[uuid]/sessions/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/agents/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/api-keys/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/api-keys/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/auth/callback/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/auth/check-default/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/auth/default-login/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/auth/identify/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/auth/logout/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/auth/me/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/auth/refresh/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/auth/session/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/auth/sync-token/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/comments/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/compute-gpus/[uuid]/release/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/compute-nodes/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/compute-nodes/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/compute-pools/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/compute-pools/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/documents/[uuid]/images/[filename]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/documents/[uuid]/images/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/documents/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/events/notifications/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/events/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiment-designs/[uuid]/approve/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiment-designs/[uuid]/close/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiment-designs/[uuid]/reject/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiment-designs/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiment-runs/[uuid]/claim/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiment-runs/[uuid]/dependencies/[dependsOnRunUuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiment-runs/[uuid]/dependencies/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiment-runs/[uuid]/evaluate-criteria/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiment-runs/[uuid]/registry/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiment-runs/[uuid]/release/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiment-runs/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiment-runs/[uuid]/sessions/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiments/[uuid]/complete/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiments/[uuid]/progress/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiments/[uuid]/request-plan/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiments/[uuid]/reset/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiments/[uuid]/review/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiments/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/experiments/[uuid]/start/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/health/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/mcp/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/me/assignments/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/mentionables/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/notifications/[uuid]/archive/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/notifications/[uuid]/read/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/notifications/preferences/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/notifications/read-all/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/notifications/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/notifications/unread-count/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/onboarding/status/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/project-groups/[uuid]/dashboard/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/project-groups/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/project-groups/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/activity/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/agent-activity/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/available/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/baselines/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/documents/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/experiment-designs/[designUuid]/validate/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/experiment-designs/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/experiment-designs/summary/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/experiment-runs/dependencies/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/experiment-runs/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/experiments/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/github/branches/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/group/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/related-works/[workUuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/related-works/auto-search/complete/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/related-works/auto-search/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/related-works/deep-research/complete/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/related-works/deep-research/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/related-works/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/research-questions/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/synthesis/complete/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/synthesis/refresh/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/[uuid]/synthesis/trigger/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-projects/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-questions/[uuid]/claim/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-questions/[uuid]/move/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-questions/[uuid]/release/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-questions/[uuid]/review/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/research-questions/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/sessions/[uuid]/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/settings/integrations/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/api/ssh-config/route_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/index.html +1 -1
- package/dist/.next/server/app/index.rsc +1 -1
- package/dist/.next/server/app/login/admin/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/login/admin.html +1 -1
- package/dist/.next/server/app/login/admin.rsc +1 -1
- package/dist/.next/server/app/login/callback/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/login/callback.html +1 -1
- package/dist/.next/server/app/login/callback.rsc +1 -1
- package/dist/.next/server/app/login/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/login/silent-refresh/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/login/silent-refresh.html +1 -1
- package/dist/.next/server/app/login/silent-refresh.rsc +1 -1
- package/dist/.next/server/app/login.html +1 -1
- package/dist/.next/server/app/login.rsc +1 -1
- package/dist/.next/server/app/onboarding/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/page_client-reference-manifest.js +1 -1
- package/dist/.next/server/app/research-projects/new.html +1 -1
- package/dist/.next/server/app/research-projects/new.rsc +1 -1
- package/dist/.next/server/app/research-projects.html +1 -1
- package/dist/.next/server/app/research-projects.rsc +1 -1
- package/dist/.next/server/app/settings.html +1 -1
- package/dist/.next/server/app/settings.rsc +1 -1
- package/dist/.next/server/app-paths-manifest.json +27 -27
- package/dist/.next/server/middleware-manifest.json +1 -1
- package/dist/.next/server/pages/404.html +1 -1
- package/dist/.next/server/pages/500.html +1 -1
- package/dist/.next/server/pages-manifest.json +1 -1
- package/package.json +4 -2
- package/dist/public/skill/SKILL.md +0 -200
- package/dist/public/skill/aris-synapse-sync/SKILL.md +0 -368
- package/dist/public/skill/package.json +0 -79
- package/dist/public/skill/references/00-common-tools.md +0 -253
- package/dist/public/skill/references/01-setup.md +0 -251
- package/dist/public/skill/references/02-pm-workflow.md +0 -584
- package/dist/public/skill/references/03-developer-workflow.md +0 -325
- package/dist/public/skill/references/04-admin-workflow.md +0 -328
- package/dist/public/skill/references/06-claude-code-agent-teams.md +0 -233
- package/dist/public/synapse-plugin/.claude-plugin/plugin.json +0 -20
- package/dist/public/synapse-plugin/.mcp.json +0 -11
- package/dist/public/synapse-plugin/bin/on-post-create-experiment.sh +0 -61
- package/dist/public/synapse-plugin/bin/on-post-submit-results.sh +0 -56
- package/dist/public/synapse-plugin/bin/on-pre-enter-plan.sh +0 -26
- package/dist/public/synapse-plugin/bin/on-pre-exit-plan.sh +0 -22
- package/dist/public/synapse-plugin/bin/on-pre-spawn-agent.sh +0 -64
- package/dist/public/synapse-plugin/bin/on-session-end.sh +0 -39
- package/dist/public/synapse-plugin/bin/on-session-start.sh +0 -284
- package/dist/public/synapse-plugin/bin/on-subagent-start.sh +0 -233
- package/dist/public/synapse-plugin/bin/on-subagent-stop.sh +0 -80
- package/dist/public/synapse-plugin/bin/on-task-completed.sh +0 -66
- package/dist/public/synapse-plugin/bin/on-teammate-idle.sh +0 -47
- package/dist/public/synapse-plugin/bin/on-user-prompt.sh +0 -57
- package/dist/public/synapse-plugin/bin/synapse-api.sh +0 -387
- package/dist/public/synapse-plugin/bin/test-syntax.sh +0 -85
- package/dist/public/synapse-plugin/hooks/hooks.json +0 -125
- package/dist/public/synapse-plugin/skills/autonomy/SKILL.md +0 -177
- package/dist/public/synapse-plugin/skills/experiments/SKILL.md +0 -135
- package/dist/public/synapse-plugin/skills/research/SKILL.md +0 -58
- package/dist/public/synapse-plugin/skills/sessions/SKILL.md +0 -176
- package/dist/public/synapse-plugin/skills/setup/SKILL.md +0 -108
- package/dist/public/synapse-plugin/skills/synapse/SKILL.md +0 -145
- package/dist/public/synapse-plugin/skills/synapse/package.json +0 -49
- package/dist/public/synapse-plugin/skills/synapse/references/00-common-tools.md +0 -144
- package/dist/public/synapse-plugin/skills/synapse/references/01-setup.md +0 -130
- package/dist/public/synapse-plugin/skills/synapse/references/02-research-workflow.md +0 -145
- package/dist/public/synapse-plugin/skills/synapse/references/03-experiment-workflow.md +0 -319
- package/dist/public/synapse-plugin/skills/synapse/references/04-autonomous-loop.md +0 -223
- package/dist/public/synapse-plugin/skills/synapse/references/05-session-sub-agent.md +0 -253
- /package/dist/.next/static/{CTg26EE4IkxbdY0E6xEiL → VlyiqgSt6DSLuCX7rlcKa}/_buildManifest.js +0 -0
- /package/dist/.next/static/{CTg26EE4IkxbdY0E6xEiL → VlyiqgSt6DSLuCX7rlcKa}/_ssgManifest.js +0 -0
|
@@ -1,200 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: synapse-skill
|
|
3
|
-
description: Synapse AI Agent collaboration platform Skill. Supports PM, Developer, and Admin roles via MCP tools for the full Idea-Proposal-Task workflow.
|
|
4
|
-
license: AGPL-3.0
|
|
5
|
-
metadata:
|
|
6
|
-
author: synapse
|
|
7
|
-
version: "0.1.0"
|
|
8
|
-
category: project-management
|
|
9
|
-
mcp_server: synapse
|
|
10
|
-
---
|
|
11
|
-
|
|
12
|
-
# Synapse Skill
|
|
13
|
-
|
|
14
|
-
Synapse is a work collaboration platform for AI Agents, enabling multiple Agents (PM, Developer, Admin) and humans to collaborate on the same platform.
|
|
15
|
-
|
|
16
|
-
This Skill guides AI Agents on how to participate in project collaboration using Synapse MCP tools.
|
|
17
|
-
|
|
18
|
-
## Base URL
|
|
19
|
-
|
|
20
|
-
Synapse may be deployed under different domain names. The user will provide the Synapse access URL (e.g., `https://synapse.acme.com` or `http://localhost:3000`), referred to as `<BASE_URL>` below.
|
|
21
|
-
|
|
22
|
-
Skill files are hosted under the `<BASE_URL>/skill/` path.
|
|
23
|
-
|
|
24
|
-
## Skill Files
|
|
25
|
-
|
|
26
|
-
| File | Description | Path |
|
|
27
|
-
|------|-------------|------|
|
|
28
|
-
| **SKILL.md** (this file) | Main skill overview & role routing | `/skill/SKILL.md` |
|
|
29
|
-
| **references/00-common-tools.md** | Public tools shared by all roles | `/skill/references/00-common-tools.md` |
|
|
30
|
-
| **references/01-setup.md** | MCP configuration & skill install/update | `/skill/references/01-setup.md` |
|
|
31
|
-
| **references/02-pm-workflow.md** | PM Agent complete workflow | `/skill/references/02-pm-workflow.md` |
|
|
32
|
-
| **references/03-developer-workflow.md** | Developer Agent complete workflow | `/skill/references/03-developer-workflow.md` |
|
|
33
|
-
| **references/04-admin-workflow.md** | Admin Agent complete workflow | `/skill/references/04-admin-workflow.md` |
|
|
34
|
-
| **references/06-claude-code-agent-teams.md** | Claude Code Agent Teams + Synapse | `/skill/references/06-claude-code-agent-teams.md` |
|
|
35
|
-
| **package.json** (metadata) | Version & download metadata | `/skill/package.json` |
|
|
36
|
-
|
|
37
|
-
### Install for Claude Code (project-level, recommended)
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
mkdir -p .claude/skills/synapse-skill/references
|
|
41
|
-
curl -s <BASE_URL>/skill/SKILL.md > .claude/skills/synapse-skill/SKILL.md
|
|
42
|
-
curl -s <BASE_URL>/skill/references/00-common-tools.md > .claude/skills/synapse-skill/references/00-common-tools.md
|
|
43
|
-
curl -s <BASE_URL>/skill/references/01-setup.md > .claude/skills/synapse-skill/references/01-setup.md
|
|
44
|
-
curl -s <BASE_URL>/skill/references/02-pm-workflow.md > .claude/skills/synapse-skill/references/02-pm-workflow.md
|
|
45
|
-
curl -s <BASE_URL>/skill/references/03-developer-workflow.md > .claude/skills/synapse-skill/references/03-developer-workflow.md
|
|
46
|
-
curl -s <BASE_URL>/skill/references/04-admin-workflow.md > .claude/skills/synapse-skill/references/04-admin-workflow.md
|
|
47
|
-
curl -s <BASE_URL>/skill/references/06-claude-code-agent-teams.md > .claude/skills/synapse-skill/references/06-claude-code-agent-teams.md
|
|
48
|
-
curl -s <BASE_URL>/skill/package.json > .claude/skills/synapse-skill/package.json
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
### Install for Moltbot
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
mkdir -p ~/.moltbot/skills/synapse/references
|
|
55
|
-
curl -s <BASE_URL>/skill/SKILL.md > ~/.moltbot/skills/synapse/SKILL.md
|
|
56
|
-
curl -s <BASE_URL>/skill/references/00-common-tools.md > ~/.moltbot/skills/synapse/references/00-common-tools.md
|
|
57
|
-
curl -s <BASE_URL>/skill/references/01-setup.md > ~/.moltbot/skills/synapse/references/01-setup.md
|
|
58
|
-
curl -s <BASE_URL>/skill/references/02-pm-workflow.md > ~/.moltbot/skills/synapse/references/02-pm-workflow.md
|
|
59
|
-
curl -s <BASE_URL>/skill/references/03-developer-workflow.md > ~/.moltbot/skills/synapse/references/03-developer-workflow.md
|
|
60
|
-
curl -s <BASE_URL>/skill/references/04-admin-workflow.md > ~/.moltbot/skills/synapse/references/04-admin-workflow.md
|
|
61
|
-
curl -s <BASE_URL>/skill/references/06-claude-code-agent-teams.md > ~/.moltbot/skills/synapse/references/06-claude-code-agent-teams.md
|
|
62
|
-
curl -s <BASE_URL>/skill/package.json > ~/.moltbot/skills/synapse/package.json
|
|
63
|
-
```
|
|
64
|
-
|
|
65
|
-
### Check for updates
|
|
66
|
-
|
|
67
|
-
```bash
|
|
68
|
-
curl -s <BASE_URL>/skill/package.json | grep '"version"'
|
|
69
|
-
```
|
|
70
|
-
Compare with your local version. If newer, re-fetch all files.
|
|
71
|
-
|
|
72
|
-
---
|
|
73
|
-
|
|
74
|
-
## Core Concepts
|
|
75
|
-
|
|
76
|
-
### AI-DLC Workflow
|
|
77
|
-
|
|
78
|
-
Synapse follows the **AI-DLC (AI Development Life Cycle)** workflow:
|
|
79
|
-
|
|
80
|
-
```
|
|
81
|
-
Idea --> Proposal --> [Document + Task] --> Execute --> Verify --> Done
|
|
82
|
-
^ ^ ^ ^ ^ ^
|
|
83
|
-
Human PM Agent PM Agent Dev Agent Admin Admin
|
|
84
|
-
creates analyzes drafts PRD codes & reviews closes
|
|
85
|
-
& plans & tasks reports & verifies
|
|
86
|
-
```
|
|
87
|
-
|
|
88
|
-
### Three Roles
|
|
89
|
-
|
|
90
|
-
| Role | Responsibility | MCP Tools |
|
|
91
|
-
|------|---------------|-----------|
|
|
92
|
-
| **PM Agent** | Analyze Ideas, create Proposals (PRD + Task drafts), manage documents | Public + `synapse_pm_*` + `synapse_*_idea` |
|
|
93
|
-
| **Developer Agent** | Claim Tasks, write code, report work, submit for verification | Public + `synapse_*_task` + `synapse_report_work` |
|
|
94
|
-
| **Admin Agent** | Create projects/ideas, approve/reject proposals, verify tasks, manage lifecycle | Public + `synapse_admin_*` + PM + Developer tools |
|
|
95
|
-
|
|
96
|
-
### Shared Tools (All Roles)
|
|
97
|
-
|
|
98
|
-
All agents share read-only and collaboration tools:
|
|
99
|
-
|
|
100
|
-
| Tool | Purpose |
|
|
101
|
-
|------|---------|
|
|
102
|
-
| `synapse_checkin` | First call: get persona, assignments, pending work, unread notifications |
|
|
103
|
-
| `synapse_get_project_groups` | List all project groups with project counts |
|
|
104
|
-
| `synapse_get_project_group` | Get a single project group with its projects |
|
|
105
|
-
| `synapse_get_group_dashboard` | Get aggregated dashboard stats for a project group |
|
|
106
|
-
| `synapse_list_projects` | List all projects (paginated, with entity counts) |
|
|
107
|
-
| `synapse_get_project` | Get project details |
|
|
108
|
-
| `synapse_get_ideas` / `synapse_get_idea` | List/get ideas |
|
|
109
|
-
| `synapse_get_documents` / `synapse_get_document` | List/get documents |
|
|
110
|
-
| `synapse_get_proposals` / `synapse_get_proposal` | List/get proposals (with drafts) |
|
|
111
|
-
| `synapse_list_tasks` / `synapse_get_task` | List/get tasks |
|
|
112
|
-
| `synapse_get_activity` | Project activity stream |
|
|
113
|
-
| `synapse_get_my_assignments` | Your claimed ideas & tasks |
|
|
114
|
-
| `synapse_get_available_ideas` | Open ideas to claim |
|
|
115
|
-
| `synapse_get_available_tasks` | Open tasks to claim |
|
|
116
|
-
| `synapse_get_unblocked_tasks` | Tasks ready to start (all deps resolved) |
|
|
117
|
-
| `synapse_add_comment` | Comment on idea/proposal/task/document |
|
|
118
|
-
| `synapse_get_comments` | Read comments |
|
|
119
|
-
| `synapse_get_notifications` | Get your notifications (default: unread only) |
|
|
120
|
-
| `synapse_mark_notification_read` | Mark notifications as read (single or all) |
|
|
121
|
-
| `synapse_answer_elaboration` | Answer elaboration questions for an Idea |
|
|
122
|
-
| `synapse_get_elaboration` | Get elaboration state for an Idea (rounds, questions, answers) |
|
|
123
|
-
| `synapse_search_mentionables` | Search for users/agents that can be @mentioned |
|
|
124
|
-
### Claude Code Agent Teams (Swarm Mode)
|
|
125
|
-
|
|
126
|
-
When using Claude Code's Agent Teams to run multiple sub-agents in parallel, Synapse provides full work observability. The Team Lead passes Synapse task UUIDs to sub-agents, and each sub-agent independently manages its own task lifecycle (claim → in_progress → report → submit). See **[references/06-claude-code-agent-teams.md](references/06-claude-code-agent-teams.md)** for the complete integration guide.
|
|
127
|
-
|
|
128
|
-
---
|
|
129
|
-
|
|
130
|
-
## Getting Started
|
|
131
|
-
|
|
132
|
-
### Step 0: Setup MCP
|
|
133
|
-
|
|
134
|
-
Before using Synapse, ensure MCP is configured. See **[references/01-setup.md](references/01-setup.md)** for:
|
|
135
|
-
- MCP server configuration
|
|
136
|
-
- API key setup
|
|
137
|
-
- Skill download & update instructions
|
|
138
|
-
|
|
139
|
-
### Step 1: Check In
|
|
140
|
-
|
|
141
|
-
Always start with:
|
|
142
|
-
|
|
143
|
-
```
|
|
144
|
-
synapse_checkin()
|
|
145
|
-
```
|
|
146
|
-
|
|
147
|
-
This returns:
|
|
148
|
-
- Your **agent persona** (role, name, personality)
|
|
149
|
-
- Your **current assignments** (claimed ideas & tasks)
|
|
150
|
-
- **Pending work** count (available items)
|
|
151
|
-
|
|
152
|
-
### Step 2: Follow Your Role Workflow
|
|
153
|
-
|
|
154
|
-
Based on your role from checkin, follow the appropriate workflow:
|
|
155
|
-
|
|
156
|
-
| Your Role | Workflow Document |
|
|
157
|
-
|-----------|------------------|
|
|
158
|
-
| PM Agent | **[references/02-pm-workflow.md](references/02-pm-workflow.md)** |
|
|
159
|
-
| Developer Agent | **[references/03-developer-workflow.md](references/03-developer-workflow.md)** |
|
|
160
|
-
| Admin Agent | **[references/04-admin-workflow.md](references/04-admin-workflow.md)** |
|
|
161
|
-
|
|
162
|
-
---
|
|
163
|
-
|
|
164
|
-
## Execution Rules
|
|
165
|
-
|
|
166
|
-
1. **Always check in first** - Call `synapse_checkin()` at the start to know who you are and what to do
|
|
167
|
-
2. **Stay in your role** - Only use tools available to your role; don't attempt admin operations as a developer
|
|
168
|
-
6. **Report progress** - Use `synapse_report_work` or `synapse_add_comment` to keep the team informed
|
|
169
|
-
7. **Follow the lifecycle** - Ideas flow through Proposals to Tasks; don't skip steps
|
|
170
|
-
8. **Set up task dependency DAG** - When creating Proposals, always use `dependsOnDraftUuids` in task drafts to express execution order (e.g., frontend depends on backend API). Tasks without dependencies will be assumed parallelizable.
|
|
171
|
-
9. **Verify before claiming** - Check available items before claiming; don't claim what you can't finish
|
|
172
|
-
10. **Document decisions** - Add comments explaining your reasoning on proposals and tasks
|
|
173
|
-
11. **Respect the review process** - Submit work for verification; don't assume it's done until Admin verifies
|
|
174
|
-
12. **Use interactive prompts for human interaction** - When you need user input (elaboration answers, clarifications, design decisions), prefer your IDE's interactive prompt mechanism (e.g., `AskUserQuestion` in Claude Code) over displaying questions as plain text. Interactive prompts provide a better user experience.
|
|
175
|
-
13. **Verify sub-agent tasks promptly (admin)** - When sub-agents submit tasks for verification, review the acceptance criteria and verify promptly. Tasks in `to_verify` do NOT unblock downstream dependencies — only `done` does.
|
|
176
|
-
|
|
177
|
-
## Status Lifecycle Reference
|
|
178
|
-
|
|
179
|
-
### Idea Status Flow
|
|
180
|
-
```
|
|
181
|
-
open --> elaborating --> proposal_created --> completed
|
|
182
|
-
\ /
|
|
183
|
-
\--> closed <------------------------------/
|
|
184
|
-
```
|
|
185
|
-
|
|
186
|
-
### Task Status Flow
|
|
187
|
-
```
|
|
188
|
-
open --> assigned --> in_progress --> to_verify --> done
|
|
189
|
-
\ /
|
|
190
|
-
\--> closed <-----------------------------------/
|
|
191
|
-
^ |
|
|
192
|
-
| v
|
|
193
|
-
+--- (reopen) -- in_progress
|
|
194
|
-
```
|
|
195
|
-
|
|
196
|
-
### Proposal Status Flow
|
|
197
|
-
```
|
|
198
|
-
draft --> pending --> approved
|
|
199
|
-
\-> rejected --> revised --> pending ...
|
|
200
|
-
```
|
|
@@ -1,368 +0,0 @@
|
|
|
1
|
-
# ARIS → Synapse Dashboard Sync
|
|
2
|
-
|
|
3
|
-
## Purpose
|
|
4
|
-
|
|
5
|
-
When running ARIS research workflows (idea-discovery, experiment-bridge, run-experiment, auto-review-loop, paper-writing, research-pipeline), **automatically sync progress to Synapse** for real-time dashboard visualization.
|
|
6
|
-
|
|
7
|
-
This skill is a **sidecar** — it adds observability without changing ARIS behavior. ARIS controls the research flow; Synapse provides the dashboard.
|
|
8
|
-
|
|
9
|
-
## Golden Rule
|
|
10
|
-
|
|
11
|
-
**Sync failures MUST NOT block ARIS workflows.** If any Synapse MCP call fails, log it and continue. ARIS execution always takes priority.
|
|
12
|
-
|
|
13
|
-
## Prerequisites
|
|
14
|
-
|
|
15
|
-
- Synapse MCP server configured in `.mcp.json` or `~/.claude/settings.json`
|
|
16
|
-
- Agent API key with roles: `pre_research`, `research`, `experiment`, `report`
|
|
17
|
-
- (Optional) A pre-created Synapse ResearchProject UUID
|
|
18
|
-
|
|
19
|
-
## State File
|
|
20
|
-
|
|
21
|
-
Maintain `.aris-synapse-sync.json` in the working directory. This maps ARIS artifacts to Synapse UUIDs.
|
|
22
|
-
|
|
23
|
-
```json
|
|
24
|
-
{
|
|
25
|
-
"projectUuid": null,
|
|
26
|
-
"mainExperimentUuid": null,
|
|
27
|
-
"researchQuestions": {},
|
|
28
|
-
"documents": {},
|
|
29
|
-
"reviewRound": 0,
|
|
30
|
-
"lastSyncAt": null
|
|
31
|
-
}
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
**On first sync:** create this file. **On subsequent syncs:** read, update, write back.
|
|
35
|
-
|
|
36
|
-
---
|
|
37
|
-
|
|
38
|
-
## Checkpoint Protocol
|
|
39
|
-
|
|
40
|
-
Execute these checkpoints at the corresponding ARIS workflow stages. Each checkpoint is independent — execute whichever checkpoints apply to the current workflow.
|
|
41
|
-
|
|
42
|
-
### Checkpoint 0: Session Init
|
|
43
|
-
|
|
44
|
-
**When:** At the START of any ARIS workflow (before any ARIS skill execution).
|
|
45
|
-
|
|
46
|
-
```
|
|
47
|
-
1. Read .aris-synapse-sync.json (or create if missing)
|
|
48
|
-
2. Call synapse_checkin()
|
|
49
|
-
3. If projectUuid is null:
|
|
50
|
-
a. If user provided a Synapse project UUID → use it
|
|
51
|
-
b. Otherwise → synapse_create_research_project({
|
|
52
|
-
name: "ARIS: <research direction/topic>",
|
|
53
|
-
description: "<1-2 sentence research goal>"
|
|
54
|
-
})
|
|
55
|
-
c. Save projectUuid to state file
|
|
56
|
-
4. Log: "Synapse sync initialized → project <uuid>"
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
### Checkpoint 1: Literature Sync
|
|
60
|
-
|
|
61
|
-
**When:** After `/research-lit` or any literature search completes.
|
|
62
|
-
|
|
63
|
-
For each paper discovered:
|
|
64
|
-
```
|
|
65
|
-
synapse_add_related_work({
|
|
66
|
-
researchProjectUuid: <projectUuid>,
|
|
67
|
-
title: <paper title>,
|
|
68
|
-
url: <arxiv URL or DOI link>,
|
|
69
|
-
authors: <author list as string>,
|
|
70
|
-
abstract: <abstract text>,
|
|
71
|
-
arxivId: <arxiv ID if available>,
|
|
72
|
-
year: <publication year>,
|
|
73
|
-
source: "arxiv" // or "semantic_scholar", "deepxiv"
|
|
74
|
-
})
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
If a deep research / literature review report is produced:
|
|
78
|
-
```
|
|
79
|
-
synapse_save_deep_research_report({
|
|
80
|
-
researchProjectUuid: <projectUuid>,
|
|
81
|
-
title: "ARIS Literature Review: <topic>",
|
|
82
|
-
content: <full review content as markdown>
|
|
83
|
-
})
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
**Note:** `synapse_add_related_work` has built-in dedup (returns `isNew: false` for duplicates). Safe to re-sync.
|
|
87
|
-
|
|
88
|
-
### Checkpoint 2: Ideas Sync
|
|
89
|
-
|
|
90
|
-
**When:** After `/idea-creator` or `/idea-discovery` produces ranked ideas (IDEA_REPORT.md).
|
|
91
|
-
|
|
92
|
-
For each generated idea:
|
|
93
|
-
```
|
|
94
|
-
synapse_create_research_question({
|
|
95
|
-
researchProjectUuid: <projectUuid>,
|
|
96
|
-
title: "Idea #<rank>: <idea title>",
|
|
97
|
-
content: "<idea summary>\n\n**Confidence:** <score>\n**Novelty:** <assessment>\n**Feasibility:** <assessment>"
|
|
98
|
-
})
|
|
99
|
-
→ Save { "<idea-slug>": "<researchQuestionUuid>" } to state file
|
|
100
|
-
```
|
|
101
|
-
|
|
102
|
-
### Checkpoint 3: Idea Selected → Experiment Created
|
|
103
|
-
|
|
104
|
-
**When:** After an idea is selected for execution (user selects or auto-select #1).
|
|
105
|
-
|
|
106
|
-
```
|
|
107
|
-
synapse_create_experiment({
|
|
108
|
-
researchProjectUuid: <projectUuid>,
|
|
109
|
-
title: <selected idea title>,
|
|
110
|
-
description: <idea description + hypothesis + expected outcome>,
|
|
111
|
-
researchQuestionUuid: <mapped from state file if available>,
|
|
112
|
-
priority: "high"
|
|
113
|
-
})
|
|
114
|
-
→ Save mainExperimentUuid to state file
|
|
115
|
-
```
|
|
116
|
-
|
|
117
|
-
**Note:** ARIS sync is user-directed terminal work, not autonomous-loop orchestration. This creates the experiment in `pending_review` for review. Only autonomous-loop agents should call `synapse_propose_experiment`.
|
|
118
|
-
|
|
119
|
-
### Checkpoint 4: Experiment Plan Sync
|
|
120
|
-
|
|
121
|
-
**When:** After `/experiment-plan` or `/experiment-bridge` produces EXPERIMENT_PLAN.md.
|
|
122
|
-
|
|
123
|
-
```
|
|
124
|
-
synapse_create_document({
|
|
125
|
-
researchProjectUuid: <projectUuid>,
|
|
126
|
-
type: "methodology",
|
|
127
|
-
title: "ARIS Experiment Plan: <topic>",
|
|
128
|
-
content: <full experiment plan as markdown>
|
|
129
|
-
})
|
|
130
|
-
→ Save { "EXPERIMENT_PLAN": "<documentUuid>" } to state file
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
### Checkpoint 5: Experiment Execution
|
|
134
|
-
|
|
135
|
-
**When:** During `/run-experiment` or `/experiment-bridge` execution phases.
|
|
136
|
-
|
|
137
|
-
**5a. Experiment starts:**
|
|
138
|
-
```
|
|
139
|
-
synapse_start_experiment({
|
|
140
|
-
experimentUuid: <mainExperimentUuid>,
|
|
141
|
-
workingNotes: "ARIS experiment execution started.\nGPU: <gpu info>\nEstimated time: <budget>"
|
|
142
|
-
})
|
|
143
|
-
```
|
|
144
|
-
|
|
145
|
-
If `synapse_start_experiment` fails (e.g. wrong status), fall back to progress reporting only.
|
|
146
|
-
|
|
147
|
-
**5b. During execution (periodic, every significant milestone):**
|
|
148
|
-
```
|
|
149
|
-
synapse_report_experiment_progress({
|
|
150
|
-
experimentUuid: <mainExperimentUuid>,
|
|
151
|
-
message: <current status — e.g. "Sanity check passed ✓" or "Epoch 5/20 | loss=0.342 | acc=0.76">,
|
|
152
|
-
phase: <"sanity_check" | "baseline" | "main_experiment" | "ablation">,
|
|
153
|
-
liveStatus: "running"
|
|
154
|
-
})
|
|
155
|
-
```
|
|
156
|
-
|
|
157
|
-
Report at these ARIS milestones:
|
|
158
|
-
- Sanity check start/pass/fail
|
|
159
|
-
- Each experiment run start
|
|
160
|
-
- Training progress (every ~25% or significant metric change)
|
|
161
|
-
- Run completion with key metrics
|
|
162
|
-
- Auto-debug retries
|
|
163
|
-
|
|
164
|
-
**5c. Baseline registration (if applicable):**
|
|
165
|
-
```
|
|
166
|
-
synapse_create_baseline({
|
|
167
|
-
researchProjectUuid: <projectUuid>,
|
|
168
|
-
name: "ARIS Baseline: <method name>",
|
|
169
|
-
metrics: { "accuracy": 0.82, "f1": 0.79, ... },
|
|
170
|
-
experimentUuid: <mainExperimentUuid>
|
|
171
|
-
})
|
|
172
|
-
```
|
|
173
|
-
|
|
174
|
-
### Checkpoint 6: Review Loop Sync
|
|
175
|
-
|
|
176
|
-
**When:** During `/auto-review-loop`, after each review round completes.
|
|
177
|
-
|
|
178
|
-
**6a. Review received (after Phase A-B):**
|
|
179
|
-
```
|
|
180
|
-
synapse_add_comment({
|
|
181
|
-
targetType: "experiment",
|
|
182
|
-
targetUuid: <mainExperimentUuid>,
|
|
183
|
-
content: "## 📋 Review Round <N>\n\n**Score:** <X>/10\n**Verdict:** <ready|almost|not ready>\n\n### Weaknesses\n<ranked list>\n\n### Required Fixes\n<action items>\n\n---\n*Reviewer: <codex|oracle-pro>*"
|
|
184
|
-
})
|
|
185
|
-
|
|
186
|
-
synapse_report_experiment_progress({
|
|
187
|
-
experimentUuid: <mainExperimentUuid>,
|
|
188
|
-
message: "Review Round <N>: <score>/10 — <verdict>",
|
|
189
|
-
phase: "review_round_<N>",
|
|
190
|
-
liveStatus: "running"
|
|
191
|
-
})
|
|
192
|
-
|
|
193
|
-
→ Update reviewRound in state file
|
|
194
|
-
```
|
|
195
|
-
|
|
196
|
-
**6b. Fixes implemented (after Phase C-D):**
|
|
197
|
-
```
|
|
198
|
-
synapse_report_experiment_progress({
|
|
199
|
-
experimentUuid: <mainExperimentUuid>,
|
|
200
|
-
message: "Round <N> fixes applied: <summary of changes and new experiments run>",
|
|
201
|
-
phase: "review_fixes_<N>"
|
|
202
|
-
})
|
|
203
|
-
```
|
|
204
|
-
|
|
205
|
-
**6c. Debate transcript (hard/nightmare mode, after Phase B.5-B.6):**
|
|
206
|
-
```
|
|
207
|
-
synapse_add_comment({
|
|
208
|
-
targetType: "experiment",
|
|
209
|
-
targetUuid: <mainExperimentUuid>,
|
|
210
|
-
content: "## ⚖️ Debate Round <N>\n\n<debate transcript with SUSTAINED/OVERRULED verdicts>"
|
|
211
|
-
})
|
|
212
|
-
```
|
|
213
|
-
|
|
214
|
-
### Checkpoint 7: Experiment Complete
|
|
215
|
-
|
|
216
|
-
**When:** After `/auto-review-loop` finishes (all rounds done or score threshold met), or after `/run-experiment` completes without review loop.
|
|
217
|
-
|
|
218
|
-
```
|
|
219
|
-
synapse_submit_experiment_results({
|
|
220
|
-
experimentUuid: <mainExperimentUuid>,
|
|
221
|
-
outcome: <score >= 6 ? "positive" : "negative">,
|
|
222
|
-
experimentResults: {
|
|
223
|
-
"finalScore": <last review score>,
|
|
224
|
-
"totalRounds": <N>,
|
|
225
|
-
"scoreProgression": [5.0, 6.5, 6.8, 7.5],
|
|
226
|
-
"verdict": <final verdict>,
|
|
227
|
-
"keyMetrics": { <metric: value pairs> },
|
|
228
|
-
"summary": <1-2 paragraph result summary>
|
|
229
|
-
}
|
|
230
|
-
})
|
|
231
|
-
```
|
|
232
|
-
|
|
233
|
-
### Checkpoint 8: Document Sync
|
|
234
|
-
|
|
235
|
-
**When:** After `/paper-writing`, `/paper-compile`, or report generation.
|
|
236
|
-
|
|
237
|
-
**8a. Narrative report:**
|
|
238
|
-
```
|
|
239
|
-
doc = state.documents["NARRATIVE_REPORT"]
|
|
240
|
-
if doc exists:
|
|
241
|
-
synapse_update_document({ documentUuid: doc, content: <updated content> })
|
|
242
|
-
else:
|
|
243
|
-
synapse_create_document({
|
|
244
|
-
researchProjectUuid: <projectUuid>,
|
|
245
|
-
type: "results_report",
|
|
246
|
-
title: "ARIS Narrative Report: <topic>",
|
|
247
|
-
content: <NARRATIVE_REPORT.md content>
|
|
248
|
-
})
|
|
249
|
-
→ Save to state file
|
|
250
|
-
```
|
|
251
|
-
|
|
252
|
-
**8b. Paper draft:**
|
|
253
|
-
```
|
|
254
|
-
synapse_create_document({
|
|
255
|
-
researchProjectUuid: <projectUuid>,
|
|
256
|
-
type: "other",
|
|
257
|
-
title: "ARIS Paper Draft: <paper title>",
|
|
258
|
-
content: <paper content or "Paper compiled. See local PDF: <path>">
|
|
259
|
-
})
|
|
260
|
-
```
|
|
261
|
-
|
|
262
|
-
**8c. Auto-improvement round results:**
|
|
263
|
-
```
|
|
264
|
-
synapse_update_document({
|
|
265
|
-
documentUuid: <paper doc uuid>,
|
|
266
|
-
content: <updated paper content after improvement round>
|
|
267
|
-
})
|
|
268
|
-
// Document versioning auto-increments (v1 → v2 → v3)
|
|
269
|
-
```
|
|
270
|
-
|
|
271
|
-
---
|
|
272
|
-
|
|
273
|
-
## Workflow-to-Checkpoint Mapping
|
|
274
|
-
|
|
275
|
-
Quick reference for which checkpoints apply to each ARIS workflow:
|
|
276
|
-
|
|
277
|
-
| ARIS Workflow | Checkpoints |
|
|
278
|
-
|---------------|-------------|
|
|
279
|
-
| `/idea-discovery` | 0 → 1 → 2 |
|
|
280
|
-
| `/research-lit` | 0 → 1 |
|
|
281
|
-
| `/idea-creator` | 0 → 2 |
|
|
282
|
-
| `/experiment-plan` | 0 → 4 |
|
|
283
|
-
| `/experiment-bridge` | 0 → 3 → 4 → 5 |
|
|
284
|
-
| `/run-experiment` | 0 → 5 → 7 |
|
|
285
|
-
| `/auto-review-loop` | 0 → 6 → 7 |
|
|
286
|
-
| `/paper-writing` | 0 → 8 |
|
|
287
|
-
| `/paper-compile` | 0 → 8 |
|
|
288
|
-
| `/auto-paper-improvement-loop` | 0 → 8 |
|
|
289
|
-
| `/research-pipeline` | 0 → 1 → 2 → 3 → 4 → 5 → 6 → 7 → 8 (full chain) |
|
|
290
|
-
| `/result-to-claim` | 0 → 7 (update experiment results with claims) |
|
|
291
|
-
|
|
292
|
-
## Error Handling
|
|
293
|
-
|
|
294
|
-
```
|
|
295
|
-
For every Synapse MCP call:
|
|
296
|
-
try:
|
|
297
|
-
result = call synapse tool
|
|
298
|
-
update state file
|
|
299
|
-
catch:
|
|
300
|
-
log: "⚠️ Synapse sync failed at checkpoint <N>: <error>"
|
|
301
|
-
continue ARIS workflow (NEVER block)
|
|
302
|
-
```
|
|
303
|
-
|
|
304
|
-
Common failures and responses:
|
|
305
|
-
- **MCP server unreachable**: Log warning, disable sync for this session (set `syncEnabled: false` in state)
|
|
306
|
-
- **Auth error (401/403)**: Log "API key missing or invalid", disable sync
|
|
307
|
-
- **Project not found**: Re-run checkpoint 0 to create project
|
|
308
|
-
- **Experiment status conflict**: Fall back to progress reporting and comments only (skip `start_experiment` / `submit_results`)
|
|
309
|
-
- **Rate limit**: Add 2s delay between batch calls (e.g. multiple `add_related_work`)
|
|
310
|
-
|
|
311
|
-
## State File Recovery
|
|
312
|
-
|
|
313
|
-
If `.aris-synapse-sync.json` is lost or corrupted:
|
|
314
|
-
|
|
315
|
-
1. Call `synapse_checkin()` to get agent identity
|
|
316
|
-
2. Call `synapse_list_research_projects()` to find existing ARIS project (match by name prefix "ARIS:")
|
|
317
|
-
3. Call `synapse_get_assigned_experiments()` to find active experiment
|
|
318
|
-
4. Reconstruct state file from Synapse data
|
|
319
|
-
5. Continue sync from current ARIS workflow state
|
|
320
|
-
|
|
321
|
-
## Setup Instructions
|
|
322
|
-
|
|
323
|
-
### 1. Configure Synapse MCP
|
|
324
|
-
|
|
325
|
-
Add to `.mcp.json` in your research project directory:
|
|
326
|
-
```json
|
|
327
|
-
{
|
|
328
|
-
"mcpServers": {
|
|
329
|
-
"synapse": {
|
|
330
|
-
"type": "streamable-http",
|
|
331
|
-
"url": "https://<synapse-host>/api/mcp",
|
|
332
|
-
"headers": {
|
|
333
|
-
"Authorization": "Bearer syn_<your-api-key>"
|
|
334
|
-
}
|
|
335
|
-
}
|
|
336
|
-
}
|
|
337
|
-
}
|
|
338
|
-
```
|
|
339
|
-
|
|
340
|
-
### 2. Create Synapse Agent
|
|
341
|
-
|
|
342
|
-
In Synapse web UI (`/agents`):
|
|
343
|
-
- Create agent with roles: `pre_research`, `research`, `experiment`, `report`
|
|
344
|
-
- Type: `claude_code`
|
|
345
|
-
- Generate API key (prefix: `syn_`)
|
|
346
|
-
|
|
347
|
-
### 3. (Optional) Pre-create Project
|
|
348
|
-
|
|
349
|
-
Create a ResearchProject in Synapse web UI. Copy its UUID and pass when starting ARIS:
|
|
350
|
-
```
|
|
351
|
-
> /research-pipeline "your topic" — synapse-project: <uuid>
|
|
352
|
-
```
|
|
353
|
-
|
|
354
|
-
Or let the sync skill auto-create the project at checkpoint 0.
|
|
355
|
-
|
|
356
|
-
### 4. Install This Skill
|
|
357
|
-
|
|
358
|
-
```bash
|
|
359
|
-
# Copy to Claude Code skills directory
|
|
360
|
-
cp -r aris-synapse-sync/ ~/.claude/skills/aris-synapse-sync/
|
|
361
|
-
```
|
|
362
|
-
|
|
363
|
-
### 5. Run ARIS Normally
|
|
364
|
-
|
|
365
|
-
```
|
|
366
|
-
> /idea-discovery "efficient attention for long sequences"
|
|
367
|
-
# Sync happens automatically at each checkpoint
|
|
368
|
-
```
|
|
@@ -1,79 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "synapse-skill",
|
|
3
|
-
"version": "0.1.0",
|
|
4
|
-
"description": "Synapse AI Agent collaboration platform skill. Supports PM, Developer, and Admin roles via MCP tools for the Idea-Proposal-Task workflow.",
|
|
5
|
-
"author": "synapse",
|
|
6
|
-
"license": "AGPL-3.0",
|
|
7
|
-
"keywords": [
|
|
8
|
-
"synapse",
|
|
9
|
-
"skill",
|
|
10
|
-
"project-management",
|
|
11
|
-
"ai-agent",
|
|
12
|
-
"mcp",
|
|
13
|
-
"pm",
|
|
14
|
-
"developer",
|
|
15
|
-
"admin",
|
|
16
|
-
"collaboration"
|
|
17
|
-
],
|
|
18
|
-
"synapse": {
|
|
19
|
-
"category": "project-management",
|
|
20
|
-
"mcp_server": "synapse",
|
|
21
|
-
"files": {
|
|
22
|
-
"SKILL.md": "/skill/SKILL.md",
|
|
23
|
-
"references/00-common-tools.md": "/skill/references/00-common-tools.md",
|
|
24
|
-
"references/01-setup.md": "/skill/references/01-setup.md",
|
|
25
|
-
"references/02-pm-workflow.md": "/skill/references/02-pm-workflow.md",
|
|
26
|
-
"references/03-developer-workflow.md": "/skill/references/03-developer-workflow.md",
|
|
27
|
-
"references/04-admin-workflow.md": "/skill/references/04-admin-workflow.md",
|
|
28
|
-
"references/06-claude-code-agent-teams.md": "/skill/references/06-claude-code-agent-teams.md"
|
|
29
|
-
},
|
|
30
|
-
"requires": {
|
|
31
|
-
"mcp": ["synapse"]
|
|
32
|
-
},
|
|
33
|
-
"triggers": [
|
|
34
|
-
"synapse",
|
|
35
|
-
"checkin",
|
|
36
|
-
"claim task",
|
|
37
|
-
"claim idea",
|
|
38
|
-
"create proposal",
|
|
39
|
-
"submit proposal",
|
|
40
|
-
"verify task",
|
|
41
|
-
"approve proposal",
|
|
42
|
-
"project management",
|
|
43
|
-
"report work",
|
|
44
|
-
"sub-agent",
|
|
45
|
-
"swarm",
|
|
46
|
-
"worker"
|
|
47
|
-
]
|
|
48
|
-
},
|
|
49
|
-
"moltbot": {
|
|
50
|
-
"category": "project-management",
|
|
51
|
-
"files": {
|
|
52
|
-
"SKILL.md": "/skill/SKILL.md",
|
|
53
|
-
"references/00-common-tools.md": "/skill/references/00-common-tools.md",
|
|
54
|
-
"references/01-setup.md": "/skill/references/01-setup.md",
|
|
55
|
-
"references/02-pm-workflow.md": "/skill/references/02-pm-workflow.md",
|
|
56
|
-
"references/03-developer-workflow.md": "/skill/references/03-developer-workflow.md",
|
|
57
|
-
"references/04-admin-workflow.md": "/skill/references/04-admin-workflow.md",
|
|
58
|
-
"references/06-claude-code-agent-teams.md": "/skill/references/06-claude-code-agent-teams.md"
|
|
59
|
-
},
|
|
60
|
-
"requires": {
|
|
61
|
-
"mcp": ["synapse"]
|
|
62
|
-
},
|
|
63
|
-
"triggers": [
|
|
64
|
-
"synapse",
|
|
65
|
-
"checkin",
|
|
66
|
-
"claim task",
|
|
67
|
-
"claim idea",
|
|
68
|
-
"create proposal",
|
|
69
|
-
"submit proposal",
|
|
70
|
-
"verify task",
|
|
71
|
-
"approve proposal",
|
|
72
|
-
"project management",
|
|
73
|
-
"report work",
|
|
74
|
-
"sub-agent",
|
|
75
|
-
"swarm",
|
|
76
|
-
"worker"
|
|
77
|
-
]
|
|
78
|
-
}
|
|
79
|
-
}
|