Minha Biblioteca Context Skill

Loads comprehensive context about the Minha Biblioteca (MB) project from multiple sources. Use this to update your knowledge before working on MB-related tasks.

When to Use

• Starting work on any MB issue
• User asks about MB status, progress, or requirements
• User runs /mb or /mb-context
• Need to understand MB scope, timeline, or constraints
• Preparing for MB meetings or updates

Data Sources

1. Linear Initiatives (MB-related)

Initiative IDs:

• fba5cea4-6c47-43e3-a831-8ca1d94c176d - Minha Biblioteca - Setup (Pilot Go-Live: April 17, 2026)
• 37905e1a-bbcc-4b26-973d-7faacff75734 - Essential Feature Parity - MB (Core RFP features)
• 3870adf7-6dd7-4dc1-8337-cb45c00907c2 - Reading Companion Tools - MB (Flashcards + VitoAI)
• 8bf4c6ab-a1d6-4da5-86c9-b3edfa0c433d - Platform Reliability & Developer Excellence - MB (Security, Infra, DX)

2. Local Documents

Path: Documents/MB/

Key files:

• RFP_Pontos de avaliação_final.xlsx - Requisitos.pdf - 101 requirements from RFP
• BRM Documentation.pdf - BRM integration specs
• PageViews Documentation.pdf - Pageview tracking rules
• Watch Tower Model Documentation.pdf - Torre de Vigilância integration
• brm_metadata_publica.json / .xlsx - BRM metadata mapping

3. Gmail

Label: label:minha-biblioteca

Contains: MB correspondence, meeting notes, decisions, stakeholder communications.

Execution Flow

Phase 1: Fetch Linear Data (parallel)

// 1. Get all initiatives
linear_getInitiatives({ includeArchived: false })

// 2. For each MB initiative, get projects
linear_getInitiativeProjects({ initiativeId: "{id}" })

// 3. Get HIGH PRIORITY issues only (priority 1 or 2)
// Filter: priority in [1, 2] (Urgent, High)
linear_searchIssues({
  filter: {
    initiative: { id: { in: [MB_INITIATIVE_IDS] } },
    priority: { in: [1, 2] }
  },
  limit: 100
})

Priority Filter (CRITICAL):

Value	Label	Include
1	Urgent	YES
2	High	YES
3	Normal	NO
4	Low	NO
0	None	NO

Phase 2: Read Documents

# Read key MB documents
Read: Documents/MB/RFP_Pontos de avaliação_final.xlsx - Requisitos.pdf
Read: Documents/MB/BRM Documentation.pdf
Read: Documents/MB/PageViews Documentation.pdf
Read: Documents/MB/Watch Tower Model Documentation.pdf

Phase 3: Check Gmail

# Search recent MB emails
php formica/scripts/gmailHandler.php search "label:minha-biblioteca" --limit=20

Phase 4: Synthesize Context

Compile findings into structured summary:

# MB Context Update — {date}

## Timeline
- **Pilot Go-Live**: April 17, 2026
- **Current Phase**: {Kick-off|Implementation|Pilot}
- **Weeks Remaining**: {N}

## Initiative Status

### Minha Biblioteca - Setup
- Projects: {count}
- High Priority Issues: {count}
- Blocked: {count}

### Essential Feature Parity - MB
- Projects: {count}
- High Priority Issues: {count}
- Blocked: {count}

### Reading Companion Tools - MB
- Projects: {count}
- High Priority Issues: {count}
- Blocked: {count}

### Platform Reliability & DX - MB
- Projects: {count}
- High Priority Issues: {count}
- Blocked: {count}

## High Priority Issues ({total})

### Blocked
- **{ID}**: {title} — {blocker reason}

### Urgent (P1)
- **{ID}**: {title} [{project}]

### High (P2)
- **{ID}**: {title} [{project}]

## RFP Compliance Summary
- **Total Requirements**: 101
- **Atende**: ~58 (57%)
- **Atende Parcialmente**: ~30 (30%)
- **Não Atende**: ~13 (13%)

## Key Gaps (Não Atende)
- EPUB2 support (Highlights, Notes, Bookmarks)
- HTML5 native support
- MP3/Audiobook 1.0 bookmarks
- Flashcards/Study cards

## Recent Communications
{Summary of recent Gmail threads}

## Key Contacts
- **MB Side**: {names from emails}
- **PLA Side**: Gonzalo Parra (PM), Ignacio Milano (Tech Lead)

Output Guidelines

1. Always filter to HIGH priority — MB has many issues, focus on P1/P2 only
2. Show blocked items first — These need immediate attention
3. Include timeline context — Weeks to pilot go-live
4. Highlight RFP gaps — "Não Atende" items are critical
5. Link to Linear — Include URLs for quick access

Quick Reference

Key Dates

• Contract signed: ~January 2026
• Setup period: 15 weeks
• Pilot go-live: April 17, 2026
• Full rollout: Post-May 2026

RFP Categories

Administração, Arquitetura, Autenticação, Backup, Busca, Catálogo, Comercial, Compatibilidade, Conformidade, Destaques, Funcionalidades, Integrações, Interface, Leitor Digital, Licenciamento, Marcações, Notas, Observabilidade, Permissões, Recomendação, Referências, Relatórios, Segurança, Sincronização, Suporte, Tracking, Acessibilidade

Integration Points

• BRM: Content/catalog management
• SEEDS: Environment/license management
• Torre de Vigilância: Activity monitoring/anti-piracy
• MB Auth: SSO integration

---

BRM Integration Flow

Overview

1. INGESTA       → Editoras → Own Tenant & SFTP → Aggregator Tenant MB
2. SYNC CATÁLOGO → BRM calls GET /api/v3/content (Aggregator Tenant)
3. METADATA      → BRM calls PUT /integration-api/v1/dashboard/issues/{id}

Test Environment

• URL: https://testminhabiblioteca.publica.la/
• Tenant ID: 1125899913000021

Custom Taxonomies (MB Tenant)

ddc                    → DDC / Dewey Decimal Classification
genero                 → Gênero
area-do-conhecimento   → Área do Conhecimento
selo                   → Selo
ano-da-edicao          → Ano da Edição
local-de-publicacao    → Local de publicação
subtitulo              → Subtítulo
organizador            → Organizador
ilustrador             → Ilustrador
collection             → Collection

Example Update Payload

{
  "name": "Inteligência artificial aplicada às smart grids",
  "external_id": "9786555503395",
  "publication_date": "2024-01-15",
  "author": ["Raul Vitor Arantes Monteiro"],
  "publisher": ["Editora Blucher"],
  "description": "<p>Descrição do livro...</p>",
  "ddc": ["123"],
  "genero": ["MB Exatas"],
  "area-do-conhecimento": ["Ciência da computação"],
  "selo": ["Blucher Open Access"],
  "ano-da-edicao": ["2024"],
  "local-de-publicacao": ["São Paulo"],
  "subtitulo": ["I.A 2026"],
  "organizador": ["João Silva"],
  "ilustrador": ["Maria Silva"]
}

BRM Metadata Mapping

BRM Field	API Field	Type
UUID	—	Needs implementation
ISBN	external_id	Standard
Título	name	Standard
Autores	author	Standard (array)
Grupo Editorial	publisher	Standard (array)
Descrição	description	Standard
Data de publicação	publication_date	Standard
Imagem da Capa	cover	Standard
Tipo de Arquivo	extension	Standard
DDC/CDD	ddc	Custom taxonomy
Gênero	genero	Custom taxonomy
Área do Conhecimento	area-do-conhecimento	Custom taxonomy
Selo	selo	Custom taxonomy
Ano da Edição	ano-da-edicao	Custom taxonomy
Local de publicação	local-de-publicacao	Custom taxonomy
Subtítulo	subtitulo	Custom taxonomy
Organizador	organizador	Custom taxonomy
Ilustrador	ilustrador	Custom taxonomy
Status	ti_withdraw	Pending
Expiration Date	—	Pending
Obras Substitutas	—	Pending (related content)
ABNT	—	Auto-generated (citation rules)

CLI Testing Tool

# List content
php formica/scripts/publicaApiHandler.php list --limit=10

# Search by ISBN
php formica/scripts/publicaApiHandler.php isbn 9786555503395

# Get content details (v1)
php formica/scripts/publicaApiHandler.php get-v1 {id}

# Update content
php formica/scripts/publicaApiHandler.php update {id} payload.json

Example Usage

User: /mb
-> Fetch Linear initiatives + high priority issues
-> Read MB documents
-> Check recent Gmail
-> Return synthesized context with timeline, status, blockers

User: What's blocking MB progress?
-> Load mb-context skill
-> Focus on Blocked issues section
-> Return prioritized list with context