Commit graph

74 commits

Author SHA1 Message Date
github-actions[bot]
a4c974cdaf chore: auto-update component registry [skip ci] 2025-11-19 01:24:05 +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
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
9692d3a752 fix: respect --install-dir argument throughout installation process
- Add get_install_path() helper to convert registry paths to installation paths
- Fix collision detection to check files in custom install directory
- Fix file installation to use custom directory instead of hardcoded .opencode
- Fix env.example path check in post-install message
- Tested with .test-install-dir and .openffff directories - all files now install to correct location
2025-11-19 01:22:21 +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
3249900d63 Update installation documentation with custom directory support and bash 5.x fix
- Rewrite installation.md as comprehensive installation guide
  - Add custom installation directory documentation (--install-dir, OPENCODE_INSTALL_DIR)
  - Document interactive location selection (Local/Global/Custom)
  - Add platform-specific installation examples
  - Include all installation methods and profiles
  - Add troubleshooting and advanced usage sections

- Update platform-compatibility.md with bash 5.x fix details
  - Add Ubuntu 24.04 (bash 5.2.21) to tested configurations
  - Document set -e compatibility fix
  - Add troubleshooting section for bash 5.x issues
  - Update cross-platform features list

Documentation now synced with installer v1.1.0 features
2025-11-18 23:13:00 +00:00
darrenhinde
3c972fb828 Fix critical bash 5.x compatibility and add custom install directory support
- Fix set -e bug: Change ((variable++)) to variable=$((variable + 1)) to prevent script exit on bash 5.2.21 (Ubuntu 24.04)
- Fix collision handling UX: Display menu options correctly by redirecting to stderr
- Add custom installation directory support with --install-dir flag and OPENCODE_INSTALL_DIR env var
- Add interactive location selection menu (Local/Global/Custom)
- Implement cross-platform path handling (Linux/macOS/Windows) with tilde expansion, backslash conversion, and validation
- Enhance help documentation with comprehensive examples and platform support information

Fixes installation failures on modern Linux systems and enables flexible installation to any directory including ~/.config/opencode
2025-11-18 23:08:30 +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
dfea8199a9 fix: don't clear screen in non-interactive mode
Problem:
- When running 'curl ... | bash -s core' the screen would clear
- This made it appear like nothing was happening after preview
- Users couldn't see the installation progress

Solution:
- Only call 'clear' in interactive mode
- Skip clear when NON_INTERACTIVE=true
- Allows users to see full output when piped from curl

Now users can see:
- Dependency checks
- Registry fetch
- Installation preview
- 'Installing automatically' message
- Full installation progress
- Completion message

This makes the installation process transparent and debuggable.
2025-11-18 14:26:59 +00:00
darrenhinde
532e17ce01 fix: auto-install when profile specified via command line
Problem:
- Running 'curl ... | bash -s core' showed preview and waited for input
- User had to press Y to proceed even though profile was specified
- Defeats the purpose of one-command installation

Solution:
- Add NON_INTERACTIVE flag to track command-line profile usage
- Set NON_INTERACTIVE=true when profile argument provided
- Skip confirmation prompt when NON_INTERACTIVE=true
- Show 'Installing automatically (profile specified)...' message

Behavior:
Before:
  curl ... | bash -s core
  → Shows preview, waits for Y/n input

After:
  curl ... | bash -s core
  → Shows preview, installs automatically

Interactive mode still works:
  bash install.sh
  → Shows menu, asks for confirmation (as expected)

This makes profile-based installation truly one-command with no interaction needed.
2025-11-18 14:24:27 +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
515a83dce2 fix: detect piped execution and provide clear guidance
Problem:
- Running 'curl ... | bash' without arguments showed interactive menu
- But stdin was the curl stream, not terminal
- Script couldn't read user input and would exit silently
- Confusing user experience

Solution:
- Add check_interactive_mode() to detect if stdin is a terminal
- If running in pipe without arguments, show helpful error message
- Provide clear instructions for both interactive and profile-based install
- Update README to clarify installation methods

Changes:
- Add [ ! -t 0 ] check to detect non-terminal stdin
- Show helpful error with examples when piped without profile
- Update README to recommend profile-based install (fastest)
- Clarify that interactive mode requires downloading first

User Experience:
Before: Silent exit or confusing behavior
After: Clear error message with exact commands to run

Examples shown to user:
- Download first: curl ... -o install.sh && bash install.sh
- Or use profile: curl ... | bash -s core

This fixes the issue reported when running on another computer.
2025-11-18 14:04:15 +00:00
github-actions[bot]
aef73202a6 chore: auto-update component registry [skip ci] 2025-11-18 14:00: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
1a0f458e1a fix: cross-platform installer compatibility for bash 3.2+ and Windows
Critical fixes:
- Fix argument mismatch (accept 'core' and '--core' formats)
- Fix bash 3.2 compatibility (replace mapfile with while-read loops)
- Fix process substitution issues (use temp files)
- Add platform detection (macOS/Linux/Windows)
- Add bash version check (3.2+ required)
- Add conditional color support for Windows terminals

Enhancements:
- Platform-specific dependency installation instructions
- Improved help text with usage examples
- Better error messages for unsupported platforms

Testing:
- Add comprehensive compatibility test suite (12 tests)
- Add collision detection tests
- Organize tests in scripts/tests/ directory
- All tests pass on macOS (bash 3.2.57)

Documentation:
- Add Windows installation instructions to README
- Add platform compatibility guide
- Add COMPATIBILITY.md quick reference
- Update all test script references

Tested on:
- macOS 13+ (bash 3.2.57) ✓
- Linux (bash 4.0+) ✓
- Windows Git Bash (bash 4.4+) ✓

Closes issues with curl installation failing on macOS and Windows
2025-11-18 13:57:18 +00:00
darrenhinde
9d482c9fbf docs: center and improve README header layout 2025-11-17 23:46:42 +00:00
darrenhinde
30cc71e4e1 docs: add Buy Me a Coffee badge to README 2025-11-17 23:45:48 +00:00
darrenhinde
6d472c32c7 docs: remove comparison section from README 2025-11-17 23:45:20 +00:00
darrenhinde
7d75353d5a feat: add GitHub discovery optimizations
Community & Discovery Improvements:
- Add CODE_OF_CONDUCT.md (Contributor Covenant 2.0)
- Add badges to README (stars, license, last commit, PRs welcome)
- Add comparison section (vs Copilot, Cursor, Aider)
- Improve tagline with SEO keywords
- Add issue templates (bug report, feature request, good first issue)
- Add GitHub settings checklist for post-merge configuration

SEO & Discoverability:
- Keyword-rich description for search ranking
- Clear differentiation from alternatives
- Professional presentation with badges
- Community-friendly templates

Next Steps (After Merge):
- Update About section with new description
- Add 16 topics for search optimization
- Enable GitHub Discussions
- Create social preview image
- Add issue labels

Estimated Impact: 10x improvement in GitHub discoverability
2025-11-17 23:43:13 +00:00
darrenhinde
e382efaa22 refactor: update installation profiles based on user feedback
Changes to profiles:
- Core: Added prompt-enhancer, removed tools (truly minimal now)
- Developer: Removed plugins, kept AI tools (env, gemini) for image generation
- Full: Only profile with plugins (Telegram notifications)
- Advanced: Removed plugins, only adds planning/architecture docs

Other changes:
- Added note in README about differences from demo video
- Emphasized making repo easier for others to use
- Verified image-specialist dependencies are properly included

Profile sizes:
- Core: 15 components (minimal essentials)
- Developer: 22 components (recommended for daily use)
- Full: 25 components (everything including plugins)
- Advanced: 23 components + docs (for contributors)
2025-11-17 23:43:13 +00:00
darrenhinde
3ab70d24a9 fix: simplify registration script to preserve manual registry
- Replace complex auto-scanning with simple validation script
- Prevents registry from being emptied by buggy scan functions
- Auto-scanning feature can be added later after more testing
- Registry now stays intact and works correctly
2025-11-17 23:43:13 +00:00
darrenhinde
357dabcfec fix: restore registry.json content and add bash 3.2 compatibility
- Recreate registry.json with all component definitions
- Fix bash 3.2 compatibility (replace ${var^} with awk)
- Registry was accidentally emptied by registration script
2025-11-17 23:43:13 +00:00
darrenhinde
7a2d17ca3a feat: add OPENCODE_BRANCH env var for testing different branches 2025-11-17 23:43:13 +00:00
darrenhinde
777b3fc702 feat: add interactive installer with component registry system
- Add component registry (registry.json) with 4 installation profiles
- Create interactive installer (install.sh) with profile and custom selection
- Add auto-registration script for CI/CD integration
- Create validation script for component structure
- Add update script for keeping components current
- Include GitHub Actions workflow for auto-registry updates
- Update README with installation instructions
- Add CONTRIBUTING guide for new components

Features:
- Interactive CLI with colored output and menus
- Smart dependency resolution
- Backup existing installations
- Profile-based installation (core, developer, full, advanced)
- Custom component selection
- Component validation and testing tools
2025-11-17 23:43:13 +00:00
Darren Hinde
bd6aec49c6
Update README.md 2025-11-17 11:42:40 +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
93b9bbc1a6
Update README.md 2025-10-29 23:26:02 +00:00
Darren Hinde
48e1c1c486
Update README.md 2025-10-29 23:24:08 +00:00
Darren Hinde
b152f4a6a3
Update AGENT-SYSTEM-BLUEPRINT.md 2025-10-29 23:23:27 +00:00
Darren Hinde
7a1da6016f
Update README.md 2025-10-29 23:17:58 +00:00
Darren Hinde
1f024058af
Update README.md 2025-10-29 23:15: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
Darren Hinde
834c3a83ee
Merge pull request #8 from darrenhinde/agent-prompts-update
Agent prompts update - Gemini Tool
2025-09-24 15:36:09 +01: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
Darren Hinde
ab44698fa0
Update README.md 2025-09-23 17:27:52 +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