Commit graph

43 commits

Author SHA1 Message Date
darrenhinde
f8f64a5daa feat(commands): add smart commit command for opencode-agents repository 2025-11-26 22:02:04 +00:00
darrenhinde
f773b290ce chore(evals): comprehensive cleanup, documentation, and test infrastructure improvements
Documentation:
- Add ARCHITECTURE.md with comprehensive system review
- Add GETTING_STARTED.md for new users
- Add DOCUMENTATION_CLEANUP.md tracking cleanup changes
- Add SCRIPTS_ORGANIZATION.md documenting script reorganization
- Remove outdated docs (TESTING_CONFIDENCE.md, TEST_REVIEW.md, SESSION_STORAGE_FIX.md)
- Update README files with current information

Script Organization:
- Move 12 scripts from framework root to organized directories:
  - scripts/debug/ (4 files): Session debugging tools
  - scripts/test/ (6 files): Test execution scripts
  - scripts/utils/ (2 files): Utility scripts
- Add comprehensive scripts/README.md with usage examples

Test Infrastructure:
- Add 5 new context loading tests for openagent
- Add result-saver.ts for test result persistence
- Add interactive results dashboard (index.html)
- Add error-handling.test.ts for framework testing
- Add result-saver.test.ts with comprehensive unit tests

Evaluator Improvements:
- Enhance context-loading-evaluator with better detection
- Update run-sdk-tests.ts with improved result handling

Agent Configuration:
- Add .opencode/agent/AGENT.md for agent definition

Test Utilities:
- Add test-agent-manual.mjs for manual testing
- Update test_tmp/README.md with usage guidelines

This commit consolidates multiple improvements:
- Better organization (scripts, docs)
- Improved testing infrastructure
- Comprehensive documentation
- Cleaner codebase structure
2025-11-26 21:34:27 +00:00
darrenhinde
478c8e3e85 feat: implement SDK-based evaluation framework with real agent testing
- Replace planned framework with working SDK implementation using @opencode-ai/sdk
- Add 6 YAML test cases across developer/business/edge-case categories (100% passing)
- Implement 4 evaluators for openagent.md rule compliance (approval-gate, context-loading, delegation, tool-usage)
- Add real-time event streaming and session recording
- Configure opencode/grok-code-fast as default model (zero API costs)
- Add comprehensive documentation (SDK_EVAL_README.md, test-design-guide.md, TEST_SCENARIOS.md)
- Support v2 schema with behavior-based expectations instead of message counts
- Enable model-agnostic test design that works across Claude, GPT-4, and Grok
- Add subagent invocation syntax documentation to openagent.md
2025-11-22 14:30:11 +00:00
darrenhinde
c19d8c5480 Merge main into dev: sync subagent invocation improvements and context guide
- Merge improved subagent invocation syntax from main
- Add comprehensive OpenCode context reference cheatsheet
- Resolve conflicts in .gitignore (keep both eval results and tasks)
- Update opencoder.md with correct task() invocation patterns
2025-11-21 23:29:31 +00:00
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
13a7d6a56b fix: correct subagent paths and remove @ prefix for model compatibility
- Update all subagent references to use full paths (subagents/core/ and subagents/code/)
- Remove @ prefix to fix compatibility issues with some models
- Replace non-existent 'write-test' agent with 'subagents/code/tester'
- Fixes issue reported in GitHub issue
2025-11-21 14:37:06 +00:00
darrenhinde
c6775bbc40 chore: consolidate development changes and refactor agent system
Major Changes:
- Rename codebase-agent to opencoder for clarity
- Add agent validator plugin with comprehensive testing
- Refactor prompt engineering commands (enhancer → optimizer)
- Update task-manager subagent with improved workflows
- Enhance plugin system with validation and documentation

Agent System:
- Renamed: codebase-agent.md → opencoder.md
- Updated: task-manager.md with better delegation patterns
- Added: opencoder.md documentation

Plugin System:
- New: agent-validator.ts for prompt validation
- New: VALIDATOR_GUIDE.md with usage instructions
- New: Test suite (test-validator.sh, test-validation.sh)
- Updated: notify.ts, telegram-notify.ts with improvements
- Updated: package.json, bun.lock with new dependencies

Commands:
- Renamed: prompt-enchancer.md → prompt-engineering/prompt-enhancer.md
- New: prompt-engineering/prompt-optimizer.md
- Updated: build-context-system.md, validate-repo.md

Documentation:
- Updated: README.md with latest features
- Updated: openagent.md documentation
- New: opencoder.md agent documentation
- Updated: agent-system-blueprint.md
- Updated: system-builder docs (README, quick-start)
- Updated: installation.md, collision-handling.md

Registry:
- Updated: registry.json with new components

This consolidates all development work for the upcoming release.
2025-11-21 13:30:18 +00:00
darrenhinde
d5f4e9461e feat: implement ultra-compact context index system
- Add central context index at .opencode/context/index.md (120 tokens)
- Add compact metadata to all 9 context files (10 tokens each)
- Update OpenAgent prompt to reference index system (73% token reduction)
- Update context-guide.md with index usage documentation

Benefits:
- Single index file for context discovery
- Human-readable and machine-parseable format
- Clear dependency tracking (tests→code, review→code+patterns, etc.)
- Priority levels (critical/high/medium) for all contexts
- Reduced prompt overhead from ~200 to ~53 tokens

Context files updated:
- standards/code.md, docs.md, tests.md, patterns.md, analysis.md
- workflows/delegation.md, review.md, task-breakdown.md, sessions.md

This implements a scalable, maintainable context system with
efficient token usage and clear navigation structure.
2025-11-21 13:29:20 +00:00
darrenhinde
46e8582edb docs: update OpenAgent documentation and add repository validation
- Update OpenAgent docs with universal agent philosophy
- Change delegation criteria from 3+ to 4+ files
- Emphasize critical rules (approval gate, stop on failure, confirm cleanup)
- Create essential-patterns.md context file
- Add 11 context files to registry (standards/*, workflows/*)
- Create /validate-repo command for consistency checking
- Update all profile component counts (developer: 30, full: 36, advanced: 43)
- Ensure CLI compatibility with context file structure
2025-11-19 13:48:15 +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
e06833015f feat: enhance openagent and prompt-enchancer with research-backed patterns
OpenAgent improvements:
- Add critical_rules with absolute priority enforcement (approval gates, stop on failure, report first)
- Implement execution_priority system with 3-tier conflict resolution
- Refactor workflow stages with clear approval gates and validation
- Add delegation rules with context file creation guidelines
- Improve session management with lazy initialization

Prompt Enhancer improvements:
- Apply Stanford/Anthropic research patterns (position sensitivity, nesting limits)
- Add instruction ratio optimization (40-50% target)
- Implement single source of truth with @references
- Add explicit prioritization with 3-tier system
- Enhance analysis with research-backed pattern validation
2025-11-19 01:23:18 +00:00
darrenhinde
5518a96f53 feat: add context discovery and session management documentation
- Add context-discovery.md with dynamic context loading and manifest indexing
- Add session-management.md with lazy initialization and cleanup policies
- Implement keyword search and delegation patterns for context files
- Define session isolation and error handling strategies
2025-11-19 01:23:09 +00:00
darrenhinde
8b75f128d3 docs: update to recommend OpenAgent as default with enhanced workflow diagrams
- Position OpenAgent as recommended default for new users
- Add detailed stage diagrams for all 6 workflow stages
- Replace bright purple colors with softer slate blue for better accessibility
- Update all documentation to show OpenAgent as universal coordinator
- Keep codebase-agent as specialized development alternative
2025-11-18 23:15:44 +00:00
darrenhinde
ca323285b2 Rename to OpenAgents, remove model specs, and update documentation
Major Changes:
- Rename repository from opencode-agents to OpenAgents
- Remove all hardcoded model specifications (now model-agnostic)
- Fix documentation: profile names, component counts, add Business profile
- Add future plans note for other AI coding tools

Repository Rename:
- Update all URLs to github.com/darrenhinde/OpenAgents
- Update git remote, README, install scripts, documentation
- 15 files updated with new repository name

Model-Agnostic Framework:
- Remove model specifications from 6 agent files
- Framework now works with any AI provider (Claude, GPT, Gemini, local models)
- Users control model selection via OpenCode CLI settings

Documentation Fixes:
- Correct profile name: Core → Essential
- Add missing Business profile documentation
- Fix component counts: Developer (19), Advanced (32)
- Document all 5 profiles with accurate descriptions

Future Plans:
- Add note about support for other AI tools (Cursor, Claude Code, etc.)
- Clear focus on stabilizing OpenCode integration first

This makes OpenAgents a truly universal, model-agnostic framework
accessible to all users regardless of their AI provider preference.
2025-11-18 22:37:41 +00:00
darrenhinde
5f2cec1404 ✨ feat: introduce OpenAgent universal agent with session management
Major architectural refactoring:

- Add OpenAgent as universal primary agent for questions, tasks, and workflows
- Implement session-based context management with manifest tracking
- Reorganize subagents into logical categories (code/core/utils)
- Add dynamic context discovery and loading system
- Introduce cleanup script for stale sessions
- Update registry with new categorization (essential/standard/extended/specialized/meta)
- Rename 'core' profile to 'essential' and add 'business' profile
- Add comprehensive documentation with visual diagrams
- Update installation script with new profiles

Breaking changes:
- Subagent paths changed from analysis/core to code/core/utils
- Profile 'core' renamed to 'essential' (backward compatible)

New features:
- Session isolation for concurrent agent instances (.tmp/sessions/)
- Automatic stale session cleanup (>24 hours)
- Manifest-based context indexing and discovery
- Business profile for content-focused workflows
- OpenAgent with plan-approve-execute-validate-summarize workflow

Components: 32 total (3 agents, 13 subagents, 8 commands, 2 tools, 2 plugins, 2 contexts, 2 config)

Documentation:
- docs/agents/openagent.md - Comprehensive guide with Mermaid diagrams
- docs/guides/building-with-opencode.md - Power user formula
- scripts/README.md - Script documentation
- .opencode/context/core/context-management.md - Session management strategy
2025-11-18 18:45:42 +00:00
darrenhinde
a9f119e83e refactor: streamline profiles and fix registry pluralization
Profile Changes:
- Reduce core profile from 15 to 9 components (true essentials only)
- Keep developer at 22 components (add back image-specialist + gemini)
- Remove unused subagents from core (reviewer, build-agent)
- Remove non-essential commands from core (test, context, prompt-enhancer)

Core Profile (9 components):
- Agents: task-manager, codebase-agent
- Subagents: tester, documentation, coder-agent
- Commands: commit
- Context: essential-patterns, project-context
- Config: env-example

Developer Profile (22 components):
- Everything in core plus quality tools and AI features
- Added: image-specialist, gemini tool
- Added: reviewer, build-agent, codebase-pattern-analyst
- Added: test, context, clean, optimize, prompt-enhancer commands

Bug Fixes:
- Fix jq error: 'Cannot iterate over null' for config components
- Add get_registry_key() helper to handle singular 'config' vs plural types
- Update all jq queries to use correct registry keys

Codebase Agent:
- Remove @image-specialist reference (not needed for core coding)
- Update subagent list to match actual usage
- Now lists: @task-manager, @tester, @documentation, @coder-agent

Documentation:
- Update README with correct component counts
- Update profile descriptions to be more accurate
- Clarify what each profile is best for

This makes 'core' truly minimal and 'developer' the recommended choice.
2025-11-18 14:18:59 +00:00
darrenhinde
e524ba6ded feat: add system builder and reorganize project structure
New Features:
- Add system-builder agent for generating custom AI systems
- Add 5 new subagents for system building:
  - domain-analyzer: Analyzes domains and recommends architectures
  - agent-generator: Generates XML-optimized agent files
  - context-organizer: Organizes modular context files
  - workflow-designer: Designs workflow definitions
  - command-creator: Creates custom slash commands
- Add build-context-system command for interactive system generation
- Add system builder templates and guide

Project Reorganization:
- Move GITHUB_SETTINGS.md to docs/github/
- Move AGENT-SYSTEM-BLUEPRINT.md to docs/features/
- Move CODE_OF_CONDUCT.md to docs/contributing/
- Move CONTRIBUTING.md to docs/contributing/
- Consolidate documentation in docs/ directory

Registry Updates:
- Add system-builder agent to registry
- Add 5 new subagents to registry
- Add build-context-system command to registry
- Update advanced profile to include system builder components

This enables users to generate complete custom AI systems tailored to their domain through an interactive interview process.
2025-11-18 14:00:35 +00:00
darrenhinde
80e1a8d650 ✨ feat: make agent system language-agnostic with multi-language support
- Make codebase-agent work with TypeScript, Python, Go, Rust, and more
- Add clear runtime/type-check/lint command examples for each language
- Update build-agent to support all languages (tsc, mypy, go build, cargo check)
- Make essential-patterns universal by removing language-specific code examples
- Update README to mention multi-language support
- Remove auto-detection overhead - agents naturally adapt based on project files
2025-11-17 00:16:18 +00:00
darrenhinde
1e11d6b7a0 🐛 fix: correct typo in commit command instructions 2025-11-16 23:49:42 +00:00
darrenhinde
36a9ecff47 📝 docs: add clear explanation of what the Blueprint is at the top 2025-11-16 23:47:45 +00:00
darrenhinde
d7720fb7b4 📝 docs: simplify BLUEPRINT by removing code examples and recommending /prompt-enchancer 2025-11-16 23:46:52 +00:00
darrenhinde
88b3445f10 📝 docs: improve documentation for new users with video, TL;DR, and clearer guidance 2025-11-16 23:41:55 +00:00
Darren Hinde
b152f4a6a3
Update AGENT-SYSTEM-BLUEPRINT.md 2025-10-29 23:23:27 +00:00
darrenhinde
32cda54be3 enchance prompter 2025-10-14 14:44:52 +02:00
darrenhinde
1f9268506d 🗑️ chore: remove AGENTS.md and README.md files to streamline documentation and eliminate redundancy 2025-10-01 21:13:29 +02:00
darrenhinde
cac7ee6b03 📝 docs: update codebase-agent.md to include @image-specialist subagent and remove GEMINI_API_KEY requirement from image-specialist.md 2025-09-24 15:35:32 +01:00
darrenhinde
318cfab250 📝 docs: add instruction for requesting images from the image specialist in codebase-agent.md 2025-09-23 19:54:53 +01:00
darrenhinde
e073c5bb2e 🗑️ chore: remove deprecated Gemini tool files and update package configuration for improved structure 2025-09-23 13:31:36 +01:00
darrenhinde
25e6e919be ✨ feat: add Gemini API key configuration to env.example for integration 2025-09-21 17:34:31 +01:00
darrenhinde
dd204b5a2b update to agent,md 2025-09-18 19:40:36 +01:00
darrenhinde
b4927fc1b0 🔧 chore: update agent documentation and enhance prompt architecture with structured XML methodology 2025-09-18 16:02:28 +01:00
darrenhinde
2ca29f0e6f 📝 docs: clarify git push instruction in commit command 2025-08-29 17:58:57 +01:00
darrenhinde
7da13837e7 📝 docs: clarify automatic commit behavior in commit command 2025-08-29 17:58:04 +01:00
darrenhinde
9ba7d0239a 📝 docs: simplify commit command workflow and clean up worktrees metadata 2025-08-29 17:56:55 +01:00
darrenhinde
a585e72439 🔧 chore: update agent models and enhance command specifications 2025-08-29 17:51:53 +01:00
darrenhinde
885247baca 📝 docs: enhance command documentation with detailed guidelines 2025-08-29 13:55:42 +01:00
darrenhinde
6ed2c6ff9a Update subtask naming pattern in codebase-agent.md for consistency 2025-08-29 00:22:06 +01:00
darrenhinde
9b1ee7c7e9 PR agent 2025-08-26 00:18:26 +01:00
darrenhinde
a26bbe5e41 PR agent 2025-08-26 00:06:48 +01:00
darrenhinde
846f912629 Remove SimpleTelegramBot implementation and related references from the codebase to streamline functionality and improve maintainability. 2025-08-25 23:03:08 +01:00
darrenhinde
5dca3a8f47 Update codebase-agent.md to reflect changes in subagent naming and clarify task delegation process; remove example-test.md and mastra-master-reference.md files to streamline the documentation. 2025-08-16 11:54:11 +01:00
darrenhinde
a494e84a39 Remove unused agent and task manager files to streamline the codebase and improve maintainability. 2025-08-16 00:00:57 +01:00
darrenhinde
0119898081 Update README.md to enhance project description, add features, quick start guide, agent and plugin details, configuration instructions, and safety/security practices. 2025-08-15 01:43:56 +01:00