Skip to content
cccskills
FreePublished on GitHub

sdd-init

Initialize or resume the SDD Composy workspace of a repository: preview missing governance and OKF bundle files, apply only approved absent paths, persist the artifact language, and verify. Use when a project needs SDD set up or resumed — 'inicializar o SDD', 'configurar o workspace SDD', 'run init first', or when any SDD skill returned not_initialized. Do NOT use for generic CLAUDE.md or repository setup outside SDD Composy, or for other plugins' init.

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

See how to install

Files included (2)

  • SKILL.md3.9 KB
  • agents/openai.yaml211 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

SDD Init

Initialize or resume the repository contract shared by every supported runtime: governance files, the .claude -> .agents compatibility link, and the tasks/index.md OKF v0.2 bundle root. The bundled scripts/sdd_init.py helper owns safe-path checks, atomic no-overwrite publication, template rendering, conflict tokens, and verification; this skill owns intent, approval, routing, and reporting. <plugin-root> is the plugin root: ${CLAUDE_PLUGIN_ROOT} on Claude Code, and on the other runtimes the root resolved as described in references/runtime.md.

Inputs

  • Repository root: the current repository unless the user supplies another real directory.
  • Actor ID: ask when absent; it must use the provider:name form required by the helper (for example agent:sdd-init or human:paulo).
  • Language: pass --lang pt-BR or --lang en-US. If omitted on the first init, present the helper's choices result and ask the user to choose; do not generate artifacts yet. Only the approved apply persists the preference in .planning/sdd-composy/config.json; later runs reuse it.
  • Optional arguments: pass through the requested repository path, actor, and exact plan token.

Initialization reads only the packaged templates and the helper's allow-listed repository metadata.

Procedure

  1. Resolve the repository root and actor without changing project files.

  2. Run the preview and present its JSON result, including actions, conflicts, unchanged paths, and plan_token:

    python3 "<plugin-root>/scripts/sdd_init.py" plan <repo> --actor <actor> [--lang pt-BR|en-US]
    
  3. If conflicts are present, stop and explain them. A conflict on an existing regular file (for example the team's own AGENTS.md) is preserved, reported under preserved, and does not block INIT; symlinks, directories, and other unsafe destinations do. Applying a brownfield repository requires the exact plan_token returned by the preview; never invent or shorten it. Only after the user approves that exact plan, run:

    python3 "<plugin-root>/scripts/sdd_init.py" apply <repo> --actor <actor> --plan-token <plan_token> --lang <selected-language>
    

    With no conflicts, apply may use the plan output directly. The helper is idempotent and creates only absent paths.

  4. Verify with the same actor and report its JSON result:

    python3 "<plugin-root>/scripts/sdd_init.py" verify <repo> --actor <actor>
    

    A failed verification is a failed initialization: report missing, index_ok, claude_link_ok, and state_ok without repairing or overwriting files. When a governance file was preserved, tell the user to point it at the SDD rules in .agents/rules/.

Read when

  • references/runtime.md — the current runtime cannot be identified from the host's tools, or a claude_compatibility value other than symlink needs explaining.

Output

Return the helper's result and a concise summary: repository root, actor, created paths, conflicts, and verification status. Preserve the source commit and actor metadata the helper recorded. Do not interpret the repository or add architectural intent; mapping is a later stage.

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