Files

david.delagneau 1ad707373a Add daily logs and templates for project fidelity

- Created daily log entries for May 13, 14, 18, 19, 20, and 21, capturing work done, findings, and next steps.
- Established a daily logs index for easy navigation of daily notes.
- Developed templates for daily logs, decisions, meeting notes, people, systems, and work items to standardize documentation.
- Introduced base files for filtering and displaying various types of project knowledge, including daily notes, decisions, people, systems, work items, and workstreams.
- Added maps for current work, fidelity apps, and fidelity domain to enhance project navigation and context.

2026-05-21 12:28:07 -06:00

2.2 KiB

Raw Blame History

Communication Integration Model

Principle

Communication integrations extract evidence. The agent promotes memory.

Connectors should not decide that a message is durable project truth. They should fetch, normalize, and store evidence in predictable files so the agent can apply memory rules.

Connector Types

Live Communication Connector

Use for active systems such as Mattermost, Slack, Teams, or email.

Expected behavior:

fetch recent messages from configured channels or conversations
support a forced refresh for "latest message" prompts
write the latest evidence to workspaces/<profile>/inbox/
write status separately from project memory
fail safely without updating logs, state, or context

Historical Archive Connector

Use for exports such as Slack archives.

Expected behavior:

read raw archive files from an ignored archive location
select high-signal evidence without treating the archive as current truth
write generated summaries and JSONL to scripts/<source>/generated/
preserve enough source metadata for later review

Standard Evidence Shape

Connectors should emit JSONL records with this minimum shape when practical:

{
  "source": "communication-system",
  "channel": "readable-channel-name",
  "timestamp": "ISO-8601 timestamp",
  "username": "display name or handle",
  "message": "message text",
  "thread_id": "optional thread id",
  "metadata": {}
}

Additional fields are allowed when useful, but the core should not depend on project-specific fields.

Environment Variables

Prefer generic AIW_* variables for reusable workspaces:

AIW_PROJECT_PROFILE
AIW_CHANNEL_PREFIX
AIW_MATTERMOST_SYNC_CMD
AIW_MATTERMOST_SYNC_INTERVAL_MINUTES
AIW_SLACK_EXPORT_PATH

Project-specific variables may remain as profile aliases, but new integrations should prefer AIW_*.

Failure Rules

If a connector fails:

record operational status only
do not update daily logs
do not update current state
do not update stable context
do not infer project facts from the failure

The agent may report the operational failure to the user, but it must not promote the failure as project memory unless the user explicitly asks to track tooling work.

2.2 KiB Raw Blame History