88 lines
2.3 KiB
Markdown
88 lines
2.3 KiB
Markdown
# Profiles
|
|
|
|
Profiles make the workspace reusable across projects, clients, or personal workflows.
|
|
|
|
Each profile should describe what the project is, where its memory lives, which communication sources matter, which local services are enabled, and how AI clients should access context.
|
|
|
|
## Current Profile Layout
|
|
|
|
```text
|
|
profiles/
|
|
fidelity/
|
|
profile.md
|
|
services.json
|
|
context-sources.json
|
|
example/
|
|
profile.md
|
|
```
|
|
|
|
## Recommended Future Layout
|
|
|
|
```text
|
|
profiles/<profile>/
|
|
profile.md # human-readable project profile
|
|
workspace.json # profile paths and defaults
|
|
services.json # local services for this profile
|
|
context-sources.json # communication/source filters
|
|
|
|
workspaces/<profile>/
|
|
project-knowledge/ # canonical Markdown vault
|
|
inbox/ # raw evidence for this profile
|
|
```
|
|
|
|
## Profile Files
|
|
|
|
### `profile.md`
|
|
|
|
Human-readable summary for agents and developers:
|
|
|
|
- project name;
|
|
- workspace role;
|
|
- communication sources;
|
|
- work-item system;
|
|
- stakeholders or roles;
|
|
- important domain themes;
|
|
- enabled workflows or skills.
|
|
|
|
### `workspace.json`
|
|
|
|
Planned path configuration. Initial versions can point to current paths:
|
|
|
|
```json
|
|
{
|
|
"profile": "example",
|
|
"display_name": "Example Project",
|
|
"knowledge_dir": "project-knowledge",
|
|
"inbox_dir": "ai/inbox",
|
|
"index_dir": ".aiw/indexes/example"
|
|
}
|
|
```
|
|
|
|
### `services.json`
|
|
|
|
Profile-specific local service manifest for `scripts/aiw/services.py`.
|
|
|
|
Examples:
|
|
|
|
- context MCP;
|
|
- communication proxy/mirror;
|
|
- photo inbox;
|
|
- future indexer or dashboard services.
|
|
|
|
### `context-sources.json`
|
|
|
|
Source filters for profile-bounded reads. For example, a Mattermost profile can define which channels count as high-signal context.
|
|
|
|
## Adding A New Project
|
|
|
|
1. Copy `profiles/example/` to `profiles/<new-project>/`.
|
|
2. Create or point to a project knowledge vault.
|
|
3. Define services only for integrations the project actually uses.
|
|
4. Put connector secrets in ignored `.env` files.
|
|
5. Build the local index.
|
|
6. Connect AI clients through the MCP server.
|
|
|
|
## Migration Rule
|
|
|
|
Reusable code should accept a `--profile` argument and resolve paths through profile configuration. Avoid adding new hardcoded references to Fidelity, channel names, ticket prefixes, or company-specific folders in generic scripts.
|