Files
fidelity-ai-workspace/workflows/opencode-entry.md

2.1 KiB

OpenCode Entry Workflow

Goal

Use OpenCode as the daily AI entry point for this workspace without losing project context.


Setup

  1. Open this repository as its own VS Code workspace.
  2. Run opencode from the integrated terminal at the repository root.
  3. Use the fidelity primary agent for this project profile, or the generic workspace agent for reusable profile work.
  4. Let project-level config load from AGENTS.md, opencode.json, .opencode/commands/, and .opencode/plugins/.
  5. Treat .agents/ as the shared source for reusable workflows and skill/rule content; .opencode/ is the OpenCode runtime view over that source.

  1. Run /workspace-context at the start of the day, or /fidelity-context when you want the Fidelity alias.
  2. If live communication sync is configured, let the inbox refresh automatically or run /communication-sync.
  3. When new work happens on the main development machine, run /sync-context ... or /log-note ....
  4. When you need a supervisor update, run /manager-update ....
  5. When you need polished English for Mattermost, run /translate ....
  6. When you need a standup, run /standup.

Why This Works

  • Project instructions load automatically from opencode.json.
  • Root rules also load automatically from AGENTS.md.
  • Shared workflow/rule content can stay centralized in .agents/ while OpenCode keeps using .opencode/.
  • The main context command reads the reusable core/, active profile, stable workspace files, and today's log.
  • Stable context is split by systems, workstreams, process, people, and decisions so the agent can pull the right layer instead of overloading one project file.
  • Live communication context can be refreshed into ai/inbox/ using the configured connector.
  • Direct prompts are also treated as memory opportunities, so the agent can update workspace context during normal conversation.
  • Daily updates go back into the workspace, so later prompts inherit better context.
  • The local compaction plugin helps preserve the most important workspace context during long sessions.
  • This reduces reliance on fragile session memory.