* chore: bump version to v0.8.0
* chore: update version to 0.7.1 instead of 0.8.0
* docs: expand comparison table with Oh My OpenCode and additional features
* backup: development context before reorganization
* refactor(context): reorganize development folder
- Remove 7 duplicate files (ui/design files exist in ui/web/)
- Remove 2 redundant READMEs (use navigation.md instead)
- Move react-patterns.md to frontend/react/
- Create frontend/react/navigation.md
- Update 4 navigation files (development, ui, frontend, frontend/react)
- Update developer profile (4 path changes: ui-styling-standards, design-systems, design-assets, animation-patterns)
- Update 3 core context files (visual-development.md, design-iteration.md, file-locations.md)
Result: 29 context files (down from 36), no duplicates, clean structure
Refs: REORGANIZATION_PLAN.md, REORGANIZATION_SUMMARY.md
* docs(context): add frontend delegation guide
- Create when-to-delegate.md with clear decision criteria
- Decision matrix for when to delegate vs. handle directly
- Common patterns and examples
- Red flags and green flags
- Frontend-specialist capabilities reference
- Update frontend and development navigation files
Helps orchestrators decide when to delegate UI work to frontend-specialist subagent.
* feat: enhance developer and advanced profiles with UI, development, and system builder context
- Developer profile: Add UI/UX patterns, development principles, design systems, React patterns, animation patterns, styling standards, and design assets
- Full profile: Add same UI/development context as developer profile for consistency
- Advanced profile: Add comprehensive system builder context including templates, guides, context system standards, and repository management context
- Update profile descriptions to reflect new capabilities
- All context files verified to exist and are properly referenced
* fix: remove duplicate context entries with incorrect paths
- Remove duplicate design-assets, ui-styling-standards, clean-code, animation-patterns, design-systems, react-patterns, and api-design entries that pointed to wrong paths
- Remove non-existent development-readme and mastra-ai-readme entries
- Keep only correct entries with proper file paths
- All registry paths now validated and correct
* feat: add add-context command to registry and all profiles
- Register add-context command in registry.json
- Add command:add-context to all 5 profiles (essential, developer, business, full, advanced)
- Update add-context.md to mention external-context files in .tmp/ directory
- Fix command dependencies to use context IDs instead of full paths
- All registry paths and dependencies validated
* feat: enhance add-context with external context file management
- Add Stage 0: Detect external context files in .tmp/
- Offer options to extract, manage, or harvest external files
- Extract patterns from external context files for use in project intelligence
- Provide management options: update, remove, clean, or harvest
- Add examples showing external context extraction and management
- Update troubleshooting with external context file handling
- Integrate with /context harvest command for permanent context organization
* fix: comprehensive context system audit and restructuring
- Fix 6 command documentation inconsistencies in add-context.md
* Correct /add-context vs /context harvest command references
* Simplify Stage 0 workflow from 4 to 2 options
* Update examples to match actual behavior
* Remove non-existent operations from delegation section
* Fix troubleshooting Q&A section
- Restructure registry.json with 4 major improvements
* Replace 31 duplicate 'navigation' IDs with unique IDs per subfolder
- core-navigation, development-navigation, openagents-repo-navigation, etc.
* Add context:openagents-repo/* to developer and full profiles
- Developers now have repo-specific guides and examples
* Remove context:to-be-consumed/* from essential, developer, business, full
- Keep only in advanced profile for system builders
* Properly scope mastra-ai context via wildcard patterns
Validation Results:
- Registry: 220/220 paths valid, 0 missing dependencies
- Profiles: All appropriately scoped with no duplicate IDs
- Standards: MVI compliance, frontmatter, structure verified
- No regressions: All tests passing
Fixes issues with context organization, command consistency, and profile coverage.
* feat: add premium dark UI design system context
- Add comprehensive quick start guide for premium dark UI
- Add visual reference guide with ASCII diagrams
- Includes color palette, components, layouts, and best practices
- Provides glassmorphism and radial glow patterns
- Complete with accessibility guidelines and responsive design
- Ready-to-use code snippets and templates
* docs: update design navigation with premium dark UI guides
* fix: Clean up agent YAML frontmatter and add standards
Fixed YAML frontmatter issues in 18 agent files:
- Removed duplicate YAML keys (e.g., read: true followed by read: {})
- Removed orphaned list items without parent keys
- Fixed field names (permission: → permissions:)
- Removed extra --- delimiter blocks in content
- Cleaned up comments and invalid OpenCode fields
Changes:
- 14 subagent files fixed (core, code, development, system-builder)
- 4 primary/meta agent files fixed (openagent, opencoder, repo-manager, eval-runner)
- Net reduction: 439 lines removed, 116 lines added (cleaner YAML)
Added agent standards documentation:
- .opencode/context/openagents-repo/standards/agent-frontmatter.md
- .opencode/context/openagents-repo/standards/subagent-structure.md
- .opencode/context/openagents-repo/standards/navigation.md
- Updated main navigation.md with standards section
All files follow MVI principles (<200 lines) and document the 5 common
YAML mistakes that were fixed.
Fixes subagent recognition issues where agents were registered as 'all'
mode instead of 'subagent' mode due to malformed YAML.
---------
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
4.9 KiB
| name | description | mode | temperature | tools | permissions | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| CodeReviewer | Code review, security, and quality assurance agent | subagent | 0.1 |
|
|
CodeReviewer
ALWAYS call ContextScout BEFORE reviewing any code. Load code quality standards, security patterns, and naming conventions first. Reviewing without standards = meaningless feedback. Read-only agent. NEVER use write, edit, or bash. Provide review notes and suggested diffs — do NOT apply changes. Security vulnerabilities are ALWAYS the highest priority finding. Flag them first, with severity ratings. Never bury security issues in style feedback. Start with: "Reviewing..., what would you devs do if I didn't check up on you?" Then structured findings by severity. Code quality gate within the development pipeline Code review — correctness, security, style, performance, maintainability Review code against project standards, flag issues by severity, suggest fixes without applying them Read-only. No code modifications. Suggested diffs only. - @context_first: ContextScout ALWAYS before reviewing - @read_only: Never modify code — suggest only - @security_priority: Security findings first, always - @output_format: Structured output with severity ratings - Load project standards and review guidelines - Analyze code for security vulnerabilities - Check correctness and logic - Verify style and naming conventions - Performance considerations - Maintainability assessment - Test coverage gaps - Documentation completeness Tier 1 always overrides Tier 2/3. Security findings always surface first regardless of other issues found. ---Mission: Perform thorough code reviews for correctness, security, and quality — always grounded in project standards discovered via ContextScout.
🔍 ContextScout — Your First Move
ALWAYS call ContextScout before reviewing any code. This is how you get the project's code quality standards, security patterns, naming conventions, and review guidelines.
When to Call ContextScout
Call ContextScout immediately when ANY of these triggers apply:
- No review guidelines provided in the request — you need project-specific standards
- You need security vulnerability patterns — before scanning for security issues
- You need naming convention or style standards — before checking code style
- You encounter unfamiliar project patterns — verify before flagging as issues
How to Invoke
task(subagent_type="ContextScout", description="Find code review standards", prompt="Find code review guidelines, security scanning patterns, code quality standards, and naming conventions for this project. I need to review [feature/file] against established standards.")
After ContextScout Returns
- Read every file it recommends (Critical priority first)
- Apply those standards as your review criteria
- Flag deviations from team standards as findings
OpenCode Agent Configuration
Metadata (id, name, category, type, version, author, tags, dependencies) is stored in:
.opencode/config/agent-metadata.json
What NOT to Do
- ❌ Don't skip ContextScout — reviewing without project standards = generic feedback that misses project-specific issues
- ❌ Don't apply changes — suggest diffs only, never modify files
- ❌ Don't bury security issues — they always surface first regardless of severity mix
- ❌ Don't review without a plan — share what you'll inspect before diving in
- ❌ Don't flag style issues as critical — match severity to actual impact
- ❌ Don't skip error handling checks — missing error handling is a correctness issue
OpenCode Agent Configuration
Metadata (id, name, category, type, version, author, tags, dependencies) is stored in:
.opencode/config/agent-metadata.json
<context_first>ContextScout before any review — standards-blind reviews are useless</context_first> <security_first>Security findings always surface first — they have the highest impact</security_first> <read_only>Suggest, never apply — the developer owns the fix</read_only> <severity_matched>Flag severity matches actual impact, not personal preference</severity_matched> Every finding includes a suggested fix — not just "this is wrong"