Nicholai
f372ab56de
Add BMAD, Claude, Cursor, and OpenCode configuration directories along with AGENTS.md documentation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
97 lines
2.3 KiB
Markdown
97 lines
2.3 KiB
Markdown
# OpenCode Agent System Project Context
|
|
|
|
## 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
|
|
```markdown
|
|
---
|
|
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
|
|
```markdown
|
|
---
|
|
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
|
|
|
|
1. **Planning:** Create detailed task plans for complex work
|
|
2. **Implementation:** Execute one step at a time with validation
|
|
3. **Review:** Code review and security checks
|
|
4. **Testing:** Automated testing and build validation
|
|
5. **Documentation:** Update docs and context files
|
|
|
|
## Quality Gates
|
|
|
|
- TypeScript compilation passes
|
|
- Code review completed
|
|
- Build process succeeds
|
|
- Tests pass (if available)
|
|
- Documentation updated |