3 commits

Author	SHA1	Message	Date
darrenhinde	6d6495905b	docs: improve subagent invocation clarity and add context reference guide ... - Add explicit task() invocation syntax to codebase-agent with examples - Include when-to-use guidance for each subagent (4+ files, simple tasks, etc.) - Add comprehensive OpenCode context reference cheatsheet covering: - File references with @ symbol (immediate vs lazy loading) - Agent invocation patterns (task tool vs @ syntax) - Shell command execution with backtick syntax - Best practices and anti-patterns - Complete real-world examples and templates This improves AI agent reliability in delegating to subagents by providing clear, explicit invocation patterns following research-backed progressive disclosure principles.	2025-11-21 16:17:20 +00:00
darrenhinde	2bc97007c1	refactor: simplify agent execution philosophy and reorganize context structure ... Major Changes: - Simplified OpenAgent execution philosophy (universal agent, delegate sparingly) - Reorganized context into 3-tier structure: standards/, workflows/, system/ - Improved approval gate wording for clarity - Enhanced .gitignore with comprehensive Node.js patterns - Added comprehensive plugin development guide Context Reorganization: - Consolidated scattered files into organized structure with Quick Reference sections - Emphasis on lazy loading for token efficiency (60-80% token savings) - New standards: code.md, docs.md, tests.md, patterns.md, analysis.md - New workflows: delegation.md, sessions.md, task-breakdown.md, review.md - New system: context-guide.md (master reference) Delegation Improvements: - Removed complex XML-style routing rules - Simplified to clear when/how structure with 7 delegation criteria - Added Perspective and Simulation as delegation triggers - Clearer delegation template and process Documentation Enhancements: - Added building-plugins.md (1,274 lines - comprehensive plugin guide) - Updated how-context-works.md with research-backed architecture - Enhanced slash-commands-and-subagents.md with path resolution findings Content Preservation: - context-discovery.md → system/context-guide.md + workflows/sessions.md - context-management.md → workflows/sessions.md - essential-patterns.md → standards/patterns.md - session-management.md → workflows/sessions.md	2025-11-19 13:13:06 +00:00
darrenhinde	c0ea1c064c	docs: add research-backed prompt design and developer guides ... - Add research-backed-prompt-design.md with Stanford/Anthropic patterns - Add openagent.md documentation with workflow and delegation details - Add developer guides for slash commands and context system - Document position sensitivity, nesting limits, and instruction ratios - Include examples and best practices for prompt optimization	2025-11-19 01:23:27 +00:00