Refactor AI workspace for improved context management and communication integration

- Introduced new commands and skills for workspace memory curation, professional communication, and status reporting.
- Updated existing commands to utilize new skills and improve clarity in instructions.
- Created a new workspace context command to load reusable core and active project profile.
- Enhanced Mattermost inbox integration with support for generic environment variables.
- Established a clear separation between project-independent core logic and project-specific profiles.
- Improved documentation across various files to reflect changes in workflow and command usage.
- Added operational memory management rules to ensure accurate context promotion and correction.
- Updated README and workflow documents to guide users in utilizing the new structure effectively.
This commit is contained in:
2026-04-16 08:35:53 -06:00
parent 1f57597ca3
commit 8026da5719
41 changed files with 1131 additions and 42 deletions

View File

@@ -0,0 +1,60 @@
# Example Project Profile
## Purpose
Non-sensitive example profile showing how a new project can reuse the workspace core without inheriting another project's context.
---
## Project
- Name: Example Project
- Workspace role: companion AI workspace
- Primary use: memory, status drafting, work-item tracking, and communication polishing
---
## Communication Sources
- Live communication: configure a connector if needed
- Historical archive: optional
- Recommended generic variables:
- `AIW_PROJECT_PROFILE=example`
- `AIW_CHANNEL_PREFIX=example`
- `AIW_MATTERMOST_SYNC_CMD=<optional>`
- `AIW_SLACK_EXPORT_PATH=<optional>`
---
## Work System
- Use `ai/work-items/` for active units of work
- Use any ticket ID format relevant to the project
- Keep approved titles or explicit task names visible for recurring updates
---
## Context
Project-specific durable context should live under `ai/context/`.
Do not place company secrets, raw exports, credentials, or private communication transcripts in the profile.
---
## Suggested Commands
- `/workspace-context`
- `/communication-sync`
- `/archive-import`
- `/standup`
- `/manager-update`
- `/translate`
- `/ai-prompt`
## Suggested Generic Skills
- `workspace-memory-curation`
- `professional-communication`
- `status-reporting`
- `ai-prompt-engineering`

View File

@@ -0,0 +1,121 @@
# Fidelity Profile
## Purpose
This is the first real project profile for the reusable AI workspace core.
It keeps Fidelity-specific context, integrations, commands, and skills separate from the project-independent operating model in `core/`.
---
## Project
- Name: Fidelity iOS ecosystem
- Workspace role: companion AI workspace, not the product codebase
- Main development happens on a different machine
- Primary use: context memory, communication drafting, standups, Jira/story support, and AI-to-AI prompt generation
---
## Communication Sources
- Live communication: Mattermost
- Historical archive: Slack export
- Preferred channel naming: readable channel names instead of raw IDs
- Current high-signal channel: `fidelity-preguntas`
Compatibility environment variables:
- `FIDELITY_MATTERMOST_SYNC_CMD`
- `FIDELITY_MATTERMOST_SYNC_INTERVAL_MINUTES`
- `FIDELITY_SLACK_EXPORT_PATH`
Generic variables should be preferred for new setup:
- `AIW_MATTERMOST_SYNC_CMD`
- `AIW_MATTERMOST_SYNC_INTERVAL_MINUTES`
- `AIW_SLACK_EXPORT_PATH`
- `AIW_CHANNEL_PREFIX=fidelity`
- `AIW_PROJECT_PROFILE=fidelity`
---
## Work System
- Work items are Jira-linked when available
- Active ticket memory lives in `ai/work-items/`
- Compact active summary lives in `ai/state/work-items.md`
- Jira IDs and approved titles should remain visible for standups and manager updates
---
## Stakeholders
- Current manager mapping lives in `ai/context/people/manager.md`
- Person-specific collaboration context lives in `ai/context/people/`
- Manager-facing messages should be concise, explicit, and natural professional US English
---
## Domain Context
Core Fidelity context remains in:
- `ai/context/project.md`
- `ai/context/systems/`
- `ai/context/workstreams/`
- `ai/context/ios/`
- `ai/context/process/`
- `ai/context/decisions/`
Important domain themes:
- Fid4 consumer validation
- XFlowSDK backend-driven UI
- XFlowViewMaker adapter/release coupling
- FTFrameworks feature modules
- REST migration from GraphQL/Apollo
- AO/Discourse external issue handling
- authenticated vs non-authenticated reproduction
---
## Enabled Commands
Generic commands:
- `/workspace-context`
- `/communication-sync`
- `/archive-import`
- `/ai-prompt`
- `/standup`
- `/manager-update`
- `/translate`
- `/sync-context`
- `/log-note`
Compatibility aliases:
- `/fidelity-context`
- `/mattermost-sync`
- `/slack-import`
- `/copilot-prompt`
- `/swift-help`
---
## Enabled Skills
Generic:
- `workspace-memory-curation`
- `professional-communication`
- `status-reporting`
- `ai-prompt-engineering`
- `copilot-prompt-engineering`
Domain-specific:
- `ios-swift-answering`
- `ios-testing-strategy`
- `swiftui-xflow-review`