chore: install openagent opencode

Signed-off-by: Dmytro Stanchiev <git@dmytros.dev>
This commit is contained in:
2026-04-07 11:31:26 -04:00
parent b4c03ff25e
commit c2263602c4
204 changed files with 38010 additions and 0 deletions

View File

@@ -0,0 +1,192 @@
<!-- Context: core/context-guide | Priority: low | Version: 1.0 | Updated: 2026-02-15 -->
# Context System Guide
## Quick Reference
**Golden Rule**: Fetch context when needed, not before (lazy loading)
**Key Principle**: Use context index for discovery, load specific files as needed
**Index Location**: `.opencode/context/navigation.md` - Quick map of all contexts
**Structure**: standards/ (quality + analysis), workflows/ (process + review), system/ (internals)
**Session Location**: `.tmp/sessions/{timestamp}-{task-slug}/context.md`
---
## Overview
Context files provide guidelines and templates for specific tasks. Use the index system for efficient discovery and lazy loading to keep prompts lean.
## Context Index System
**Central Index**: `.opencode/context/navigation.md` - Ultra-compact map of all contexts
The index provides:
- Quick map for common tasks (code, docs, tests, review, delegation)
- Triggers/keywords for each context
- Dependencies between contexts
- Priority levels (critical, high, medium)
### Available Context Files
All files are in `.opencode/context/core/` with organized subfolders:
### Standards (Quality Guidelines + Analysis)
- `standards/code-quality.md` - Modular, functional code principles [critical]
- `standards/documentation.md` - Documentation standards [critical]
- `standards/test-coverage.md` - Testing standards [critical]
- `standards/security-patterns.md` - Core patterns (error handling, security) [high]
- `standards/code-analysis.md` - Analysis framework [high]
### Workflows (Process Templates + Review)
- `workflows/task-delegation-basics.md` - Delegation template [high]
- `workflows/feature-breakdown.md` - Complex task breakdown [high]
- `workflows/session-management.md` - Session lifecycle [medium]
- `workflows/code-review.md` - Code review guidelines [high]
## How to Use the Index
**Step 1: Check Quick Map** (for common tasks)
- Code task? → Load `standards/code-quality.md`
- Docs task? → Load `standards/documentation.md`
- Review task? → Load `workflows/code-review.md`
**Step 2: Load Index** (for keyword matching)
- Load `.opencode/context/navigation.md`
- Scan triggers to find relevant contexts
- Load specific context files as needed
**Step 3: Load Dependencies**
- Check `deps:` in index
- Load dependent contexts for complete guidelines
**Benefits:**
- No prompt bloat (index is only ~120 tokens)
- Fetch only what's relevant
- Faster for simple tasks
- Clear dependency tracking
## When to Use Each File
### .opencode/context/core/standards/code-quality.md
- Writing new code
- Modifying existing code
- Following modular/functional patterns
- Making architectural decisions
### .opencode/context/core/standards/documentation.md
- Writing README files
- Creating API documentation
- Adding code comments
### .opencode/context/core/standards/test-coverage.md
- Writing new tests
- Running test suites
- Debugging test failures
### .opencode/context/core/standards/security-patterns.md
- Error handling
- Security patterns
- Common code patterns
### .opencode/context/core/standards/code-analysis.md
- Analyzing codebase patterns
- Investigating bugs
- Evaluating architecture
### .opencode/context/core/workflows/task-delegation-basics.md
- Delegating to general agent
- Creating task context
- Multi-file coordination
### .opencode/context/core/workflows/feature-breakdown.md
- Tasks with 4+ files
- Estimated effort >60 minutes
- Complex dependencies
### .opencode/context/core/workflows/session-management.md
- Session lifecycle
- Cleanup procedures
- Session isolation
### .opencode/context/core/workflows/code-review.md
- Reviewing code
- Conducting code audits
- Providing PR feedback
## Temporary Context (Session-Specific)
When delegating, create focused task context:
**Location**: `.tmp/sessions/{timestamp}-{task-slug}/context.md`
**Structure**:
```markdown
# Task Context: {Task Name}
Session ID: {id}
Created: {timestamp}
Status: in_progress
## Current Request
{What user asked for}
## Requirements
- {requirement 1}
- {requirement 2}
## Decisions Made
- {decision 1}
## Files to Modify/Create
- {file 1} - {purpose}
## Static Context Available
- .opencode/context/core/standards/code-quality.md
- .opencode/context/core/standards/test-coverage.md
## Constraints/Notes
{Important context}
## Progress
- [ ] {task 1}
- [ ] {task 2}
---
**Instructions for Subagent:**
{Specific instructions}
```
## Session Management
### Session Structure
```
.tmp/sessions/{session-id}/
├── context.md # Task context
├── notes.md # Working notes
└── artifacts/ # Generated files
```
### Session ID Format
`{timestamp}-{random-4-chars}`
Example: `20250119-143022-a4f2`
### Cleanup
- Ask user before deleting session files
- Remove after task completion
- Keep if user wants to review
## Best Practices
✅ Use index for context discovery
✅ Load only relevant context files
✅ Check dependencies in index
✅ Create temp context when delegating
✅ Clean up sessions after completion
✅ Reference specific sections when possible
✅ Keep temp context focused and concise
**Golden Rule**: Fetch context when needed, not before.