opensddrag 0.1.0

package/src/templates/skill-md.js

@@ -0,0 +1,74 @@
+export function renderSkillMd({ slug, serverUrl }) {
+  return `# OpenSddRag — SDD + Harness
+
+This project is connected to the OpenSddRag Harness (${serverUrl}).
+Use the MCP tools below to follow Spec-Driven Development with persistent semantic memory.
+
+## Project slug: \`${slug}\`
+
+Always pass \`project_slug: "${slug}"\` to scope queries to this project.
+Use \`project_slug: "*"\` to search across all projects.
+
+## When to start
+
+Before implementing any feature, always check for existing specs:
+
+\`\`\`
+search_semantic(query="<topic>", project_slug="${slug}")
+\`\`\`
+
+Then pick the right SDD skill:
+
+\`\`\`
+suggest_skill(objective="<your goal>", project_slug="${slug}")
+\`\`\`
+
+## SDD Skills (built-in)
+
+| Skill | When to use |
+|-------|-------------|
+| \`sdd:propose\` | Before anything — write intent and scope |
+| \`sdd:spec\` | After proposal — Purpose / Requirements / Scenarios |
+| \`sdd:design\` | After spec — technical decisions and trade-offs |
+| \`sdd:tasks\` | After design — decompose into atomic tasks (<4h each) |
+| \`sdd:apply\` | Execute tasks against spec acceptance criteria |
+| \`sdd:full-flow\` | Run all steps above in sequence |
+
+## Memory tools
+
+| Tool | Purpose |
+|------|---------|
+| \`search_semantic\` | Find specs/tasks by topic (semantic) |
+| \`recall_episodes\` | Find past agent actions (episodic memory) |
+| \`get_working_context\` | See the active session and focused artifacts |
+| \`update_working_context\` | Set which artifacts you are working on |
+| \`record_trace\` | Log what you just did (builds episodic memory) |
+
+## SDD Artifact tools
+
+| Tool | Purpose |
+|------|---------|
+| \`create_artifact\` | Create proposal / spec / change / task / design |
+| \`read_artifact\` | Read a specific artifact by name |
+| \`list_artifacts\` | List artifacts with type/status filters |
+| \`update_artifact\` | Update content or status |
+| \`validate_artifact\` | Check spec structure |
+| \`link_artifacts\` | Link artifacts (implements / depends_on / relates_to) |
+| \`get_relationships\` | Get related artifacts |
+
+## Full flow example
+
+\`\`\`
+1. suggest_skill(objective="add JWT authentication", project_slug="${slug}")
+   → returns "sdd:full-flow"
+
+2. get_skill(name="sdd:propose", project_slug="${slug}")
+   → follow the steps to create a proposal
+
+3. create_artifact(name="auth-jwt-proposal", type="proposal",
+     content="...", project_slug="${slug}")
+
+4. ... follow sdd:spec, sdd:design, sdd:tasks, sdd:apply
+\`\`\`
+`;
+}

package/src/templates/skills/index.js

@@ -0,0 +1,192 @@
+export function getSkills(slug, serverUrl) {
+  const note = `> **MCP server:** \`opensddrag\` (${serverUrl}) | **project_slug:** \`${slug}\`
+> **Available tools:** \`create_artifact\`, \`read_artifact\`, \`list_artifacts\`, \`update_artifact\`, \`validate_artifact\`, \`link_artifacts\`, \`get_relationships\`, \`search_semantic\`, \`recall_episodes\`, \`get_working_context\`, \`update_working_context\`, \`record_trace\`
+> If these tools are not in your active tool list, the \`opensddrag\` MCP server is not connected — STOP and inform the user.\n\n`;
+
+  return [
+    {
+      name: "opensddrag-propose",
+      content: `# OpenSddRag — Propose
+${note}Creates a named **change** with a proposal artifact: Why, What Changes, Capabilities, Impact.
+Entry point for every new feature or bugfix. No code is written here.
+After this, /opsr:spec and /opsr:design become available.
+
+**Run:** \`/opsr:propose <change-name or description>\`
+
+**Creates:** \`<change-name>-proposal\` artifact in database.
+**Unlocks:** /opsr:spec, /opsr:design
+`,
+    },
+    {
+      name: "opensddrag-spec",
+      content: `# OpenSddRag — Spec
+${note}Creates spec artifacts for each capability listed in the proposal.
+Uses SHALL/MUST language. Each requirement MUST have Scenarios with WHEN/THEN format.
+
+**New capability** → full spec (Purpose + Requirements + Scenarios)
+**Modified capability** → delta spec (ADDED / MODIFIED / REMOVED / RENAMED sections)
+
+**Run:** \`/opsr:spec <change-name>\`
+
+**Requires:** proposal artifact in database.
+**Creates:** \`<change-name>-<capability>-spec\` artifact(s) in database.
+**Unlocks:** /opsr:design (when all capabilities have specs)
+`,
+    },
+    {
+      name: "opensddrag-design",
+      content: `# OpenSddRag — Design
+${note}Creates a design document: Context, Goals, Decisions (with alternatives), Architecture, Risks, Migration.
+Must read proposal and all specs from the database as context.
+
+**Run:** \`/opsr:design <change-name>\`
+
+**Requires:** proposal + specs in database.
+**Creates:** \`<change-name>-design\` artifact in database.
+**Unlocks:** /opsr:tasks
+`,
+    },
+    {
+      name: "opensddrag-tasks",
+      content: `# OpenSddRag — Tasks
+${note}Decomposes specs + design into atomic task artifacts, each < 4 hours.
+Each task has: Goal, Acceptance criteria (referencing REQ-NNN), Dependencies.
+Tasks are individual database artifacts — NOT a single markdown file.
+
+**Run:** \`/opsr:tasks <change-name>\`
+
+**Requires:** proposal + specs + design in database.
+**Creates:** \`<change-name>-task-<N>\` artifacts in database.
+**Unlocks:** /opsr:apply
+`,
+    },
+    {
+      name: "opensddrag-apply",
+      content: `# OpenSddRag — Apply
+${note}Implements tasks one at a time, reading ALL planning artifacts (proposal + specs + design) as context.
+Marks tasks active → archived in the database after implementation.
+Must validate each task against spec acceptance criteria before marking done.
+
+**Run:** \`/opsr:apply <change-name>\`
+
+**Requires:** all planning artifacts + pending tasks in database.
+**Updates:** task status in database (draft → active → archived).
+**After all tasks:** run /opsr:verify then /opsr:archive.
+`,
+    },
+    {
+      name: "opensddrag-verify",
+      content: `# OpenSddRag — Verify
+${note}Read-only validation of the implementation against spec requirements and design decisions.
+Produces a report with CRITICAL / WARNING / SUGGESTION severity levels.
+
+Checks:
+- **Completeness**: all tasks done, all REQ-NNN implemented
+- **Correctness**: all spec scenarios covered
+- **Coherence**: implementation follows design decisions
+
+**Run:** \`/opsr:verify <change-name>\`
+
+**Requires:** all artifacts in database + implementation in codebase.
+**Output:** verification report (no artifacts modified).
+`,
+    },
+    {
+      name: "opensddrag-sync",
+      content: `# OpenSddRag — Sync
+${note}Merges delta specs (ADDED/MODIFIED/REMOVED/RENAMED) into main specs stored in the database.
+Called automatically during /opsr:archive when delta specs exist.
+
+Delta operations:
+- **ADDED** → append new requirement to main spec
+- **MODIFIED** → apply partial updates (not wholesale replace)
+- **REMOVED** → delete requirement + add Reason/Migration note
+- **RENAMED** → rename requirement heading
+
+**Run:** \`/opsr:sync <change-name>\`
+
+**Requires:** delta specs + main specs in database.
+**Updates:** main spec artifacts in database.
+`,
+    },
+    {
+      name: "opensddrag-archive",
+      content: `# OpenSddRag — Archive
+${note}Finalizes a completed change: validates, syncs delta specs, archives all artifacts.
+
+Steps:
+1. Validate artifact and task completion (warns if incomplete)
+2. Sync delta specs to main specs (if any)
+3. Mark all change artifacts as archived in database
+
+**Run:** \`/opsr:archive <change-name>\`
+
+**Requires:** all tasks completed (or user confirmation to archive anyway).
+**Updates:** all change artifacts to status=archived in database.
+`,
+    },
+    {
+      name: "opensddrag-explore",
+      content: `# OpenSddRag — Explore
+${note}Thinking mode — investigates ideas WITHOUT implementing any code.
+Reads existing specs and codebase for context. Can create artifacts to capture insights.
+
+Rules:
+- NEVER write application code
+- NEVER create implementation files
+- MAY create/update OpenSddRag artifacts to capture decisions
+
+Use when: thinking through options, investigating feasibility, comparing approaches.
+Transition: when ready → /opsr:propose <name>
+
+**Run:** \`/opsr:explore <topic or question>\`
+`,
+    },
+    {
+      name: "opensddrag-continue",
+      content: `# OpenSddRag — Continue
+${note}Creates the NEXT SINGLE artifact in the dependency chain and stops.
+Unlike /opsr:flow, creates one artifact per invocation.
+
+Dependency order: proposal → specs → design → tasks
+
+Use when: stepping through the SDD flow one artifact at a time.
+
+**Run:** \`/opsr:continue <change-name>\`
+`,
+    },
+    {
+      name: "opensddrag-status",
+      content: `# OpenSddRag — Status
+${note}Shows current state of all in-progress changes: artifact completion, task progress, recent activity.
+
+Reads from MCP server — no local files.
+
+**Run:** \`/opsr:status\` or \`/opsr:status <change-name>\`
+`,
+    },
+    {
+      name: "opensddrag-flow",
+      content: `# OpenSddRag — Flow
+${note}Runs the complete SDD flow end-to-end: propose → spec → design → tasks → apply → archive.
+ALL artifacts saved to database via MCP — no local files created.
+
+Use when: implementing a feature from scratch in a single session.
+
+**Run:** \`/opsr:flow <feature description>\`
+`,
+    },
+    {
+      name: "opensddrag-search",
+      content: `# OpenSddRag — Search
+${note}Semantic search over the SDD knowledge base using pgvector similarity.
+Always run this BEFORE starting new work to find existing specs and decisions.
+
+Searches: this project first, then all projects if no results.
+Also recalls past agent actions (episodic memory).
+
+**Run:** \`/opsr:search <natural language query>\`
+`,
+    },
+  ];
+}