sifter-ai/sifter / .agents/skills/sdd-remote
sdd-remote
VerifiedRemote sync workflow for Story Driven Development. Use this skill whenever the user asks to pull from remote, push changes to SDD Flow, enrich drafts, update local state from remote, publish local updates, process remote drafts, or run a remote worker job (enrich or sync). Also trigger on phrases like "sdd pull", "sdd push", "sync with SDD Flow", "enrich this CR", "push the remote updates", "pull the latest specs".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.6 KB |
SKILL.md
View on GitHub---
name: sdd-remote
description: >
Remote sync workflow for Story Driven Development. Use this skill whenever
the user asks to pull from remote, push changes to SDD Flow, enrich drafts,
update local state from remote, publish local updates, process remote drafts,
or run a remote worker job (enrich or sync). Also trigger on phrases like
"sdd pull", "sdd push", "sync with SDD Flow", "enrich this CR",
"push the remote updates", "pull the latest specs".
license: MIT
compatibility: Requires sdd CLI (npm i -g @applica-software-guru/sdd)
allowed-tools: Bash(sdd:*) Read Glob Grep
metadata:
author: applica-software-guru
version: "1.2"
---
# SDD Remote — Pull, Enrich, Push
## Purpose
Synchronize local SDD docs with remote updates (from the SDD Flow server), enrich draft content,
and publish the enriched result to remote in active states.
This skill also applies when a **remote worker job** is dispatched from SDD Flow — the worker
runs these same workflows on behalf of the user.
## Detection
This workflow applies when:
- `.sdd/config.yaml` exists in the project root with a `remote:` section configured
- The user asks to update local state from remote, pull pending CRs/bugs/docs,
enrich drafts, or push pending remote updates
- A remote worker job prompt instructs you to follow this workflow
Before any pull/push operation, check remote configuration with `sdd remote status`.
## Workflows
### Enrich workflow — Change Request
Follow this sequence to enrich a draft CR:
1. Pull remote drafts:
```bash
sdd pull --crs-only
```
2. Generate the draft TODO list:
```bash
sdd drafts
```
3. Enrich the draft with technical details, acceptance criteria, edge cases, and any
relevant information from the project documentation and comments.
4. Transition the enriched CR from `draft` to `pending`:
```bash
sdd mark-drafts-enriched
```
5. Push the enriched content:
```bash
sdd push
```
### Enrich workflow — Document
Follow this sequence to enrich a document (e.g. a feature spec):
1. Pull remote drafts:
```bash
sdd pull --docs-only
```
2. Locate the document file in `product/` or `system/` and update its content with the
enriched version.
3. Push the enriched content:
```bash
sdd push
```
If the document was in `draft` status, it transitions to `new` on the server.
### Sync workflow — Project-level
Full project sync when the user asks for "the latest" or "pull everything and implement":
1. Pull the latest specs:
```bash
sdd pull
```
2. Run the `sdd` skill — it handles the full loop: open bugs, pending CRs, documentation
sync, code implementation, mark-synced, and commit.
3. Push the local updates:
```bash
sdd push
```
## Rules
1. Always check remote configuration before pull/push (`sdd remote status`). Fail gracefully if not configured.
2. Do not use `sdd push --all` unless the user explicitly asks for a full reseed.
3. If pull reports conflicts, do not overwrite local files blindly. Report the conflicts and ask how to proceed.
4. Do not edit files inside `.sdd/` manually.
5. Keep status transitions explicit: enrich first, then `sdd mark-drafts-enriched`, then push.
6. **Always commit before pushing** when the sync workflow makes code changes. Push should never carry uncommitted work.
## Related commands
- `sdd remote init` — Configure remote for this project
- `sdd remote status` — Show remote config + connectivity
- `sdd pull` / `sdd pull --crs-only` / `sdd pull --docs-only`
- `sdd drafts` — List draft items to enrich
- `sdd mark-drafts-enriched` — Transition enriched drafts to pending
- `sdd sync` / `sdd mark-synced` — Local sync loop (see `sdd` skill)
- `sdd push` — Publish local updates to remote
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |