Files

david.delagneau 374991a568 Refactor workspace structure and documentation

- Deleted obsolete files: obsidian-vault.md, onboarding.md, workspace-model.md
- Updated opencode.json to remove references to deleted files.
- Revised profile.md to clarify the status of legacy paths and communication evidence.
- Adjusted prompts to reflect new file paths and improve clarity.
- Enhanced daily logs with focus, work-items, and blockers properties.
- Updated work-item notes to include systems, workstreams, people, and related properties.
- Improved context maintenance guidelines to ensure accurate and durable project knowledge.
- Refined base filters to exclude template files and ensure only relevant notes are displayed.
- Updated daily templates to ensure proper formatting and consistency.
- Modified workflows to align with the new vault structure and improve context synchronization.

2026-04-16 16:28:30 -06:00

2.2 KiB

Raw Blame History

Create A Project Profile

Use this checklist when adapting the workspace core for a new project.

1. Create The Profile

Create:

profiles/<project>/profile.md
profiles/<project>/README.md

The profile should declare:

project name
workspace purpose
primary audience
communication sources
ticket/work-item system
manager or stakeholder mapping
active context files
enabled commands
enabled skills

2. Configure Context

Create or update:

vault/00-start/start-here.md
vault/01-current/current-work.md
vault/01-current/work-items.md
vault/02-work-items/
vault/03-context/project.md
vault/03-context/process/
vault/04-people/
vault/05-decisions/
vault/06-daily/
vault/07-maps/
vault/08-bases/
vault/09-templates/

Keep project-specific facts out of core/.

Treat vault/ as canonical memory. Keep connector inboxes and generated evidence outside the vault.

3. Configure Integrations

Use generic variables first:

AIW_PROJECT_PROFILE=<project>
AIW_CHANNEL_PREFIX=<project-or-team-prefix>
AIW_MATTERMOST_SYNC_CMD=<optional custom command>
AIW_SLACK_EXPORT_PATH=<optional archive path>

Connector secrets belong in ignored .env files, not in profile files.

4. Configure Commands And Skills

Start with generic commands:

/workspace-context
/communication-sync
/archive-import
/standup
/manager-update
/translate
/ai-prompt

Add project-specific aliases only when they reduce friction.

5. Validate

Before using the workspace for real work:

confirm opencode.json is valid JSON
confirm the profile has no secrets
run a communication sync with test channels or a dry sample
generate one standup from sample context
verify that imported evidence and promoted memory stay separate

6. Obsidian Vault

Open vault/ as the Obsidian vault.

Recommended rules:

keep vault/ as the clean canonical human/AI memory
keep runtime evidence, scripts, profiles, and generated files outside vault/
version only portable vault/.obsidian configuration
ignore local Obsidian workspace state and plugin runtime files
create or update map notes under vault/07-maps/ for human navigation
create Bases under vault/08-bases/ using simple type properties

2.2 KiB Raw Blame History