GitHub - bonushora/surgical-dev-ops: core-methodologies · GitHub

/" data-turbo-transient="true" />

Skip to content

Search or jump to...

Search code, repositories, users, issues, pull requests...

-->

Search

Clear

Search syntax tips

Provide feedback

--><br>We read every piece of feedback, and take your input very seriously.

Include my email address so I can be contacted

Cancel

Submit feedback

Saved searches

Use saved searches to filter your results more quickly

-->

Name

Query

To see all available qualifiers, see our documentation.

Cancel

Create saved search

Sign in

/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up

Appearance settings

Resetting focus

You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.

Dismiss alert

{{ message }}

bonushora

surgical-dev-ops

Public

Notifications<br>You must be signed in to change notification settings

Fork

Star

main

BranchesTags

Go to file

CodeOpen more actions menu

Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit

History<br>38 Commits<br>38 Commits

docs

docs

protocols

protocols

APPLICABILITY_EN.md

APPLICABILITY_EN.md

CHANGELOG.md

CHANGELOG.md

CONTRIBUTING.md

CONTRIBUTING.md

LICENSE

LICENSE

README.md

README.md

README_EN.md

README_EN.md

ROADMAP.md

ROADMAP.md

View all files

Repository files navigation

Surgical DevOps 🚀

English version: README_EN.md

O Surgical DevOps é um ecossistema protocolar agnóstico e de código aberto criado para governar e padronizar o comportamento de Grandes Modelos de Linguagem (LLMs) durante o ciclo de desenvolvimento de software assistido por Inteligência Artificial.

Seu objetivo é reduzir regressões, evitar suposições indevidas sobre sistemas existentes e preservar conhecimento estratégico durante sessões longas de desenvolvimento.

O ecossistema opera através da combinação de dois protocolos principais:

BH-SEP (Safe Evolution Protocol): Define como a IA deve evoluir software existente com segurança. O protocolo estabelece inspeção antes de alteração (Inspect First), preservação do código funcional (Preserve Everything), alterações mínimas (Minimal Diff) e validação incremental.

BH-SDP (Snapshot & Delivery Protocol): Define mecanismos para preservação de estado e continuidade entre sessões. O protocolo transforma decisões, contratos, arquivos envolvidos e próximos passos em um artefato estruturado (Snapshot) capaz de transportar contexto de forma segura.

🔄 O Fluxo de Trabalho

O Modelo Tradicional (Caminho para Regressões)

[Prompt] ──> [Reconstrução Mental da IA] ──> [Reescrita de Código Existente] ──> [Bug / Regressão]

O Modelo Surgical DevOps (Evolução Segura e Persistente)

[Código Existente (Verdade)] ──> [Inspeção Completa] ──> [Diff Mínimo] ──> [Validação] ──> [Snapshot de Estado] ──> [Próximo Passo Seguro]

🏛️ Princípios Fundamentais do Ecossistema

Inspect First (Inspecione Primeiro):<br>O código existente representa a fonte de verdade. A IA não deve assumir contratos, rotas, dependências ou gerenciamento de estado sem inspeção adequada.

Preserve Everything (Preserve Tudo):<br>Código funcional deve ser preservado. Alterações fora do escopo solicitado aumentam risco e devem ser evitadas.

Minimal Diff (Diferença Mínima):<br>A evolução deve ocorrer através de intervenções pequenas, isoladas e rastreáveis, reduzindo impacto no histórico do projeto.

Validate Immediately (Valide Imediatamente):<br>Cada alteração deve ser seguida por validação antes da continuidade da próxima etapa.

Advance Incrementally (Avance Incrementalmente):<br>Problemas complexos devem ser divididos em passos menores e independentes.

State Continuity (Continuidade de Estado):<br>Decisões, contratos e pontos de parada relevantes devem ser preservados para permitir continuidade segura entre sessões.

🤖 Artefato: System Prompt Unificado para IA

Para iniciar uma sessão de desenvolvimento utilizando o ecossistema Surgical DevOps, copie e cole:

Acesse os protocolos:

https://raw.githubusercontent.com/bonushora/surgical-dev-ops/main/protocols/BH-SEP.md

https://raw.githubusercontent.com/bonushora/surgical-dev-ops/main/protocols/BH-SDP.md

Adote de forma estrita, combinada e silenciosa as diretrizes do BH-SEP (Safe Evolution Protocol) e BH-SDP (Snapshot & Delivery Protocol).

Opere como um Engenheiro de Software Sênior especializado no ecossistema do projeto.

Antes de qualquer alteração, inspecione o contexto existente. Preserve código funcional, aplique mudanças mínimas e valide cada etapa.

Caso exista um Snapshot de sessão anterior, utilize-o para recuperar o estado atual.

Após compreender os protocolos e o contexto inicial, confirme respondendo:

"BH-SEP E BH-SDP ATIVADOS 🚀"

Em seguida, solicite o arquivo ou contexto que deve ser inspecionado primeiro.

📚 Documentação

Protocolos principais:

BH-SEP — Safe Evolution...