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:
59
core/README.md
Normal file
59
core/README.md
Normal file
@@ -0,0 +1,59 @@
|
||||
# AI Workspace Core
|
||||
|
||||
Reusable operating layer for AI-assisted professional workspaces.
|
||||
|
||||
The core is project-independent. It defines how an AI agent should maintain file-based memory, ingest communication evidence, draft recurring updates, and adjust its own commands, prompts, and skills when reusable behavior changes.
|
||||
|
||||
---
|
||||
|
||||
## Core Responsibilities
|
||||
|
||||
- Maintain operational memory across sessions
|
||||
- Separate imported evidence from promoted memory
|
||||
- Provide reusable command and prompt patterns
|
||||
- Support project profiles without embedding project-specific facts in the core
|
||||
- Keep tooling behavior editable by the agent when the user corrects recurring output
|
||||
|
||||
---
|
||||
|
||||
## Project Profiles
|
||||
|
||||
Each real project should provide a profile under `profiles/<project>/`.
|
||||
|
||||
A profile declares:
|
||||
|
||||
- project name and audience
|
||||
- active communication sources
|
||||
- ticket/work-item system
|
||||
- manager or stakeholder mapping
|
||||
- domain-specific context files
|
||||
- enabled commands and skills
|
||||
|
||||
The core should never require a specific company, codebase, manager, channel name, ticket prefix, or programming stack.
|
||||
|
||||
---
|
||||
|
||||
## Memory Layers
|
||||
|
||||
- `daily`: facts from a specific workday
|
||||
- `state`: current active focus and near-term constraints
|
||||
- `work-items`: canonical memory for active units of work
|
||||
- `stable-context`: durable system, domain, process, or architecture knowledge
|
||||
- `people`: role, stakeholder, and collaboration memory
|
||||
- `decisions`: confirmed decisions with ongoing impact
|
||||
- `tooling-behavior`: reusable rules that change commands, prompts, skills, or agent behavior
|
||||
|
||||
See `core/memory/operational-memory.md` for the detailed rules.
|
||||
|
||||
---
|
||||
|
||||
## Integration Model
|
||||
|
||||
Integrations extract evidence. They do not decide what becomes memory.
|
||||
|
||||
- live communication connectors write recent evidence to `ai/inbox/`
|
||||
- historical archive connectors write selected evidence to `scripts/<source>/generated/`
|
||||
- the agent promotes only high-confidence, project-relevant facts into memory
|
||||
|
||||
See `core/integrations/communication-model.md` for the reusable connector contract.
|
||||
|
||||
Reference in New Issue
Block a user