david.delagneau/fidelity-ai-workspace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Add Fidelity workspace agent and context management commands

Browse Source 
- Introduced a primary agent for the Fidelity AI Workspace to maintain context and support daily engineering tasks.
- Created commands for loading workspace context, drafting updates for Jeff, and logging daily notes.
- Implemented translation and standup generation commands to enhance communication clarity.
- Developed a compaction plugin to preserve essential workspace context during sessions.
- Established a structured approach for managing project knowledge, communication rules, and decision-making processes.
- Updated README and project structure to reflect new workflows and usage guidelines.
This commit is contained in:
David Delagneau
2026-04-09 14:19:26 -06:00
parent 1028e6ecd6
commit e92c07b8b1
33 changed files with 1071 additions and 114 deletions
Download Patch File Download Diff File Expand all files Collapse all files

230
README.md
View File

@@ -1,162 +1,164 @@
# Fidelity AI Workspace
Repositorio diseñado para centralizar contexto, memoria operativa y generación de contenido asistido por IA para el trabajo diario en proyectos de ingeniería.
AI-native companion workspace for daily iOS engineering on Fidelity.
Este proyecto no almacena código de producto. Su objetivo es organizar conocimiento, decisiones y comunicación para reutilizarlos de forma eficiente con herramientas de IA.
This repository is not the product codebase. It is the operational context layer used from this machine to keep project state current, capture communication from Mattermost, prepare standups, and draft clear updates for Jeff in polished US English.
---
## Objetivo
## Purpose
- Centralizar TODO el contexto de un único proyecto activo
- Mantener trazabilidad de decisiones, tickets y comunicación
- Reducir fricción al generar standups, updates y PRs
- Reutilizar conocimiento en prompts de IA
- Capturar aprendizaje continuo (feedback, errores, soluciones)
- Tener una fuente de verdad viva del proyecto
- Keep Fidelity context current outside the main development machine
- Turn fragmented daily work into reusable AI-ready context
- Support standups, manager updates, Jira notes, and debugging summaries
- Improve communication quality without losing technical accuracy
---
## Estructura del proyecto
## Operating Model
```
memory/
project.md Contexto principal del proyecto (estado, objetivos, tickets activos)
logs/ Registro diario de trabajo
people/ Stakeholders relevantes (manager, backend, etc)
decisions/ Decisiones técnicas y de producto
You work on Fidelity from a different machine.
prompts/
Templates reutilizables (standup, manager updates, PRs)
This workspace is used to:
scripts/
Automatización (generación de contexto, mensajes, etc)
- record what happened during implementation and debugging
- sync relevant communication from Mattermost
- preserve current project context between sessions
- draft messages for Jeff with the right tone and scope
- translate rough notes into concise native-sounding English
workflows/
Integraciones con herramientas externas (nexus, opencode)
Core principle:
README.md
```
Context must be updated before asking AI to write.
---
## Flujo de trabajo diario
## Project Scope
### Inicio del día
Fidelity iOS ecosystem:
1. Revisar estado del proyecto en `memory/project.md`
2. Revisar último log en `memory/logs/`
3. Generar contexto actualizado del día
- Fid4
- XFlowSDK
- FTFrameworks
- REST migration replacing GraphQL over time
- Discourse and AO issues that require careful classification
---
### Durante el día
## Structure
Registrar avances en:
### /ai
```
memory/logs/YYYY-MM-DD.md
```
Runtime context for AI support.
Formato sugerido:
- `AGENTS.md` -> behavior rules for AI agents
- `context/` -> stable knowledge about Fidelity and team communication
- `state/` -> current focus, active issues, and communication needs
- `logs/` -> daily work record
```
## Trabajo realizado
- ...
### /prompts
## Hallazgos
- ...
Reusable prompts for:
## Bloqueos
- ...
```
- standups
- Mattermost updates
- manager communication
- issue clarification
### /workflows
Repeatable working guides for:
- daily context sync
- flow debugging
- external issue analysis
### /knowledge
Reference material for:
- XFlow behavior
- communication rules
- Fidelity-specific debugging heuristics
### /scripts
Helpers for future automation around context generation and communication drafting.
---
### Fin del día
## Daily Usage
Actualizar log con:
### Start of day
- Qué se hizo
- Qué se aprendió
- Qué quedó pendiente
Read:
- `ai/state/current.md`
- `ai/context/project.md`
- `ai/context/people/jeff.md`
- latest file under `ai/logs/`
### During the day
Capture:
- implementation progress from the main development machine
- Mattermost conversations that change scope or priorities
- debugging findings
- open questions, blockers, and follow-ups
Write updates in:
- `ai/logs/YYYY-MM-DD.md`
### Before sending a message
Confirm:
- context
- current observation
- requested or implied action
- whether the issue is external behavior or regression
- whether the flow is authenticated or non-authenticated
### End of day
Update:
- today log
- current state
- next communication needs for Jeff
---
## Uso con IA
## Expected Output
Este repositorio actúa como capa de contexto para herramientas como ChatGPT, Claude u otros modelos.
This workspace should help produce:
Ejemplo:
```
Context:
- memory/project.md
- memory/logs/2026-04-09.md
- memory/people/manager.md
Task:
- Generar standup
- Mejorar mensaje para manager
- Crear descripción de PR
```
- high-signal standups
- clearer Mattermost updates
- concise supervisor communication
- better issue framing
- more reliable AI-generated English
---
## Prompts disponibles
## OpenCode Entry Point
Ubicados en `prompts/`
This workspace is designed to work well with the OpenCode VS Code extension.
Ejemplos:
Recommended usage:
- standup.md
- manager-update.md
- pr-description.md
1. Open this repository as its own VS Code workspace.
2. Start OpenCode from the integrated terminal at the repository root.
3. Begin each session with `/fidelity-context`.
4. As new information appears during the day, update context before asking for drafting help.
---
Project commands live under `.opencode/commands/` and are intended to:
## Scripts (planeado)
- load the baseline Fidelity context
- draft standups
- draft Jeff updates
- convert rough notes into daily log updates
Ejemplos de comandos:
```
generate-context --project apple-pay --days 1
generate-standup
generate-message --manager
```
---
## Buenas prácticas
- Mantener `project.md` siempre actualizado
- Registrar avances diarios en logs
- Documentar decisiones importantes
- Capturar feedback del manager y stakeholders
- Escribir pensando en reutilización para IA
- Evitar duplicar contexto en múltiples archivos
---
## Herramientas
- VSCode como entorno principal
- Basic Memory como base conceptual (estructura en Markdown)
- Nexus Workflow Studio para automatización (opcional)
- opencode para ejecución de workflows y agentes (opcional)
---
## Roadmap
- [ ] Scripts para generación automática de contexto
- [ ] Integración con Mattermost
- [ ] Automatización de standups
- [ ] Sistema de tagging por proyecto
- [ ] Búsqueda semántica
---
## Notas
Este workspace está diseñado para trabajar sobre un único proyecto activo. Si se inicia un nuevo proyecto, se recomienda crear un nuevo workspace o reiniciar la estructura para evitar mezclar contextos.
This keeps AI output tied to the latest workspace state instead of relying on chat memory alone.