feat(plugin): enhance context management and skill invocation (#239 )

* fix(shellcheck): declare and assign separately in router.sh (SC2155)

* feat(plugin): enhance context management and skill invocation

- Update .context-manifest.json to include profile and detailed source information.
- Revise context-scout.md to clarify context root discovery and navigation.
- Modify commands to replace deprecated skills with updated ones (brainstorming → approach, systematic-debugging → debugger).
- Streamline install-context.md for clarity and remove interactive profile selection.
- Improve oac-status.md to provide a more comprehensive status report.
- Add OAC system paths to session-start.sh for better context management.
- Remove obsolete skills and improve documentation for existing commands.

2026-02-23 12:12:29 +00:00

2.7 KiB

Raw Blame History

⚠️ DEPRECATED: OpenCode Agent System Project Context

⛔ This file is deprecated. See project-intelligence/technical-domain.md for the current technical domain documentation.

Technology Stack

Primary Language: TypeScript Runtime: Node.js/Bun Package Manager: npm/pnpm/yarn Build Tools: TypeScript Compiler (tsc) Testing: Jest/Vitest (if configured) Linting: ESLint (if configured)

Project Structure

.opencode/
├── agent/           # AI agents for specific tasks
│   ├── subagents/   # Specialized subagents
│   └── *.md         # Primary agents
├── command/         # Slash commands
├── context/         # Knowledge base for agents
└── plugin/          # Extensions and integrations

tasks/               # Task management files

Core Patterns

Agent Structure Pattern

---
description: "What this agent does"
mode: primary|subagent
tools: [read, edit, bash, etc.]
permissions: [security restrictions]
---

# Agent Name

[Direct instructions for behavior]

**EXECUTE** this [process type] for every [task type]:

**1. [ACTION]** the [subject]:
- [Specific instruction 1]
- [Specific instruction 2]

**RULES:**
- **ALWAYS** [critical requirement]
- **NEVER** [forbidden action]

Command Structure Pattern

---
name: command-name
agent: target-agent
---

You are [doing specific task].

**Request:** $ARGUMENTS

**Context Loaded:**
@.opencode/context/core/essential-patterns.md
@[additional context files]

Execute [task] now.

Context Loading Rules

Commands load context immediately using @ references
Agents can look up additional context deterministically
Maximum 4 context files per command (250-450 lines total)
Keep context files focused (50-150 lines each)

Security Guidelines

Agents have restricted permissions by default
Sensitive operations require explicit approval
No direct file system modifications without validation
Build commands limited to safe operations

Development Workflow

Planning: Create detailed task plans for complex work
Implementation: Execute one step at a time with validation
Review: Code review and security checks
Testing: Automated testing and build validation
Documentation: Update docs and context files

Quality Gates

TypeScript compilation passes
Code review completed
Build process succeeds
Tests pass (if available)
Documentation updated

2.7 KiB Raw Blame History