9a58a03284
* feat(context): Add project intelligence system - Add project-intelligence.md standard (what & why) - Add project-intelligence-management.md guide (how to manage) - Add project-intelligence/ folder with 6 context files: - navigation.md (quick overview & routes) - business-domain.md (business context, users, value) - technical-domain.md (stack, architecture, decisions) - business-tech-bridge.md (business → technical mapping) - decisions-log.md (decision history with context) - living-notes.md (active issues, debt, questions) - Update standards navigation with new entries - Register all new contexts in registry.json This enables projects to document and maintain business + technical context for quick onboarding and lasting project understanding. * fix(registry): Add project-intelligence to profiles - Add context:project-intelligence/* to developer, business, full, and advanced profiles - Ensures project intelligence contexts are included when these profiles are selected This complements commit c731328 which added the context entries. * docs(core): refine project intelligence system and deprecate legacy context * feat(claude): simplify Claude Code integration with unified installer - Create single install-claude.sh script that auto-converts and installs - Remove redundant bootstrap-install.sh and install.sh scripts - Delete stale plugin/ directory (now auto-generated from .opencode/) - Add Claude Code documentation (agent-skills, create-subagents, hooks, plugins) - Add installation profiles (essential, developer, business, full, advanced) - Update README with Claude Code beta feature documentation - Add component-planning.md workflow context - Clean up demo files (assets/, src/) - Update registry with new context entries - Add gitignore rule for converter/generated/ The new installer: - Converts agents automatically from .opencode/agent/ - Installs fresh converted agents to ~/.claude/plugins/ - Single command: ./integrations/claude-code/install-claude.sh * fix: update README to use new install-claude.sh script The Claude Code integration now uses the unified install-claude.sh script instead of the removed bootstrap-install.sh and install.sh scripts. * fix(context): Add frontmatter to context files with missing metadata - Add YAML frontmatter with description to system-builder-templates - Add frontmatter to ui/web/design context files - Fixes validation warnings in validate-component.sh * fix(registry): Remove orphaned context entries for deleted files - Remove copywriting-frameworks entry (file moved to content-creation/principles/) - Remove tone-voice entry (file moved to content-creation/principles/) |
||
|---|---|---|
| .. | ||
| bridge | ||
| check-context-logs | ||
| development | ||
| docs | ||
| maintenance | ||
| prompts | ||
| registry | ||
| testing | ||
| tests | ||
| validation | ||
| versioning | ||
| auto-detect-components.sh | ||
| README.md | ||
| validate-registry.sh | ||
Scripts
This directory contains utility scripts for the OpenAgents system, organized by function.
Directory Structure
scripts/
├── registry/ # Component registry management
│ ├── auto-detect-components.sh
│ ├── register-component.sh
│ ├── validate-component.sh
│ └── validate-registry.sh
├── validation/ # Context and validation scripts
│ └── validate-context-refs.sh
├── versioning/ # Version management
│ └── bump-version.sh
├── maintenance/ # Cleanup and maintenance
│ ├── cleanup-stale-sessions.sh
│ └── uninstall.sh
├── development/ # Development utilities
│ ├── dashboard.sh
│ └── demo.sh
├── testing/ # Test runner
│ └── test.sh
├── check-context-logs/ # Context logging utilities
├── prompts/ # Prompt management
└── tests/ # Installer test scripts
Available Scripts
Testing
testing/test.sh- Main test runner with multi-agent support- Run all tests:
./scripts/testing/test.sh openagent - Run core tests:
./scripts/testing/test.sh openagent --core(7 tests, ~5-8 min) - Run with specific model:
./scripts/testing/test.sh openagent opencode/grok-code-fast - Debug mode:
./scripts/testing/test.sh openagent --core --debug
- Run all tests:
See tests/ subdirectory for installer test scripts.
Registry Management
registry/auto-detect-components.sh- Auto-detect new components in .opencode/registry/register-component.sh- Register a new component in the registryregistry/validate-component.sh- Validate component structure and metadataregistry/validate-registry.sh- Validate all registry paths
Validation
validation/validate-context-refs.sh- Validate context references in markdown files
Versioning
versioning/bump-version.sh- Bump version (alpha, beta, rc, patch, minor, major)
Maintenance
maintenance/cleanup-stale-sessions.sh- Remove stale agent sessions older than 24 hoursmaintenance/uninstall.sh- Uninstall OpenCode agents
Development
development/demo.sh- Interactive demo of repository structuredevelopment/dashboard.sh- Launch test results dashboard
Session Cleanup
Agent instances create temporary context files in .tmp/sessions/{session-id}/ for subagent delegation. These sessions are automatically cleaned up, but you can manually remove stale sessions:
# Clean up sessions older than 24 hours
./scripts/maintenance/cleanup-stale-sessions.sh
# Or manually delete all sessions
rm -rf .tmp/sessions/
Sessions are safe to delete anytime - they only contain temporary context files for agent coordination.
Usage Examples
Run Tests
# Run core test suite (fast, 7 tests, ~5-8 min)
./scripts/testing/test.sh openagent --core
# Run all tests for OpenAgent
./scripts/testing/test.sh openagent
# Run tests with specific model
./scripts/testing/test.sh openagent anthropic/claude-sonnet-4-5
# Run core tests with debug mode
./scripts/testing/test.sh openagent --core --debug
Registry Management
# Auto-detect new components
./scripts/registry/auto-detect-components.sh --dry-run
# Add new components to registry
./scripts/registry/auto-detect-components.sh --auto-add
# Validate registry
./scripts/registry/validate-registry.sh -v
# Register a specific component
./scripts/registry/register-component.sh path/to/component
# Validate a component
./scripts/registry/validate-component.sh path/to/component
Maintenance
# Clean stale sessions
./scripts/maintenance/cleanup-stale-sessions.sh
# Uninstall OpenCode agents
./scripts/maintenance/uninstall.sh
Development
# Run interactive demo
./scripts/development/demo.sh
# Launch test results dashboard
./scripts/development/dashboard.sh
Versioning
# Bump version
./scripts/versioning/bump-version.sh patch
./scripts/versioning/bump-version.sh minor
./scripts/versioning/bump-version.sh major
./scripts/versioning/bump-version.sh alpha
Core Test Suite
The core test suite is a subset of 7 carefully selected tests that provide ~85% coverage of critical OpenAgent functionality in just 5-8 minutes.
Why Use Core Tests?
- ✅ Fast feedback - 5-8 minutes vs 40-80 minutes for full suite
- ✅ Prompt iteration - Quick validation when updating agent prompts
- ✅ Development - Fast validation during development cycles
- ✅ Pre-commit - Quick checks before committing changes
What's Covered?
- Approval Gate - Critical safety rule
- Context Loading (Simple) - Most common use case
- Context Loading (Multi-Turn) - Complex scenarios
- Stop on Failure - Error handling
- Simple Task - No unnecessary delegation
- Subagent Delegation - Proper delegation when needed
- Tool Usage - Best practices
When to Use Full Suite?
Use the full test suite (71 tests) for:
- 🔬 Release validation
- 🔬 Comprehensive testing
- 🔬 Edge case coverage
- 🔬 Regression testing
See evals/agents/openagent/CORE_TESTS.md for detailed documentation.