Skip to content
cccskills
FreePublished on GitHub

sdd-sync

Reconcile SDD Composy task Markdown and the JSON projection: read-only inspect and plan, then apply only with an explicit authority and the CONFIRM-SDD-SYNC token. Use when task contracts and operational state diverged — 'sincronizar as tarefas', 'o JSON das tasks está desatualizado', 'markdown and json disagree'. Do NOT use to list or advance tasks (sdd-tasks), for a status overview (sdd-status), or to simulate approval.

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md2.9 KB
  • agents/openai.yaml191 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

SDD Sync

Synchronize the human task contracts (Markdown) and the operational JSON projection without silently selecting an authority, through the bundled scripts/sdd_sync.py helper.

Language: when an operation emits human-facing summaries, run scripts/sdd_language.py <repo-root> and use the persisted language; on not_initialized, return it with next_action: run_init. Localization rules: references/language.md.

Operations

  • inspect <markdown-root> <state> [--root] — read-only; reports stable, deterministic classifications, including conflicts and malformed inputs.
  • plan <markdown-root> <state> [--root] — read-only; produces the exact plan and input fingerprints that an apply must consume.
  • apply <markdown-root> <state> <plan-json-path> --authority markdown|json --confirmation-token <plan token> [--root] — the only mutating operation. The token is the plan's confirmation_token (CONFIRM-SDD-SYNC-<digest>), bound to the exact input fingerprints; any change to either side invalidates it. It requires explicit human approval of the selected authority; never infer approval from a plan, a clean inspection, or model confidence. The CLI forwards the plan JSON to the guarded apply API; it implements no second algorithm.

Present the inspect and plan results before asking for approval. A stale plan, changed input, invalid authority, token that does not match the plan (CONFIRM-SDD-SYNC-<digest>), symlink, malformed artifact, invalid merged projection, or unresolved conflict stops the operation. Markdown authority never moves lifecycle state: a state divergence is resolved with sdd_tasks.py transition or JSON authority; conflicts are never overwritten silently. After apply, report the helper's post-apply verification and the exact paths changed. The helper owns repository confinement, temporary files, atomic replacement, unknown-field preservation, and deterministic output; do not duplicate those policies here.

Read when

  • references/synchronization.md — before apply, or to explain a classification.

Output

Return the operation, repository-bound paths, classifications, selected authority (if any), approval status, plan/token status, verification result, and next permitted action.

Safety: Do not commit, push, or publish. Do not read or expose .env, credentials, tokens, private keys, certificates, or fleet environment files. Full contract: references/safety.md.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Accessibility auditing and remediation skill for Vue 3 + Reka UI. Use when reviewing components, verifying WCAG 2.1 AA, fixing ARIA issues, or validating keyboard navigation in Reka UI components.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Infraestrutura para IA — GPU, servidores MCP, gateway de LLM, pipeline de inferência, custo de token, cache semântico e observabilidade de modelo. Use quando o usuário disser "GPU", "MCP server", "LLM", "inferência", "modelo", "gateway de IA", "custo de token", "rate limit da API de IA", "self-host de modelo".

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Escreve texto alternativo e descrição de imagem para peças de rede social. Use quando o usuário disser "alt text", "texto alternativo", "descrição da imagem", "acessibilidade da peça", "descrever para leitor de tela", ou automaticamente antes de qualquer publicação. Obrigatório em todas as peças — em carrossel, um por slide.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Organiza, compara e seleciona entre as variações geradas, e publica a grade de comparação como Artifact para aprovação do time. Use quando o usuário disser "qual dessas", "comparar as variações", "escolher a melhor", "mostrar as opções", "montar grade de aprovação", ou após qualquer lote de geração. Selecionar é trabalho, não detalhe.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

Aumenta resolução e qualidade de imagem via Freepik/Magnific, ou orienta o processo manual quando não há chave. Use quando o usuário disser "upscale", "melhorar a resolução", "a imagem está pixelada", "Magnific", "Freepik", "aumentar a imagem", "imagem pequena demais". Gasta crédito — exige confirmação.

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

CI/CD e automação — GitHub Actions, Terraform, OpenTofu, Ansible, n8n. Use quando o usuário disser "pipeline", "CI/CD", "GitHub Actions", "workflow", "terraform", "ansible", "n8n", "automatizar", "deploy automático", "IaC".

The English summary is being prepared. Showing the original description.

pwdev-solucoes/pwdev-claude-marketplace3Updated Oct 15, 2026

See all skills by pwdev-solucoes

Report a problem with this skill