jarvis-ai-framework 1.0.0

package/skills/eng-arch-c4/assets/example-container.md

@@ -0,0 +1,104 @@
+# Container - Sistema JARVIS
+
+## Visão Geral
+
+Diagrama de containers do JARVIS Framework, mostrando as aplicações, datastores e como eles se comunicam internamente.
+
+## Diagrama
+
+```plantuml
+@startuml C4_Container
+!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml
+
+LAYOUT_TOP_DOWN()
+LAYOUT_WITH_LEGEND()
+
+title Sistema JARVIS - Diagrama de Containers
+
+' === PERSONAS ===
+Person(dev, "Desenvolvedor", "Usa o framework via IDE")
+
+' === SISTEMA PRINCIPAL ===
+System_Boundary(jarvis, "JARVIS Framework") {
+
+    ' === CLI/INTERFACE ===
+    Container(cli, "CLI Interface", "Shell/Bash", "Comandos e workflows executáveis")
+    Container(skills, "Skills Engine", "Markdown/MCP", "Processador de skills e prompts")
+    
+    ' === CORE ===
+    Container(templates, "Template Engine", "Markdown", "Templates de documentação")
+    Container(rules, "Rules Engine", "Markdown", "Regras e validações")
+    Container(workflows, "Workflow Engine", "Markdown", "Fluxos de trabalho automatizados")
+    
+    ' === DADOS ===
+    ContainerDb(sessions, "Sessions", "Filesystem", "Sessões de trabalho ativas")
+    ContainerDb(docs, "Documentation", "Filesystem", "Documentação gerada")
+    ContainerDb(env, "ENV Config", "Markdown", "Configurações do ambiente")
+}
+
+' === SISTEMAS EXTERNOS ===
+System_Ext(ide, "IDE", "Windsurf/Cursor/Claude")
+System_Ext(jira, "Jira", "Task Management")
+System_Ext(gitlab, "GitLab", "Version Control")
+
+' === RELACIONAMENTOS ENTRADA ===
+Rel(dev, ide, "Usa", "GUI")
+Rel(ide, cli, "Invoca comandos", "MCP/Terminal")
+
+' === RELACIONAMENTOS INTERNOS ===
+Rel(cli, skills, "Carrega", "Filesystem")
+Rel(skills, templates, "Usa", "Filesystem")
+Rel(skills, rules, "Valida com", "Filesystem")
+Rel(skills, workflows, "Executa", "Filesystem")
+Rel(skills, env, "Lê config", "Filesystem")
+
+Rel(workflows, sessions, "Cria/Atualiza", "Filesystem")
+Rel(workflows, docs, "Gera", "Filesystem")
+
+' === RELACIONAMENTOS EXTERNOS ===
+Rel(workflows, jira, "Sincroniza", "REST API")
+Rel(workflows, gitlab, "Cria MR", "REST API")
+
+@enduml
+```
+
+## Elementos
+
+| Elemento | Tipo | Descrição | Tecnologia |
+|----------|------|-----------|------------|
+| CLI Interface | Container | Comandos e workflows executáveis | Shell/Bash |
+| Skills Engine | Container | Processador de skills e prompts | Markdown/MCP |
+| Template Engine | Container | Templates de documentação | Markdown |
+| Rules Engine | Container | Regras e validações | Markdown |
+| Workflow Engine | Container | Fluxos de trabalho automatizados | Markdown |
+| Sessions | Datastore | Sessões de trabalho ativas | Filesystem |
+| Documentation | Datastore | Documentação gerada | Filesystem |
+| ENV Config | Datastore | Configurações do ambiente | Markdown |
+
+## Relacionamentos
+
+| De | Para | Descrição | Protocolo |
+|----|------|-----------|-----------|
+| IDE | CLI Interface | Invoca comandos | MCP/Terminal |
+| CLI Interface | Skills Engine | Carrega | Filesystem |
+| Skills Engine | Template Engine | Usa | Filesystem |
+| Skills Engine | Rules Engine | Valida com | Filesystem |
+| Skills Engine | Workflow Engine | Executa | Filesystem |
+| Skills Engine | ENV Config | Lê config | Filesystem |
+| Workflow Engine | Sessions | Cria/Atualiza | Filesystem |
+| Workflow Engine | Documentation | Gera | Filesystem |
+| Workflow Engine | Jira | Sincroniza | REST API |
+| Workflow Engine | GitLab | Cria MR | REST API |
+
+## ADRs Relacionados
+
+| ADR | Título | Impacto |
+|-----|--------|---------|
+| ADR-001 | Uso de Markdown para documentação | Define formato de templates |
+| ADR-003 | Estrutura de pastas por domínio | Define organização de containers |
+
+## Changelog
+
+### [2025-01-24] - v1.0
+- Criação: Diagrama inicial de containers
+- Motivo: Documentar arquitetura interna do JARVIS

package/skills/eng-arch-c4/assets/example-context.md

@@ -0,0 +1,81 @@
+# Context - Sistema JARVIS
+
+## Visão Geral
+
+O JARVIS é um framework de produtividade para agentes de IA que auxilia equipes de engenharia e produto na criação de documentação, especificações técnicas e workflows automatizados.
+
+## Diagrama
+
+```plantuml
+@startuml C4_Context
+!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
+
+LAYOUT_TOP_DOWN()
+LAYOUT_WITH_LEGEND()
+
+title Sistema JARVIS - Diagrama de Contexto
+
+' === PERSONAS ===
+Person(dev, "Desenvolvedor", "Engenheiro de software que implementa features")
+Person(tech_lead, "Tech Lead", "Lidera decisões técnicas e arquiteturais")
+Person(pm, "Product Manager", "Define requisitos e prioridades de produto")
+
+' === SISTEMA PRINCIPAL ===
+System(jarvis, "JARVIS Framework", "Framework de produtividade para agentes de IA que automatiza documentação, especificações e workflows")
+
+' === SISTEMAS EXTERNOS ===
+System_Ext(jira, "Jira", "Gerenciamento de tarefas e histórias")
+System_Ext(gitlab, "GitLab", "Controle de versão e CI/CD")
+System_Ext(slack, "Slack", "Comunicação do time")
+System_Ext(ide, "IDE (Windsurf/Cursor)", "Ambiente de desenvolvimento")
+
+' === RELACIONAMENTOS ===
+Rel(dev, jarvis, "Usa para criar specs e código", "CLI/IDE")
+Rel(tech_lead, jarvis, "Usa para documentar arquitetura", "CLI/IDE")
+Rel(pm, jarvis, "Usa para criar PRDs e histórias", "CLI/IDE")
+
+Rel(jarvis, jira, "Sincroniza tarefas", "REST API")
+Rel(jarvis, gitlab, "Cria branches e MRs", "REST API")
+Rel(jarvis, slack, "Envia notificações", "Webhook")
+Rel_L(ide, jarvis, "Integra via extensões", "MCP")
+
+@enduml
+```
+
+## Elementos
+
+| Elemento | Tipo | Descrição | Tecnologia |
+|----------|------|-----------|------------|
+| JARVIS Framework | Sistema | Framework de produtividade para agentes de IA | Markdown, Shell, MCP |
+| Desenvolvedor | Pessoa | Engenheiro que implementa features | - |
+| Tech Lead | Pessoa | Lidera decisões técnicas | - |
+| Product Manager | Pessoa | Define requisitos de produto | - |
+| Jira | Sistema Externo | Gerenciamento de tarefas | REST API |
+| GitLab | Sistema Externo | Controle de versão | REST API |
+| Slack | Sistema Externo | Comunicação | Webhook |
+| IDE | Sistema Externo | Ambiente de desenvolvimento | MCP |
+
+## Relacionamentos
+
+| De | Para | Descrição | Protocolo |
+|----|------|-----------|-----------|
+| Desenvolvedor | JARVIS | Usa para criar specs e código | CLI/IDE |
+| Tech Lead | JARVIS | Usa para documentar arquitetura | CLI/IDE |
+| Product Manager | JARVIS | Usa para criar PRDs e histórias | CLI/IDE |
+| JARVIS | Jira | Sincroniza tarefas | REST API |
+| JARVIS | GitLab | Cria branches e MRs | REST API |
+| JARVIS | Slack | Envia notificações | Webhook |
+| IDE | JARVIS | Integra via extensões | MCP |
+
+## ADRs Relacionados
+
+| ADR | Título | Impacto |
+|-----|--------|---------|
+| ADR-001 | Uso de Markdown para documentação | Define formato padrão |
+| ADR-002 | Integração via MCP | Define protocolo de comunicação |
+
+## Changelog
+
+### [2025-01-24] - v1.0
+- Criação: Diagrama inicial de contexto
+- Motivo: Documentar visão geral do sistema JARVIS