Files
fidelity-ai-workspace/knowledge/workspace-model.md
david.delagneau 8026da5719 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.
2026-04-16 08:35:53 -06:00

1.4 KiB

Workspace Model

Purpose

This repository is a support workspace, not the implementation repository.

It now has two layers:

  • core/ contains reusable project-independent operating rules
  • profiles/<project>/ contains project-specific configuration and assumptions

What belongs here

  • daily logs
  • communication context
  • manager update drafts
  • stable project knowledge
  • debugging summaries
  • reusable command, prompt, skill, and agent rules that make the workspace behave consistently
  • project profiles that configure the reusable core for a specific project

What does not belong here

  • product source code
  • assumptions about code changes not yet verified
  • statements that imply work was executed from this machine unless explicitly true

Operational Surface

When the user corrects a recurring behavior, the workspace should update the file that controls that behavior:

  • core/ for reusable project-independent behavior
  • profiles/<project>/ for project-specific assumptions
  • .opencode/commands/ for slash commands
  • prompts/ for reusable drafting templates
  • .opencode/agents/ and ai/AGENTS.md for default agent behavior
  • .opencode/skills/ for specialized workflows
  • knowledge/ and ai/context/process/ for durable process rules

Daily logs can preserve evidence, but they should not be the only place where a reusable behavior rule lives.