jarvis-ai-framework 1.0.0

package/skills/prod-roadmap-report/README.md

@@ -0,0 +1,303 @@
+# README
+
+A Claude skill for extracting and structuring product roadmap information from various sources into standardized markdown reports.
+
+## Overview
+
+This skill transforms unstructured inputs (meeting transcriptions, Slack messages, emails, documents) into well-organized roadmap reports following consistent templates. It's designed for product managers, team leads, and anyone who needs to consolidate roadmap updates from multiple sources.
+
+The skill maintains a strict policy of **never inventing information** — it only uses explicitly stated data and asks for clarification when critical information is missing.
+
+## Key Features
+
+- **Multi-source Input**: Accepts meeting transcripts, chat messages, emails, Google Docs, or any text format
+- **Automatic Language Detection**: Outputs match the user's language
+- **Template-based Output**: Generates consistent markdown reports with YAML frontmatter
+- **Update Capability**: Can update existing reports while preserving structure and reverse chronological order
+- **Obsidian Integration**: Supports saving directly to Obsidian vaults with proper linking
+- **Historical Context Awareness**: Uses previous reports for consistency (terminology only, never for inventing data)
+- **RAG Status Support**: Tracks Red/Amber/Green status for each project/initiative
+- **Project Confirmation**: Before generating, asks user to confirm the list of projects to include
+
+## Usage
+
+### Basic Usage
+
+Simply provide your meeting notes, transcript, or messages:
+
+```
+Here are my notes from today's PM sync:
+
+- Payment integration: Tests completed successfully, rollout starting next week
+- User notification: Design in progress, Sarah presenting next Tuesday
+- Database migration: 35% complete, on track for February deadline
+- Blocked on API credentials from external vendor since last week
+```
+
+The skill will:
+1. Detect your language
+2. Ask for team name if not inferable
+3. Ask you to confirm the list of projects before generating
+4. Generate a structured report following the template
+
+### Updating Existing Reports
+
+Provide the existing report plus new information:
+
+```
+Update the Platform compiled report with today's sync notes:
+
+[paste or reference existing report]
+
+New notes from 2026-01-21:
+- API integration: First real transaction processed successfully
+- Email notifications: Design approved, development starting tomorrow
+```
+
+The skill will:
+1. Read and analyze the existing report structure
+2. Insert new content BEFORE old content (maintaining reverse chronological order)
+3. Preserve exact formatting, language, and section structure
+4. Update the `updated_at` field in frontmatter
+
+### Obsidian Integration
+
+If you use Obsidian, the skill can:
+- Save reports directly to your vault
+- Update existing notes in place
+- Follow your vault's file naming conventions (Title Case with spaces)
+- Create proper `[[wiki links]]` for related notes and people
+- Maintain consistent YAML frontmatter
+
+When saving to Obsidian, specify your vault path when asked.
+
+## Report Types
+
+### 1. Single Team Status Report
+Daily status report for one team and its projects. Contains the latest status for each project on a specific day.
+
+**Use case**: Quick daily updates from a standup, sync meeting, or PM check-in.
+
+**File pattern**: `{team-name}-status-report-{YYYY-MM-DD}.md`
+
+**Template**: `templates/template-single-team-status.md`
+
+### 2. Compiled Team Report
+Aggregated report combining multiple daily reports for one team over time. Groups all historical updates by project, with dates in reverse chronological order (newest first).
+
+**Use case**: Weekly summaries, historical tracking, or comprehensive team overview.
+
+**File pattern**: `{team-name}-compiled-status-report-{YYYY-MM-DD}.md`
+
+**Template**: `templates/template-single-team-compiled-status.md`
+
+### 3. Multiple Teams Report
+Consolidated report grouping multiple teams with their respective projects. Combines compiled reports from several teams into one document.
+
+**Use case**: Leadership reviews, cross-team syncs, quarterly updates, or organization-wide status.
+
+**File pattern**: `all-teams-status-report-{YYYY-MM-DD}.md`
+
+**Template**: `templates/template-multiple-teams-compiled-status.md`
+
+### 4. Projects List
+A structured table listing all projects extracted from status reports with their current status and RAG rating.
+
+**Use case**: Portfolio overview, project inventory, or executive summary.
+
+**Template**: `templates/template-projects-list.md`
+
+## Report Structure
+
+### YAML Frontmatter
+
+All reports include structured frontmatter for integration with tools like Obsidian:
+
+```yaml
+---
+tags:
+  - work/report
+created_at: 2026-01-06
+updated_at: 2026-01-21
+type: note
+company: "[[Company Name]]"
+related_people:
+  - "[[Person Name]]"
+related:
+  - "[[Related Note]]"
+---
+```
+
+### Summary Table
+
+Compiled reports include a summary table at the top:
+
+| Project/Initiative | Observation | Status | RAG rating | Priority |
+| --- | --- | --- | --- | --- |
+| Project Name | Brief current state | in progress | on track | high |
+
+### Project Sections
+
+Each project section follows this structure:
+
+```markdown
+## Project Name
+
+- status: in progress
+- rag status: on track
+
+### YYYY-MM-DD
+
+Summary paragraph describing the main discussion points, progress, 
+and context. Written in prose, max 200 words.
+
+**On track:**
+- **Item name**: Description of positive progress
+
+**Problems:**
+- **Issue name**: Description of current blocker
+
+**Risks and Concerns:**
+- **Risk name**: Description of potential future problem
+
+**Actions:**
+- Action item with assignee if mentioned
+```
+
+## Real-World Example
+
+Here's an example of a compiled report section:
+
+```markdown
+## Third-Party API Integration
+
+- status: in progress
+- rag status: on track
+
+### 2026-01-20
+
+The team successfully tested the integration flow with a pilot customer, 
+completing three end-to-end transactions. The MVP is progressing well and 
+the first phase has moved to development. Progressive rollout will begin 
+at the end of January, initially targeting customers already connected 
+to the external service.
+
+**On track:**
+- **Production tests**: Successful transactions completed with pilot customer
+- **Development**: First phase already sent to development team
+- **Rollout planning**: Timeline established from January to March with gradual expansion
+
+**Problems:**
+- **Testing limitations**: Unable to test with certain providers not yet connected to the service
+- **Process definition**: Lack of standardization for post-acceptance payment workflow
+
+**Risks and Concerns:**
+- **Customer dependency**: Delays may occur if customers take too long to make decisions
+- **Untested scenarios**: Still missing tests for edge cases like rejection flows and discount rules
+
+**Actions:**
+- Continue testing with more customers to validate uncovered scenarios
+- Define and formalize standard payment process
+- Execute progressive rollout: 5% in first week of February, expanding gradually
+
+### 2026-01-06
+
+The integration initiative is advancing with flow design in Figma and 
+preparation for technical alignment meeting. The team is splitting the 
+user journey into two options: the current method and the new API-based flow.
+
+**On track:**
+- **Figma flow in development**: Design team working on the complete flow
+- **Technical meeting scheduled**: Meeting set for tomorrow with backend team
+
+**Risks and Concerns:**
+- **Competition ahead**: Competitors already knew about this integration possibility before us
+
+**Actions:**
+- Hold meeting with backend team to align technical effort
+- Schedule review meeting to validate the designed flow
+```
+
+## Core Principles
+
+### What the Skill WILL Do
+
+✅ Use only explicitly stated information  
+✅ Mark sections empty if no relevant info exists  
+✅ Preserve original terminology from sources  
+✅ Ask for clarification when critical info is missing  
+✅ Maintain reverse chronological order (newest first)  
+✅ Group all projects under a single team header  
+✅ Check if updating existing report before creating new one  
+✅ Preserve exact structure when updating existing reports  
+✅ Fill YAML frontmatter correctly based on template patterns  
+✅ Move done/resolved topics to the appropriate section  
+
+### What the Skill WILL NOT Do
+
+❌ Invent dates, deadlines, or timelines  
+❌ Create action items that weren't stated  
+❌ Infer problems/risks from neutral statements  
+❌ Add team members/stakeholders not mentioned  
+❌ Make up metrics or quantitative data  
+❌ Fabricate technical details  
+❌ Assume project status without explicit indication  
+❌ Update wrong dates or wrong projects  
+❌ Create extra blocks not in templates (Meeting Notes, Learnings, etc.)  
+
+## Trigger Phrases
+
+The skill activates when you mention:
+- "status report"
+- "project update"
+- "sync notes"
+- "war room"
+- "team report"
+- "weekly update"
+
+## File Structure
+
+```
+project-status-report/
+├── SKILL.md                    # Main skill definition
+├── README.md                   # This file
+├── templates/
+│   ├── template-single-team-status.md
+│   ├── template-single-team-compiled-status.md
+│   ├── template-multiple-teams-compiled-status.md
+│   └── template-projects-list.md
+└── references/
+    └── detailed-guide.md       # Extended examples and edge cases
+```
+
+## Allowed Tools
+
+This skill can use:
+- `conversation_search` - Find previous reports in chat history
+- `google_drive_search` - Search for source documents
+- `google_drive_fetch` - Retrieve Google Docs content
+
+## Best Practices
+
+1. **Update existing historical reports** - When possible, provide or reference existing compiled reports so the skill can add new updates while maintaining full context and history. This produces more complete and consistent results.
+2. **Be explicit about team names** - Helps avoid clarification questions and ensures proper file naming.
+3. **Include dates when relevant** - Ensures accurate timeline tracking and proper ordering.
+4. **Mention assignees for actions** - Creates accountable action items (e.g., "assigned: @john").
+5. **Provide context for acronyms** - Especially on first use (e.g., "CRM (Customer Relationship Management)").
+6. **Separate concerns clearly** - Distinguish between current problems (active blockers) and potential risks (future concerns).
+7. **Use consistent project names** - Helps the skill match updates to the correct project in existing reports.
+8. **Indicate RAG status when known** - If you know a project is at risk or blocked, mention it explicitly.
+9. **Reference related people** - Mention team members and stakeholders so they can be linked in the frontmatter.
+10. **Group related topics** - If multiple updates belong to the same initiative, present them together in your input.
+
+## Contributing
+
+To modify templates or add new report types:
+
+1. Edit files in the `templates/` directory following existing patterns
+2. Update the SKILL.md with new instructions if needed
+3. Add examples to `references/detailed-guide.md` for edge cases
+
+---
+
+*This skill was designed for product management workflows at scale, supporting teams that need consistent, reliable status reporting without manual formatting overhead.*

package/skills/prod-roadmap-report/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: prod-roadmap-report
+description: Cria e atualiza relatórios estruturados de roadmap de produto a partir de reuniões, mensagens, documentos ou notas. Use quando usuários precisam extrair atualizações de roadmap em relatórios markdown com seções de resumo, problemas, riscos e ações, consolidar múltiplos relatórios de times, atualizar relatórios existentes mantendo ordem cronológica reversa, salvar/modificar relatórios no Obsidian vault, ou mencionar termos como "relatório de roadmap", "atualização de produto", "sync", "war room", "relatório do time" ou "atualização semanal".
+allowed-tools: conversation_search, google_drive_search, google_drive_fetch
+metadata:
+  author: jarvis-team
+  version: "1.0.0"
+---
+
+# Relatório de Status do Projeto
+
+## Visão Geral
+Extraia informações de status do projeto de diversas fontes (reuniões, mensagens, e-mails, documentos) e gere relatórios de status estruturados seguindo templates padronizados em markdown.
+
+**Tipos de arquivos de relatório:**
+- Relatório do dia mais recente de um único time com todos os seus projetos (usado para criar outros arquivos compilados)
+- Relatório compilado de um único time com todos os seus projetos e informações de relatórios em seções por data
+- Documento consolidado agrupando múltiplos relatórios de times
+- Lista consolidada de projetos
+
+Por favor, siga o `rules/status-report-rules.md` para obter orientações corretas e conhecer as regras principais desta skill.
+
+## Instruções
+Sempre interaja com o usuário no mesmo idioma que ele estiver usando.
+
+### Roadmap Preview:
+- Quando o usuário perguntar sobre roadmap, status, sprint, atualizações, etc., execute as instruções de `commands/status-roadmap-preview`
+- Use o `$ARGUMENTS` do usuário para obter a resposta correta.
+
+
+### Geral:
+- Use as informações, transcrições e documentos fornecidos pelo usuário para criar os relatórios
+- Aprenda com as notas para entender as relações entre relatórios e notas
+- Se for atualizar um arquivo existente, leia e entenda o arquivo antes de atualizá-lo com novas informações
+- Encontre o produto/projeto/iniciativa nas notas existentes e atualize o bloco correto
+- Siga as instruções do template completamente
+- Se não tiver certeza de onde inserir informações, pergunte ao usuário
+- Os arquivos de saída finais precisam ter o yaml preenchido corretamente
+- Para projetos/tópicos com status resolvido e concluído, mova para a seção correta indicada nos templates
+- Esteja preparado para atualizar as notas na seção de tópico correta quando o usuário fornecer informações atualizadas sobre um tópico individual
+
+### Relatório de time único:
+- Geralmente é usado para obter o relatório de status mais recente dos projetos até aquele dia.
+- É usado para estruturar informações e relatório de status de um único time e seus projetos.
+- Use `templates/template-single-team-status.md`
+- Agrupe múltiplos projetos sob o cabeçalho de UM ÚNICO time
+- Antes de criar o arquivo, peça confirmação ao usuário com uma lista de projetos e iniciativas que o relatório final terá. O usuário pode pedir para mesclar alguns tópicos ou renomeá-los
+
+### Relatório compilado do time (grupo bem estruturado e formatado de muitos arquivos de relatório de time único):
+- Usado para agrupar em um arquivo todos os relatórios de time único de um time específico e os relatórios de status dos seus projetos de múltiplos dias
+- Para criar ou atualizar este relatório, use os relatórios de time único já criados pelo usuário e as informações fornecidas pelo usuário
+- Quando o usuário pedir um relatório atualizado de todos os projetos de um time específico
+    - Use as informações fornecidas ou, se o Obsidian for usado, procure pelas notas históricas relacionadas e novas notas relacionadas para atualizar este relatório
+    - Procure por arquivos que tenham o mesmo nome e padrões de conteúdo criados por esta skill ou por padrões que os usuários já pediram no passado
+- O arquivo de saída precisa seguir as instruções e estrutura do template `templates/template-single-team-compiled-status.md`
+- Mantendo a estrutura das notas de relatório de time único, mas seguindo a estrutura e organização do template fornecido
+- Não altere informações ou datas ao agrupar essas notas
+- Peça esclarecimentos se as notas individuais não existirem
+- Agrupe múltiplos projetos sob o cabeçalho de UM ÚNICO time
+
+### Relatórios de múltiplos times (múltiplos times, com múltiplos projetos, múltiplos dias):
+- Usado para agrupar em um arquivo todos os relatórios individuais de todos os times com relatórios de status de muitos projetos de múltiplos times
+- O arquivo de saída precisa seguir as instruções e estrutura do template `templates/template-multiple-teams-compiled-status.md`
+- Mantendo a estrutura das notas de relatório de time único, mas seguindo a estrutura e organização do template fornecido
+- Não altere informações ou datas ao agrupar essas notas
+- Peça esclarecimentos se as notas individuais não existirem
+
+### Fornecendo lista atualizada de projetos
+- Se o usuário quiser uma lista atualizada de projetos nas notas, use o arquivo `templates/template-projects-list.md` para dar a resposta.
+
+## Regra Crítica de Estrutura
+
+**CORRETO - Cabeçalho de time único com todos os projetos:**
+```markdown
+## Nome do Time
+
+### Primeiro Projeto
+#### DD-MM-AAAA
+{conteúdo}
+
+#### DD-MM-AAAA
+{conteúdo}
+
+#### DD-MM-AAAA
+{conteúdo}
+
+### Segundo Projeto
+#### DD-MM-AAAA
+{conteúdo}
+
+#### DD-MM-AAAA
+{conteúdo}
+```
+
+Na seção do projeto, as seções de datas devem ser organizadas do mais recente para o mais antigo.
+
+**ERRADO - Cabeçalhos de time repetidos:**
+```markdown
+## Nome do Time
+### Primeiro Projeto
+...
+
+## Nome do Time
+### Segundo Projeto
+...
+```
+
+O nome do time (`## Nome do Time`) deve aparecer UMA VEZ com todos os projetos aninhados sob ele.
+
+### O que Evitar
+
+- Não atualize datas ou projetos errados
+- Não crie blocos extras (Notas de Reunião, Aprendizados, etc.) - siga os templates exatamente
+- Não assuma - peça esclarecimentos quando tiver dúvida
+
+## Quando o usuário usa Obsidian
+Verifique se o usuário usa Obsidian. Se sim, verifique se você tem acesso para usar skills ou MCP disponível para manipular notas no Obsidian Vault.
+
+- Se o usuário quiser salvar os arquivos no Obsidian vault, peça o caminho do vault
+- Se o usuário quiser atualizar ou modificar uma nota existente no Obsidian vault, peça o caminho do arquivo no vault
+- Procure no vault para
+
+## Fluxo de Processamento
+
+### 1. Receber e Analisar
+- Detectar o idioma do usuário
+- Verificar contexto histórico (relatórios anteriores)
+- Aceitar entrada em qualquer formato
+- Escanear em busca de: nomes de times, projetos, status, problemas, riscos, ações, datas
+
+### 2. Extrair Informações
+Para cada projeto:
+- Nome do time (explícito ou contextual)
+- Nome do projeto/iniciativa
+- Conteúdo do resumo
+- Itens no prazo (progresso positivo)
+- Problemas (bloqueadores atuais)
+- Riscos e preocupações (problemas potenciais)
+- Ações (próximos passos específicos)
+
+### 3. Lidar com Informações Ausentes
+**Quando perguntar:**
+- Informação crítica ausente (nome do time não pode ser inferido)
+- Existe informação contraditória
+- Informação vaga demais para preencher as seções
+
+**Quando NÃO perguntar:**
+- Detalhes menores ausentes mas o núcleo está claro
+- Apenas 1-2 seções esparsas (marcar como vazio)
+- Nomes de time/projeto razoavelmente inferíveis
+
+### 4. Gerar Saída
+- Arquivo markdown único com todos os projetos (padrão)
+- Seguir estrutura do template
+- Usar data atual seguindo o formato correto indicado pelos templates
+- Corresponder ao idioma do usuário
+- Inserir novas atualizações ANTES do conteúdo antigo (cronologia reversa)
+
+## Regras Críticas
+
+### NUNCA:
+❌ Inventar datas, prazos ou cronogramas
+❌ Criar itens de ação que não foram declarados
+❌ Inferir problemas/riscos de declarações neutras
+❌ Adicionar membros de time/stakeholders não mencionados
+❌ Inventar métricas ou dados quantitativos
+❌ Fabricar detalhes técnicos
+❌ Assumir status do projeto sem indicação
+
+### SEMPRE:
+✅ Usar apenas informações explicitamente declaradas
+✅ Marcar seções como vazias se não houver informação relevante
+✅ Preservar a terminologia original
+✅ Usar datas exatas quando mencionadas
+✅ Citar problemas/riscos específicos conforme declarado
+✅ Listar apenas ações explicitamente discutidas
+✅ Pedir esclarecimentos quando necessário
+✅ Verificar se está atualizando um relatório existente
+✅ Preservar a estrutura exata ao atualizar
+✅ Agrupar projetos sob o cabeçalho de UM ÚNICO time
+✅ Inserir novo conteúdo ANTES do antigo (cronologia reversa)
+
+## Checklist de Qualidade
+
+Antes de entregar:
+- [ ] Todas as datas da fonte ou data atual seguindo o formato correto indicado pelos templates
+- [ ] Nenhum item de ação ou problema inventado
+- [ ] Nomes de time/projeto precisos ou marcados como incertos
+- [ ] Todas as seções presentes (mesmo que vazias)
+- [ ] Resumo factual sem especulações
+- [ ] Formato corresponde exatamente ao template
+- [ ] Conteúdo verificável a partir das fontes
+- [ ] Nenhum detalhe alucinado
+- [ ] Se atualizando: estrutura exata preservada
+- [ ] Contexto histórico apenas para terminologia, não para invenção de dados
+- [ ] Cada cabeçalho de time aparece apenas UMA VEZ
+- [ ] Novo conteúdo inserido ANTES do conteúdo antigo
+- [ ] Tópicos Concluídos/Resolvidos inseridos na seção correta

package/skills/prod-roadmap-report/commands/status.compiled.single.team.md

@@ -0,0 +1,23 @@
+---
+description: This command creates a new or update an existing compiled status report of an specific team, from transcripts, informations and other sources
+argument-hint: <organize a compiled status report of my team "write your team name">
+---
+# Status Compiled Single Team
+
+This is used to compiled in one output an updated status report of projects of one specific team, organized by projects and updated dates.
+
+Please, follow the `rules/status-report-rules.md` to get right guidance and know the main rules of this skill.
+
+The output need to follow the instructions and structure of the template `templates/template-single-team-compiled-status.md`
+
+Instructions:
+- Used to group in one file all single team report of one specific team and your projects status reports of multiple days
+- To create or update this report, use the single team reports already created before by the user and the informations given by the user
+- When the user asks for a latest updated report of all projects of one specific team
+    - Use the given informations or if the obsidian is used, look for the historical related notes and new related notes to update this report
+    - Look for files that have the same name and content patterns created by this skill or for partterns users already asked in the past
+- Output need to follow the instructions and structure of the template `templates/template-single-team-compiled-status.md`
+- Maintaining structure of the single team report notes, but following the structure and organization of the given template
+- Don't change informations or dates when group those notes
+- Ask for clarification if individual notes don't exist
+- Group multiple projects under SINGLE team header

package/skills/prod-roadmap-report/commands/status.list.projects.md

@@ -0,0 +1,17 @@
+---
+description: This command list all projects in a concise summary and table with status and other informations from existent status report files or informations provided by the user
+argument-hint: <list all my projects and your status>
+---
+# Status List projects
+
+This is used to create and organize a brief concise list of the projects and your status from status reports files or informations the users provided. 
+
+Please, follow the `rules/status-report-rules.md` to get right guidance and know the main rules of this skill.
+
+The output need to follow the instructions and structure of the template `templates/template-projects-list.md`
+
+**Instructions:**
+- If the user already give a path to a folder or informations, or if you are working inside a folder that are Obsidian Vault, look for the files that follow the naming path described in `SKILL.md` or the `references/detailed-guide.md`
+- If you can't detect those informations or files, ask to the user to give the files or informations so you can organize and give the right anwser
+- Use the most recent files to give the latest status of the projects.
+- If user ask to show only projects from an specific team, follow the same template, but show only detected informations about projects and status reports of that team.