Feature/automation improvements

[Adrianogb]

Relatório de Melhorias de Eficiência & Integração de IA

Contexto

Este relatório documenta as atualizações estruturais realizadas na arquitetura e CLI principal do Nébula Spec Kit. O objetivo primário destas mudanças é drásticamente reduzir o atrito e tempo gasto pelo usuário (humano ou Agente de IA) durante as repetições estruturais dos "ciclos de task" propostos pelo framework.

As mudanças introduzidas visam automatizar o "trabalho braçal" sem retirar a rígida camada de Governança na qual o projeto se fundamenta.

Melhorias Implementadas

1. Novo comando na CLI: nebu submit

Problema: De acordo com os guias (Manual/Uso.md), ao final de toda "Task", o desenvolvedor precisava rodar o Quality Gate, certificar-se do commit, anotar o hash via git rev-parse, abrir o arquivo Docs/tasks.md e apensá-lo na mão.
Solução: Foi criado o comando nebu submit "Mensagem" [--task-id TASK-1].
Este comando age como um wrapper inteligente:

• Aciona localmente o script de Quality Gate (analyze-consistency.sh) se existente no diretório target.
• Comita ("1 task = 1 commit") através do git staging area.
• Modifica silenciosamente via I/O o arquivo Docs/tasks.md, adicionando o log do Hash + Mensagem da task.
  Arquivos tocados:
• CLI/src/nebu_cli/commands/submit.py
• CLI/src/nebu_cli/__main__.py

2. Scaffold Inteligente de Agentes Iniciais

Problema: Documentos no Nébula como Manual/CreateAgents/Antigravity.md relatam a necessidade de criar locais como arquivos (.agents/rules, .agents/skills) para parametrizar IAs de agentes complexos dentro do repo alvo. Fazer isso na mão atrasava as criações.
Solução: Atualizamos a árvore de diretórios padrão carregada internamente no comando nebu start. A partir de agora, as pastas ocultas .agents, .agents/rules e .agents/skills serão pré-populadas em toda invocação inicial da CLI do Nébula.
Arquivos tocados:

• CLI/src/nebu_cli/specs/structure.py

3. Governança Via Pre-Commit Hook (Git Integrado)

Problema: A validação estrita do Markdown/Linter e regras do check-context ficavam atreladas aos processos remotos em GitHub Actions, exigindo que o dev efetuasse push para descobrir do erro de tipografia de um token markdown.
Solução: Geração do .pre-commit-config.yaml que impõe, em escopo de repo, a checagem via hook local do script tools/analyze-consistency.sh e o próprio MarkdownLint antes mesmo que o commit object seja criado. Assim a governança se torna "Fail-Fast".
Arquivos tocados:

• .pre-commit-config.yaml (Novo arquivo raiz)

Status

Melhorias aprovadas para incorporação via Branch Secundária (feature/automation-improvements), aguardando revisão oficial do autor do repositório via Pull Request/Push para fork.