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:
60
profiles/example/profile.md
Normal file
60
profiles/example/profile.md
Normal 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`
|
||||
121
profiles/fidelity/profile.md
Normal file
121
profiles/fidelity/profile.md
Normal 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`
|
||||
Reference in New Issue
Block a user